SpeedTracks
一款功能强大且直观 PaperMC 插件,通过可配置的轨道方块来控制矿车速度。
SpeedTracks 允许你设计具有动态速度的铁路系统。只需简单更改轨道下方的方块,即可创建高速特快线路、慢速风景路线或特殊功能轨道。该系统通过一个简洁易用的配置文件进行管理。
特性
- ? 直观的倍率设置: 以用户友好的方式配置速度。
1.0 为正常速度,2.0 为双倍速度,0.5 为半速。
- ✅ 设计简洁: 无需复杂设置。放置一个方块,在其上铺设铁轨,矿车便会自动调整速度。
- ⚡ 高性能: 基于 Paper API 构建,轻量级,对服务器性能影响极小。
- ℹ️ 信息丰富命令: 使用
/st info 查看所有自定义速度方块,或检查特定方块的倍率。
- ? 实时重载: 使用
/st reload 命令即时更新配置。无需重启服务器。
安装
- 从 Releases 页面 下载最新版本。
- 将
SpeedTracks-X.X.jar 文件放入 Paper 1.21+ 服务器的 plugins/ 目录中。
- 启动服务器。默认配置文件将在
plugins/SpeedTracks/config.yml 生成。
配置 (config.yml)
配置设计得尽可能简单。
# ------------------------------------------------------------------ #
# Configuration for SpeedTracks #
# ------------------------------------------------------------------ #
# 根据铁轨正下方的方块定义矿车的自定义速度倍率。
#
# 该值是 Minecraft 默认矿车速度的乘数。
# 1.0 = 默认速度 (100%)
# 2.0 = 双倍速度 (200%)
# 0.5 = 半速 (50%)
# 0.0 = 使矿车停止
speed-blocks:
# 更快移动的示例
GOLD_BLOCK: 2.0
DIAMOND_BLOCK: 3.0
EMERALD_BLOCK: 4.0
NETHERITE_BLOCK: 6.0
# 更慢移动的示例
SOUL_SAND: 0.5
SLIME_BLOCK: 0.25
# 完全停止的示例
OBSIDIAN: 0.0
命令与权限
主命令为 /speedtracks,附带便捷别名 /st。
| 命令 |
描述 |
权限 |
默认值 |
/st reload |
从磁盘重新加载 config.yml。 |
speedtracks.command.reload |
op |
/st info |
列出所有已配置的方块及其速度倍率。 |
speedtracks.command.info |
everyone |
/st info <block_material> |
显示特定方块的速度倍率。 |
speedtracks.command.info |
everyone |
从源码构建
若要自行构建 SpeedTracks,你需要 JDK 17+ 和 Git。
# 克隆仓库
git clone https://github.com/basiszock/SpeedTracks.git
cd SpeedTracks
# 使用 Gradle wrapper 进行构建
./gradlew build
编译后的插件将位于 build/libs/ 目录中。
支持与反馈
遇到 Bug 或有新功能的好主意?你的反馈非常宝贵!
- ? 报告 Bug: 如果你发现问题,请在我们的 GitHub Issue 追踪器上 提交 Bug 报告。请包含你的服务器版本、插件版本、复现步骤以及任何相关的控制台错误。
- ? 建议功能: 若要建议新功能,请 创建功能请求 并描述你希望看到的功能。
请使用 GitHub Issue 追踪器处理所有支持请求,而不是在插件下载站点的评论部分。
许可证
本项目遵循 GNU General Public License v3.0 许可。有关更多详细信息,请参阅 LICENSE 文件。
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
- ? 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.
- ✅ Simple by Design: No complex setup. Place a block, put a rail on it, and watch your minecarts adjust their speed automatically.
- ⚡ High Performance: Built for the Paper API to be lightweight with minimal impact on server performance.
- ℹ️ Informative Commands: 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
- Download the latest release from the Releases page.
- Place the
SpeedTracks-X.X.jar file into your Paper 1.21+ server's plugins/ directory.
- 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.
# ------------------------------------------------------------------ #
# 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.
# 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!
- ? 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.
- ? Suggesting Features: To suggest a new feature, please create a feature request 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 LICENSE file for more details.
评论 0
登录后参与评分
还没有评论,来抢沙发吧