Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Links
Creators
Details
🚂 Minecart Upgrade
Minecart Upgrade is a lightweight Fabric mod that revolutionizes minecart travel in Minecraft. Say goodbye to the vanilla speed limit and experience the thrill of high-speed rail travel with intelligent physics handling that keeps your carts safely on track!
✨ Features
🚀 Configurable Maximum Speed
- Raise the default minecart speed limit from 8 blocks/second to whatever you desire
- Default mod speed: 12 blocks/second (50% faster than vanilla!)
- Adjust speeds in real-time without restarting your game or world
🛤️ Smart Rail Handling
- Automatic Re-railing: Minecarts intelligently snap back onto rails if they start to derail at high speeds
- Direction Locking: Prevents minecarts from unexpectedly reversing direction
- Curve & Slope Protection: Automatically reduces speed on curves and slopes when traveling above 10 blocks/second to prevent derailment
🔥 Furnace Minecart Integration
- Furnace minecarts benefit from the increased speed cap too
- Push Boost System: Regular minecarts pushed by furnace minecarts receive a temporary speed boost lasting 1 second (20 ticks)
- Allows for train-like behavior with powered furnace carts pushing cargo
💧 Water Handling
- Minecarts automatically reduce to 50% speed when passing through water
- Prevents unrealistic behavior and maintains gameplay balance
🔄 Live Synchronization
- Game rule and config file are always kept in sync
- Changes apply instantly to all minecarts in loaded chunks
- No world restart required!
🎮 How It Works
Basic Usage
- Install the mod (see Installation)
- Launch your world - the mod works immediately with default settings
- Build your rail systems as normal - minecarts will now travel faster!
Adjusting Speed In-Game
Use the game rule command to change the maximum speed on the fly:
/gamerule minecartMaxSpeed <speed>
Examples:
| Command | Result |
|---|---|
/gamerule minecartMaxSpeed 8 |
Vanilla speed |
/gamerule minecartMaxSpeed 12 |
Default mod speed (50% faster) |
/gamerule minecartMaxSpeed 20 |
Rapid transit speed |
/gamerule minecartMaxSpeed 50 |
Extreme speed (for the brave!) |
💡 Tip: The speed is measured in blocks per second. Vanilla Minecraft caps minecarts at 8 blocks/second.
Building High-Speed Rail Lines
For the best experience at high speeds:
| Recommendation | Reason |
|---|---|
| ✅ Use straight rails | Maximum speed potential |
| ✅ Use powered rails frequently | Maintain momentum |
| ⚠️ Be cautious with curves | Auto-limited to 25 b/s |
| ⚠️ Be cautious with slopes | Auto-limited to 25 b/s |
| ⚠️ Be cautious with high limits | Minecart pysics glitches >~20 b/s |
| 🔥 Use furnace minecarts | Can push other carts at high speed |
⚙️ Configuration
Game Rule (Recommended)
The easiest way to configure the mod in-game:
/gamerule minecartMaxSpeed <blocksPerSecond>
- Parameter: Speed in blocks per second (decimal values supported, e.g.,
18.5) - Default:
12.0 - Minimum:
0.1 - Changes apply instantly to all loaded minecarts
Config File
Located at: config/minecartupgrade.json
{
"maxBlocksPerSecond": 12.0
}
🔧 Technical Details
Speed Limiting System
The mod implements intelligent speed limiting to prevent physics issues:
| Track Type | Speed Behavior |
|---|---|
| Straight rails | Full configured speed |
| Curved rails | Capped at 25 b/s if configured speed exceeds it |
| Ascending/Descending rails | Capped at 25 b/s if configured speed exceeds it |
| Rails in water | 50% of normal speed |
Re-railing Algorithm
When a minecart would normally derail:
- Direction Detection: The mod remembers the last valid rail direction
- Rail Search: Scans ahead (up to 48 blocks based on speed) for valid rails
- Smart Snapping: Projects the minecart onto the nearest valid rail segment
- Velocity Preservation: Maintains speed and aligns direction to the new track
Furnace Minecart Boost
When a furnace minecart collides with another minecart:
- The pushed cart receives a 20-tick boost window
- During this window, the cart can travel at the full configured speed
- Allows train-style configurations with a furnace cart pushing cargo carts
❓ FAQ
Q: Will this work on servers?
A: Yes! The mod works on both client and server. For multiplayer, only the server needs the mod installed. Clients will automatically benefit from the increased speeds.
Q: Do minecarts derail at high speeds?
A: The mod includes smart re-railing technology that keeps minecarts on track. However, at extremely high speeds (50+ b/s), complex track layouts may still cause issues. The mod automatically limits speed on curves and slopes to 25 b/s to prevent most derailments.
Q: Can I use this with other minecart mods?
A: Generally yes, but compatibility depends on the other mod. If another mod also modifies minecart physics, there may be conflicts. Test in a development world first!
Q: Why is my speed capped at 25 b/s on curves?
A: This is a safety feature! At speeds above 25 blocks/second, minecarts can behave erratically on curves and slopes. The mod automatically reduces speed in these situations to keep your cart on the rails.
Q: Can I disable the mod for specific worlds?
A: You can set the game rule to vanilla speed (/gamerule minecartMaxSpeed 8) for a vanilla-like experience while keeping the mod installed.
Q: Will this affect performance?
A: The mod is very lightweight and should have negligible impact on performance, even with many minecarts.
📝 License
This project is licensed under the MIT License
MIT License - Copyright (c) 2025 2painter
🤝 Contributing
Contributions, issues, and feature requests are welcome! Feel free to check the issues page.
💜 Support
If you enjoy this mod, consider:
- ⭐ Starring the repository
- 🐛 Reporting bugs you find
- 💡 Suggesting new features
- 📢 Sharing with friends!
🚂 Happy railroading! 🛤️



