1.0
release
SpeedTracks
SpeedTracks lets you control minecart speed by changing the block beneath the rail. Set precise speed multipliers, like 2.0 for double speed or 0.5 for half speed, for any block directly in the configuration file and is Open-source.
142
SpeedTracks
SpeedTracks
A powerful and intuitive PaperMC plugin to control minecart speeds using configurable track blocks.
SpeedTracks allows you to design railway systems with dynamic speeds. By simply changing the block under a rail, you can create high-speed express lines, slow scenic routes, or special functional tracks. The system is managed through a clean and easy-to-use configuration file.
Features
- 🔄 Live Reloading: Configure speeds in a user-friendly way. `1.0` is normal speed, `2.0` is double speed, `0.5` is half speed. - 🔄 Live Reloading: No complex setup. Place a block, put a rail on it, and watch your minecarts adjust their speed automatically. - 🔄 Live Reloading: Built for the Paper API to be lightweight with minimal impact on server performance. - 🔄 Live Reloading: Use `/st info` to view all custom speed blocks or check the multiplier for a specific block. - 🔄 Live Reloading: Update your configuration on the fly with the `/st reload` command. No server restart needed.
Installation
1. Download the latest release from the Paper 1.21+. 2. Place the `SpeedTracks-X.X.jar` file into your Paper 1.21+ server's `plugins/` directory. 3. Start your server. The default configuration file will be generated at `plugins/SpeedTracks/config.yml`.
Configuration (`config.yml`)
The configuration is designed to be as simple as possible.
```yaml
------------------------------------------------------------------ #
Configuration for SpeedTracks #
------------------------------------------------------------------ #
Define custom speed multipliers for minecarts based on the block
directly beneath the rail.
#
The value is a multiplier of Minecraft's default minecart speed.
1.0 = Default speed (100%)
2.0 = Double speed (200%)
0.5 = Half speed (50%)
0.0 = Stops the minecart
speed-blocks:
Examples for faster travel
GOLD_BLOCK: 2.0 DIAMOND_BLOCK: 3.0 EMERALD_BLOCK: 4.0 NETHERITE_BLOCK: 6.0
Examples for slower travel
SOUL_SAND: 0.5 SLIME_BLOCK: 0.25
Example for a full stop
OBSIDIAN: 0.0 ```
Commands & Permissions
The main command is `/speedtracks`, with a convenient alias `/st`.
| Command | Description | Permission | Default | | --------------------------- | ------------------------------------------------------ | --------------------------- | ---------- | | `/st reload` | Reloads the `config.yml` from disk. | `speedtracks.command.reload`| `op` | | `/st info` | Lists all configured blocks and their speed multipliers. | `speedtracks.command.info` | `everyone` | | `/st info <block_material>` | Shows the speed multiplier for a specific block. | `speedtracks.command.info` | `everyone` |
Building from Source
To build SpeedTracks yourself, you'll need JDK 17+ and Git.
```bash
Clone the repository
git clone https://github.com/basiszock/SpeedTracks.git cd SpeedTracks
Build using the Gradle wrapper
./gradlew build ```
The compiled plugin will be located in the `build/libs/` directory.
Support & Feedback
Encountered a bug or have a great idea for a new feature? Your feedback is highly valued!
- 💡 Suggesting Features: If you find an issue, please 💡 Suggesting Features: on our GitHub issue tracker. Please include your server version, plugin version, steps to reproduce, and any relevant console errors. - 💡 Suggesting Features: To suggest a new feature, please %%MD1%% and describe the functionality you would like to see.
Please use the GitHub issue tracker for all support requests rather than the review sections on plugin download sites.
License
This project is licensed under the GNU General Public License v3.0. See the GNU General Public License v3.0 file for more details.