BlueGit

timfa minecart-trains

Files

minecart-trains / README.md

README.md

README.md 3.0 KiB Download Raw

Forked from: https://github.com/Fridtjof-DE/MinecartTrains/

API Badge

Minecart Trains

Introducing Minecart Trains! Experience a whole new level of immersion as you connect minecarts together, transforming them into powerful and efficient trains.

Features:

  • linking minecarts to form a train
  • a faint coupler line between linked carts (particle packets to nearby players only)
  • freezing furnace minecarts with non-powered booster rails (to stop trains)
  • minecarts at high velocity kill mobs on the track (configurable)
  • arrows can't destroy minecarts (configurable)
  • coal carts which the furnace cart will refuel from (in front or behind)
  • furnace minecarts that can push a train in both directions
  • fuel consumption of the furnace minecart is configurable
  • highspeed tracks inspired by hsrails (only on adapted railways)

How it works:

Coupling:

The standard coupling tool is the chain. Click two minecarts one after the other to couple them. The click order does not matter: free carts, train ends, and whole trains are connected at the carts you click. Furnace minecarts become the front of a new pair when present.

Linked carts are placed on the rails at a fixed spacing behind (or ahead of) the engine. The locomotive still uses vanilla movement; the wagons are snapped to its path each tick so they cannot bounce. Corners follow the track, not a straight line.

Coal Carts:

Furnace minecarts take one coal or charcoal from a linked coal cart (or a named coal cart within 3 blocks) when they are about to run out. One piece lasts 3600 ticks (3 minutes). A normal chest minecart is ignored unless trains.fuel.refill_only_from_fuel_cart is false. Coal carts are crafted with a minecart and a coal block. Hoppers can only insert coal or charcoal into them.

Fueling a furnace minecart sets its push direction to the way you are looking, even if it already has fuel. Sneak-right-click an empty hand on a furnace minecart to reverse it. Linked carts keep following on both sides of the engine.

What is planned:

  • safe chunk unloading
  • auto. chunk loading
  • some kind of fuel gauge

What is not (yet) possible:

  • trains going around 2x2 curves

Requirements

  • Paper 26.2 (Java 25)
  • No extra plugin dependencies

Relevant Links

How to Build

You need JDK 25 and Maven. Then run:

mvn package

Results will be in the target folder. With version 1.5.5 that is:

  • MinecartTrains-1.5.5.jar

Copy this file to the plugins folder of a Paper 26.2 server.

bStats

bStats

Source
1## Forked from: [https://github.com/Fridtjof-DE/MinecartTrains/](https://github.com/Fridtjof-DE/MinecartTrains/)
2
3![API Badge](https://img.shields.io/badge/Paper-26.2-blue?style=flat-square)
4
5# ![](./docs/images/icon.png) Minecart Trains
6
7Introducing Minecart Trains! Experience a whole new level of immersion as you connect minecarts together, transforming them into powerful and efficient trains.
8
9![](./docs/images/preview-image.png)
10
11### Features:
12
13- linking minecarts to form a train
14- a faint coupler line between linked carts (particle packets to nearby players only)
15- freezing furnace minecarts with non-powered booster rails (to stop trains)
16- minecarts at high velocity kill mobs on the track (configurable)
17- arrows can't destroy minecarts (configurable)
18- coal carts which the furnace cart will refuel from (in front or behind)
19- furnace minecarts that can push a train in both directions
20- fuel consumption of the furnace minecart is configurable
21- highspeed tracks inspired by hsrails (only on adapted railways)
22
23
24
25### How it works:
26
27**Coupling:**
28
29The standard coupling tool is the chain. Click two minecarts one after the other to couple them. The click order does not matter: free carts, train ends, and whole trains are connected at the carts you click. Furnace minecarts become the front of a new pair when present.
30
31Linked carts are placed on the rails at a fixed spacing behind (or ahead of) the engine. The locomotive still uses vanilla movement; the wagons are snapped to its path each tick so they cannot bounce. Corners follow the track, not a straight line.
32
33**Coal Carts:**
34
35Furnace minecarts take one coal or charcoal from a linked coal cart (or a named coal cart within 3 blocks) when they are about to run out. One piece lasts 3600 ticks (3 minutes). A normal chest minecart is ignored unless `trains.fuel.refill_only_from_fuel_cart` is false. Coal carts are crafted with a minecart and a coal block. Hoppers can only insert coal or charcoal into them.
36
37Fueling a furnace minecart sets its push direction to the way you are looking, even if it already has fuel. Sneak-right-click an empty hand on a furnace minecart to reverse it. Linked carts keep following on both sides of the engine.
38
39### What is planned:
40
41- safe chunk unloading
42- auto. chunk loading
43- some kind of fuel gauge
44
45
46
47### What is not (yet) possible:
48
49- trains going around 2x2 curves
50
51
52
53### Requirements
54
55- Paper 26.2 (Java 25)
56- No extra plugin dependencies
57
58
59
60### Relevant Links
61
62- modrinth: [https://modrinth.com/plugin/minecart-trains](https://modrinth.com/plugin/minecart-trains)
63- bStats: [https://bstats.org/plugin/bukkit/Minecart%20Trains/18918](https://bstats.org/plugin/bukkit/Minecart%20Trains/18918)
64
65
66
67## How to Build
68
69You need JDK 25 and Maven. Then run:
70
71```
72mvn package
73```
74
75Results will be in the `target` folder. With version `1.5.5` that is:
76
77- `MinecartTrains-1.5.5.jar`
78
79Copy this file to the plugins folder of a Paper 26.2 server.
80
81## bStats
82
83![bStats](https://bstats.org/signatures/bukkit/Minecart%20Trains.svg)