BlueGit

timfa minecart-trains

Draw client-only particle couplers between linked carts.

Co-authored-by: Cursor <cursoragent@cursor.com>

timfa Tim Falken · pushed by timfa

Authored 2026-08-22 · 2 months ago

Hash
81cf8a7748a973dab00105163e70b59c41846c6f
Parent
9c812fe8
5 files changed +127 −0
README.md +1 −0
@@ -17,6 +17,7 @@ Introducing Minecart Trains! Experience a whole new level of immersion as you co
17 17 ![](./docs/images/preview-image.png)
18 18 ### Features:
19 19 - linking minecarts to form a train
20 - a faint coupler line between linked carts (particle packets to nearby players only)
20 21 - freezing furnace minecarts with non-powered booster rails (to stop trains)
21 22 - minecarts at high velocity kill mobs on the track (configurable)
22 23 - arrows can't destroy minecarts (configurable)
@@ -17,6 +17,7 @@ Introducing Minecart Trains! Experience a whole new level of immersion as you co
17![](./docs/images/preview-image.png)
17![](./docs/images/preview-image.png)
18### Features:
18### Features:
19- linking minecarts to form a train
19- linking minecarts to form a train
20- a faint coupler line between linked carts (particle packets to nearby players only)
20- freezing furnace minecarts with non-powered booster rails (to stop trains)
21- freezing furnace minecarts with non-powered booster rails (to stop trains)
21- minecarts at high velocity kill mobs on the track (configurable)
22- minecarts at high velocity kill mobs on the track (configurable)
22- arrows can't destroy minecarts (configurable)
23- arrows can't destroy minecarts (configurable)
src/main/java/me/fridtjof/minecarttrains/MinecartTrains.java +8 −0
@@ -1,6 +1,7 @@
1 1 package me.fridtjof.minecarttrains;
2 2
3 3 import me.fridtjof.minecarttrains.managers.ConfigManager;
4 import me.fridtjof.minecarttrains.managers.CouplerVisualManager;
4 5 import me.fridtjof.minecarttrains.managers.EventManager;
5 6 import me.fridtjof.minecarttrains.managers.LinkageManager;
6 7 import me.fridtjof.minecarttrains.managers.RecipeManager;
@@ -20,6 +21,7 @@ public final class MinecartTrains extends JavaPlugin
20 21
21 22 public ConfigManager configManager;
22 23 public LinkageManager linkageManager;
24 public CouplerVisualManager couplerVisualManager;
23 25
24 26 @Override
25 27 public void onEnable()
@@ -31,6 +33,8 @@ public final class MinecartTrains extends JavaPlugin
31 33
32 34 new RecipeManager();
33 35 new EventManager(this);
36 couplerVisualManager = new CouplerVisualManager(this);
37 couplerVisualManager.start();
34 38 new ModrinthUpdateChecker(this, "plRff0I9");
35 39 new Metrics(this, 18918);
36 40 }
@@ -38,6 +42,10 @@ public final class MinecartTrains extends JavaPlugin
38 42 @Override
39 43 public void onDisable()
40 44 {
45 if (couplerVisualManager != null)
46 {
47 couplerVisualManager.stop();
48 }
41 49 instance = null;
42 50 }
43 51 }
@@ -1,6 +1,7 @@
1package me.fridtjof.minecarttrains;
1package me.fridtjof.minecarttrains;
2
2
3import me.fridtjof.minecarttrains.managers.ConfigManager;
3import me.fridtjof.minecarttrains.managers.ConfigManager;
4import me.fridtjof.minecarttrains.managers.CouplerVisualManager;
4import me.fridtjof.minecarttrains.managers.EventManager;
5import me.fridtjof.minecarttrains.managers.EventManager;
5import me.fridtjof.minecarttrains.managers.LinkageManager;
6import me.fridtjof.minecarttrains.managers.LinkageManager;
6import me.fridtjof.minecarttrains.managers.RecipeManager;
7import me.fridtjof.minecarttrains.managers.RecipeManager;
@@ -20,6 +21,7 @@ public final class MinecartTrains extends JavaPlugin
20
21
21 public ConfigManager configManager;
22 public ConfigManager configManager;
22 public LinkageManager linkageManager;
23 public LinkageManager linkageManager;
24 public CouplerVisualManager couplerVisualManager;
23
25
24 @Override
26 @Override
25 public void onEnable()
27 public void onEnable()
@@ -31,6 +33,8 @@ public final class MinecartTrains extends JavaPlugin
31
33
32 new RecipeManager();
34 new RecipeManager();
33 new EventManager(this);
35 new EventManager(this);
36 couplerVisualManager = new CouplerVisualManager(this);
37 couplerVisualManager.start();
34 new ModrinthUpdateChecker(this, "plRff0I9");
38 new ModrinthUpdateChecker(this, "plRff0I9");
35 new Metrics(this, 18918);
39 new Metrics(this, 18918);
36 }
40 }
@@ -38,6 +42,10 @@ public final class MinecartTrains extends JavaPlugin
38 @Override
42 @Override
39 public void onDisable()
43 public void onDisable()
40 {
44 {
45 if (couplerVisualManager != null)
46 {
47 couplerVisualManager.stop();
48 }
41 instance = null;
49 instance = null;
42 }
50 }
43}
51}
src/main/java/me/fridtjof/minecarttrains/managers/ConfigManager.java +5 −0
@@ -98,6 +98,11 @@ public class ConfigManager
98 98 mainConfig.getConfig().addDefault("trains.fuel.cart_name", "Coal Cart");
99 99 mainConfig.getConfig().addDefault("trains.fuel.do_hopper_logic", true);
100 100
101 mainConfig.getConfig().addDefault("trains.coupler_visual.enabled", true);
102 mainConfig.getConfig().addDefault("trains.coupler_visual.view_distance", 48);
103 mainConfig.getConfig().addDefault("trains.coupler_visual.points", 5);
104 mainConfig.getConfig().addDefault("trains.coupler_visual.interval_ticks", 4);
105
101 106 mainConfig.getConfig().addDefault("tracks.high_speed_tracks.enable", true);
102 107 mainConfig.getConfig().addDefault("tracks.high_speed_tracks.bed_block", Material.REDSTONE_BLOCK.toString());
103 108
@@ -98,6 +98,11 @@ public class ConfigManager
98 mainConfig.getConfig().addDefault("trains.fuel.cart_name", "Coal Cart");
98 mainConfig.getConfig().addDefault("trains.fuel.cart_name", "Coal Cart");
99 mainConfig.getConfig().addDefault("trains.fuel.do_hopper_logic", true);
99 mainConfig.getConfig().addDefault("trains.fuel.do_hopper_logic", true);
100
100
101 mainConfig.getConfig().addDefault("trains.coupler_visual.enabled", true);
102 mainConfig.getConfig().addDefault("trains.coupler_visual.view_distance", 48);
103 mainConfig.getConfig().addDefault("trains.coupler_visual.points", 5);
104 mainConfig.getConfig().addDefault("trains.coupler_visual.interval_ticks", 4);
105
101 mainConfig.getConfig().addDefault("tracks.high_speed_tracks.enable", true);
106 mainConfig.getConfig().addDefault("tracks.high_speed_tracks.enable", true);
102 mainConfig.getConfig().addDefault("tracks.high_speed_tracks.bed_block", Material.REDSTONE_BLOCK.toString());
107 mainConfig.getConfig().addDefault("tracks.high_speed_tracks.bed_block", Material.REDSTONE_BLOCK.toString());
103
108
src/main/java/me/fridtjof/minecarttrains/managers/CouplerVisualManager.java added +108 −0
@@ -0,0 +1,108 @@
1 package me.fridtjof.minecarttrains.managers;
2
3 import com.destroystokyo.paper.ParticleBuilder;
4 import me.fridtjof.minecarttrains.MinecartTrains;
5 import org.bukkit.Bukkit;
6 import org.bukkit.Color;
7 import org.bukkit.Particle;
8 import org.bukkit.World;
9 import org.bukkit.entity.Entity;
10 import org.bukkit.entity.Minecart;
11 import org.bukkit.scheduler.BukkitTask;
12
13 import java.util.Map;
14 import java.util.UUID;
15
16 public class CouplerVisualManager
17 {
18
19 private final MinecartTrains plugin;
20 private final LinkageManager linkageManager;
21 private final int viewDistance;
22 private final int points;
23 private final ParticleBuilder particle;
24 private BukkitTask task;
25
26 public CouplerVisualManager(MinecartTrains plugin)
27 {
28 this.plugin = plugin;
29 this.linkageManager = plugin.linkageManager;
30 this.viewDistance = plugin.configManager.mainConfig.getConfig().getInt("trains.coupler_visual.view_distance");
31 this.points = Math.max(2, plugin.configManager.mainConfig.getConfig().getInt("trains.coupler_visual.points"));
32 this.particle = Particle.DUST.builder()
33 .color(Color.fromRGB(70, 70, 70), 0.65f)
34 .count(1)
35 .offset(0, 0, 0)
36 .extra(0)
37 .force(false);
38 }
39
40 public void start()
41 {
42 if (!plugin.configManager.mainConfig.getConfig().getBoolean("trains.coupler_visual.enabled"))
43 {
44 return;
45 }
46
47 int interval = Math.max(2, plugin.configManager.mainConfig.getConfig().getInt("trains.coupler_visual.interval_ticks"));
48 task = plugin.getServer().getScheduler().runTaskTimer(plugin, this::drawLinks, interval, interval);
49 }
50
51 public void stop()
52 {
53 if (task != null)
54 {
55 task.cancel();
56 task = null;
57 }
58 }
59
60 private void drawLinks()
61 {
62 if (Bukkit.getOnlinePlayers().isEmpty())
63 {
64 return;
65 }
66
67 Map<UUID, UUID> links = linkageManager.snapshotLinks();
68 if (links.isEmpty())
69 {
70 return;
71 }
72
73 for (Map.Entry<UUID, UUID> link : links.entrySet())
74 {
75 Entity parent = Bukkit.getEntity(link.getKey());
76 Entity child = Bukkit.getEntity(link.getValue());
77 if (!(parent instanceof Minecart) || !(child instanceof Minecart))
78 {
79 continue;
80 }
81 if (parent.getWorld() != child.getWorld())
82 {
83 continue;
84 }
85
86 drawLine((Minecart) parent, (Minecart) child);
87 }
88 }
89
90 private void drawLine(Minecart from, Minecart to)
91 {
92 World world = from.getWorld();
93 double startX = from.getX();
94 double startY = from.getY() + 0.45;
95 double startZ = from.getZ();
96 double deltaX = to.getX() - startX;
97 double deltaY = (to.getY() + 0.45) - startY;
98 double deltaZ = to.getZ() - startZ;
99
100 for (int i = 1; i < points; i++)
101 {
102 double t = (double) i / points;
103 particle.location(world, startX + deltaX * t, startY + deltaY * t, startZ + deltaZ * t)
104 .receivers(viewDistance, true)
105 .spawn();
106 }
107 }
108 }
@@ -0,0 +1,108 @@
1package me.fridtjof.minecarttrains.managers;
2
3import com.destroystokyo.paper.ParticleBuilder;
4import me.fridtjof.minecarttrains.MinecartTrains;
5import org.bukkit.Bukkit;
6import org.bukkit.Color;
7import org.bukkit.Particle;
8import org.bukkit.World;
9import org.bukkit.entity.Entity;
10import org.bukkit.entity.Minecart;
11import org.bukkit.scheduler.BukkitTask;
12
13import java.util.Map;
14import java.util.UUID;
15
16public class CouplerVisualManager
17{
18
19 private final MinecartTrains plugin;
20 private final LinkageManager linkageManager;
21 private final int viewDistance;
22 private final int points;
23 private final ParticleBuilder particle;
24 private BukkitTask task;
25
26 public CouplerVisualManager(MinecartTrains plugin)
27 {
28 this.plugin = plugin;
29 this.linkageManager = plugin.linkageManager;
30 this.viewDistance = plugin.configManager.mainConfig.getConfig().getInt("trains.coupler_visual.view_distance");
31 this.points = Math.max(2, plugin.configManager.mainConfig.getConfig().getInt("trains.coupler_visual.points"));
32 this.particle = Particle.DUST.builder()
33 .color(Color.fromRGB(70, 70, 70), 0.65f)
34 .count(1)
35 .offset(0, 0, 0)
36 .extra(0)
37 .force(false);
38 }
39
40 public void start()
41 {
42 if (!plugin.configManager.mainConfig.getConfig().getBoolean("trains.coupler_visual.enabled"))
43 {
44 return;
45 }
46
47 int interval = Math.max(2, plugin.configManager.mainConfig.getConfig().getInt("trains.coupler_visual.interval_ticks"));
48 task = plugin.getServer().getScheduler().runTaskTimer(plugin, this::drawLinks, interval, interval);
49 }
50
51 public void stop()
52 {
53 if (task != null)
54 {
55 task.cancel();
56 task = null;
57 }
58 }
59
60 private void drawLinks()
61 {
62 if (Bukkit.getOnlinePlayers().isEmpty())
63 {
64 return;
65 }
66
67 Map<UUID, UUID> links = linkageManager.snapshotLinks();
68 if (links.isEmpty())
69 {
70 return;
71 }
72
73 for (Map.Entry<UUID, UUID> link : links.entrySet())
74 {
75 Entity parent = Bukkit.getEntity(link.getKey());
76 Entity child = Bukkit.getEntity(link.getValue());
77 if (!(parent instanceof Minecart) || !(child instanceof Minecart))
78 {
79 continue;
80 }
81 if (parent.getWorld() != child.getWorld())
82 {
83 continue;
84 }
85
86 drawLine((Minecart) parent, (Minecart) child);
87 }
88 }
89
90 private void drawLine(Minecart from, Minecart to)
91 {
92 World world = from.getWorld();
93 double startX = from.getX();
94 double startY = from.getY() + 0.45;
95 double startZ = from.getZ();
96 double deltaX = to.getX() - startX;
97 double deltaY = (to.getY() + 0.45) - startY;
98 double deltaZ = to.getZ() - startZ;
99
100 for (int i = 1; i < points; i++)
101 {
102 double t = (double) i / points;
103 particle.location(world, startX + deltaX * t, startY + deltaY * t, startZ + deltaZ * t)
104 .receivers(viewDistance, true)
105 .spawn();
106 }
107 }
108}
src/main/java/me/fridtjof/minecarttrains/managers/LinkageManager.java +5 −0
@@ -67,6 +67,11 @@ public class LinkageManager
67 67 return cart.getPersistentDataContainer().has(key, PersistentDataType.STRING);
68 68 }
69 69
70 public Map<UUID, UUID> snapshotLinks()
71 {
72 return Map.copyOf(childByParent);
73 }
74
70 75 public void remember(Minecart cart)
71 76 {
72 77 if (hasLink(cart))
@@ -67,6 +67,11 @@ public class LinkageManager
67 return cart.getPersistentDataContainer().has(key, PersistentDataType.STRING);
67 return cart.getPersistentDataContainer().has(key, PersistentDataType.STRING);
68 }
68 }
69
69
70 public Map<UUID, UUID> snapshotLinks()
71 {
72 return Map.copyOf(childByParent);
73 }
74
70 public void remember(Minecart cart)
75 public void remember(Minecart cart)
71 {
76 {
72 if (hasLink(cart))
77 if (hasLink(cart))