SpeedyMinecarts

A lightweight Paper plugin that lets you configure minecart speed globally, per type, or per world — no client mods or resource packs needed.

Requirements

• Paper 1.21+ (or Purpur)
• Java 21+

Installation

1. Drop SpeedyMinecarts.jar into your plugins/ folder.
2. Restart the server.
3. Edit plugins/SpeedyMinecarts/config.yml.
4. Run /smc reload to apply changes without restarting.

Configuration

# Vanilla default max speed is 0.4 blocks/tick (~8 blocks/second).
# Practical maximum is ~1.0 — above that minecarts can skip rails.

# Applied to all minecart types unless overridden below.
default-speed: 0.8

# Whether empty minecarts slow down (vanilla behaviour: true).
slow-when-empty: true

# Per-type overrides.
types:
  rideable: 0.8   # Cart players sit in
  chest:    0.6   # Chest minecart
  hopper:   0.6   # Hopper minecart
  tnt:      0.8   # TNT minecart
  furnace:  0.8   # Furnace minecart
  command:  0.8   # Command block minecart

Per-world overrides. Worlds not listed use the top-level defaults.

worlds: world_nether: default-speed: 1.0 types: rideable: 1.0

### Speed Reference

| Speed (blocks/tick) | Blocks/second | Notes |
|---|---|---|
| `0.4` | ~8 | Vanilla default |
| `0.8` | ~16 | Plugin default — noticeably faster |
| `1.0` | ~20 | Practical maximum before rail-skipping |

## Commands

| Command | Permission | Description |
|---|---|---|
| `/smc status` | `speedyminecarts.admin` | Show current speed settings |
| `/smc reload` | `speedyminecarts.admin` | Reload config and apply to all loaded minecarts |

## Permissions

| Permission | Default | Description |
|---|---|---|
| `speedyminecarts.admin` | op | Access to `/smc` commands |

## Notes

- Speed is applied when a minecart spawns and when its chunk loads. `/smc reload` applies the new speed to every minecart currently loaded across all worlds.
- Speed values are in **blocks per tick** (20 ticks/second). Multiply by 20 for blocks/second.
- Values above `1.0` are possible but minecarts may clip through rail connections at high speeds.
- Works with data packs and other plugins — no special API needed.