ChooChoo Tweaks

A Minecraft Fabric mod that allows you to configure minecart speeds for different types of minecarts. Take full control of your railway systems!

✨ Features

Configurable Speeds: Set different speeds for each type of minecart
Command Support: Configure speeds via commands with /minecartspeed
Per-World Settings: Each world maintains its own speed configuration
Real-Time Updates: Changes apply immediately without restart
Operator Permissions: Only operators can modify speeds for server safety
Auto-Save: Changes are automatically saved when made by operators

🚂 Supported Minecart Types

Empty Minecart
Minecart with Player
Minecart with Entity
Chest Minecart
Furnace Minecart
Hopper Minecart
TNT Minecart
Spawner Minecart
Command Block Minecart

📥 Installation

Make sure you have Fabric Loader installed
Download Fabric API for your Minecraft version
Download the latest release from the Releases page
Place the downloaded .jar file in your .minecraft/mods folder
Launch Minecraft with the Fabric profile

🎮 Usage

Command Usage

/minecartspeed set <type> <speed>    # Set speed for a minecart type
/minecartspeed get <type>            # Get current speed for a type
/minecartspeed list                  # List all current speeds
/minecartspeed reset                 # Reset all speeds to defaults

Examples:

/minecartspeed set empty_minecart 1.0
/minecartspeed get chest_minecart
/minecartspeed list

⚙️ Requirements

Minecraft: 1.21.7
Fabric Loader: 0.17.2 or higher
Fabric API: 0.129.0+1.21.7 or higher
Java: 21 or higher

🛠️ For Developers

Building from Source

git clone https://github.com/SSnowly/choochootweaks.git
cd choochootweaks
./gradlew build

Built files will be in build/libs/:

choochoo-tweaks-<version>.jar - Main mod file
choochoo-tweaks-<version>-sources.jar - Source code

Contributing

Fork the repository
Create a feature branch
Make your changes
Test thoroughly
Submit a pull request

📝 Configuration

Configuration files are stored per-world in saves/<world>/choochoo_tweaks_speeds.json. The file is automatically created and managed by the mod.

Example configuration:

{
  "empty_minecart": 0.4,
  "minecart_with_player": 0.4,
  "chest_minecart": 0.4,
  "furnace_minecart": 0.4,
  "hopper_minecart": 0.4,
  "tnt_minecart": 0.4,
  "spawner_minecart": 0.4,
  "command_block_minecart": 0.4,
  "minecart_with_entity": 0.4
}

🐛 Issues & Support

Found a bug or have a feature request? Please open an issue on the GitHub Issues page.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👤 Author

SSnowly

GitHub: @SSnowly

🙏 Acknowledgments

Thanks to the Fabric team for the excellent modding framework
Thanks to the Minecraft modding community for inspiration and support

Choo Choo Tweaks