# SpeedTracks<\/p>\n
\n
\n<\/p>\n
**A powerful and intuitive PaperMC plugin to control minecart speeds using configurable track blocks.**<\/p>\n
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.<\/p>\n
## Features<\/p>\n
– **\ud83d\ude80 Intuitive Speed Multipliers:** Configure speeds in a user-friendly way. `1.0` is normal speed, `2.0` is double speed, `0.5` is half speed.
\n– **\u2705 Simple by Design:** No complex setup. Place a block, put a rail on it, and watch your minecarts adjust their speed automatically.
\n– **\u26a1 High Performance:** Built for the Paper API to be lightweight with minimal impact on server performance.
\n– **\u2139\ufe0f Informative Commands:** Use `\/st info` to view all custom speed blocks or check the multiplier for a specific block.
\n– **\ud83d\udd04 Live Reloading:** Update your configuration on the fly with the `\/st reload` command. No server restart needed.<\/p>\n
## Installation<\/p>\n
1. Download the latest release from the Releases page.
\n2. Place the `SpeedTracks-X.X.jar` file into your **Paper 1.21+** server’s `plugins\/` directory.
\n3. Start your server. The default configuration file will be generated at `plugins\/SpeedTracks\/config.yml`.<\/p>\n
## Configuration (`config.yml`)<\/p>\n
The configuration is designed to be as simple as possible.<\/p>\n
“`yaml
\n# —————————————————————— #
\n# Configuration for SpeedTracks #
\n# —————————————————————— #<\/p>\n
# Define custom speed multipliers for minecarts based on the block
\n# directly beneath the rail.
\n#
\n# The value is a multiplier of Minecraft’s default minecart speed.
\n# 1.0 = Default speed (100%)
\n# 2.0 = Double speed (200%)
\n# 0.5 = Half speed (50%)
\n# 0.0 = Stops the minecart
\nspeed-blocks:
\n # Examples for faster travel
\n GOLD_BLOCK: 2.0
\n DIAMOND_BLOCK: 3.0
\n EMERALD_BLOCK: 4.0
\n NETHERITE_BLOCK: 6.0<\/p>\n
# Examples for slower travel
\n SOUL_SAND: 0.5
\n SLIME_BLOCK: 0.25<\/p>\n
# Example for a full stop
\n OBSIDIAN: 0.0
\n“`<\/p>\n
## Commands & Permissions<\/p>\n
The main command is `\/speedtracks`, with a convenient alias `\/st`.<\/p>\n
| Command | Description | Permission | Default | ## Building from Source<\/p>\n To build SpeedTracks yourself, you’ll need JDK 17+ and Git.<\/p>\n “`bash # Build using the Gradle wrapper The compiled plugin will be located in the `build\/libs\/` directory.<\/p>\n ## Support & Feedback<\/p>\n Encountered a bug or have a great idea for a new feature? Your feedback is highly valued!<\/p>\n – **\ud83d\udc1b Reporting Bugs:** If you find an issue, please **open a bug report** on our GitHub issue tracker. Please include your server version, plugin version, steps to reproduce, and any relevant console errors. Please use the GitHub issue tracker for all support requests rather than the review sections on plugin download sites.<\/p>\n ## License<\/p>\n This project is licensed under the **GNU General Public License v3.0**. See the [LICENSE](LICENSE) file for more details.<\/p>\n","protected":false},"excerpt":{"rendered":" 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.<\/p>\n","protected":false},"featured_media":146700,"template":"","meta":{"_minecraft_slug":"speedtracks","_minecraft_project_id":"1qFVUvGj","_minecraft_author":"BasisZock","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":142,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"speedtracks.zip","_minecraft_size_bytes":8239,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T18:44:14.996474Z","_minecraft_date_created":"2025-09-07T23:39:03.589936Z","_minecraft_date_modified":"2025-09-06T14:12:01.433129Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/speedtracks","_minecraft_icon_attachment_id":146700,"_minecraft_imported_at":"2026-06-08T19:04:39+00:00","_minecraft_import_hash":"0da7d871971147da3ae02058cdaf79e1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,129,869,92],"mod_loader":[132,134],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-146699","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-spigot","mod_category-transportation","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n| ————————— | —————————————————— | ————————— | ———- |
\n| `\/st reload` | Reloads the `config.yml` from disk. | `speedtracks.command.reload`| `op` |
\n| `\/st info` | Lists all configured blocks and their speed multipliers. | `speedtracks.command.info` | `everyone` |
\n| `\/st info
\n# Clone the repository
\ngit clone https:\/\/github.com\/basiszock\/SpeedTracks.git
\ncd SpeedTracks<\/p>\n
\n.\/gradlew build
\n“`<\/p>\n
\n– **\ud83d\udca1 Suggesting Features:** To suggest a new feature, please **create a feature request** and describe the functionality you would like to see.<\/p>\n