[![API Badge](https://img.shields.io/badge/Paper-26.2-blue?style=flat-square)](https://papermc.io/)
[![Dev State Badge](https://img.shields.io/badge/stage%20of%20development-beta-yellow?style=flat-square)]()
[![Latest Release](https://img.shields.io/github/v/release/Fridtjof-DE/MinecartTrains?style=flat-square)]()
[![Maintenance Badge](https://img.shields.io/maintenance/yes/2026?style=flat-square)]()
[![Issue Badge](https://img.shields.io/github/issues/Fridtjof-DE/MinecartTrains?style=flat-square)](https://github.com/Fridtjof-DE/MinecartTrains/issues)
[![Discord Online Badge](https://img.shields.io/discord/961799414647750717?label=Discord&style=flat-square)](https://discord.gg/fT6VJurHCT)

[![Download Badge Modrinth](https://img.shields.io/modrinth/dt/plRff0I9?color=brightgreen&label=Modrinth%20downloads&style=flat-square)](https://modrinth.com/plugin/minecart-trains/versions)

[![bStats Players](https://img.shields.io/bstats/players/18918?style=flat-square)](https://bstats.org/plugin/bukkit/Minecart%20Trains/18918)
[![bStats Server](https://img.shields.io/bstats/servers/18918?style=flat-square)](https://bstats.org/plugin/bukkit/Minecart%20Trains/18918)

# <img src="./docs/images/icon.png" data-canonical-src="./icon.png" width="32" height="32" /> Minecart Trains

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

![](./docs/images/preview-image.png)
### Features:
- linking minecarts to form a train
- 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.

**Coal Carts:**

Furnace minecarts will, if already going, refuel from a coal cart in front or behind, or otherwise nearby. Coal carts can be crafted with a minecart and a coal block. Coal carts will only interact with hoppers to refill but only coal and charcoal.

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

 - modrinth: https://modrinth.com/plugin/minecart-trains
 - bStats: https://bstats.org/plugin/bukkit/Minecart%20Trains/18918

## How to Build

You need JDK 25 and Maven. Then run:

```
mvn package
```

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

  - `MinecartTrains-1.5.0.jar`

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

## bStats
![bStats](https://bstats.org/signatures/bukkit/Minecart%20Trains.svg)
