# SpeedTracks
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://papermc.io/)
[](https://github.com/basiszock/SpeedTracks)
**一个用于控制矿车速度的强大且直观的 PaperMC 插件，通过可配置的轨道方块实现。**
SpeedTracks 允许您设计具有动态速度的铁路系统。只需更改轨道下方的一个方块，即可创建高速快线、风景优美的慢速线路或特殊功能轨道。 系统通过一个干净且易于使用的配置文件进行管理。
## 特性
- **🚀 直观的速度倍数：** 以用户友好的方式配置速度。 `1.0` 是正常速度，`2.0` 是双倍速度，`0.5` 是半速。
- **✅ 简单设计：** 无需复杂设置。 放置一个方块，在其上放置一条轨道，然后观看您的矿车自动调整速度。
- **⚡ 高性能：** 为 Paper API 构建，轻量级且对服务器性能的影响最小。
- **ℹ️ 详细信息命令：** 使用 `/st info` 查看所有自定义速度方块或检查特定方块的倍数。
- **🔄 实时重新加载：** 使用 `/st reload` 命令即时更新您的配置文件。 无需服务器重启。
## 安装
1. 从 [发布页面](https://modrinth.com/plugin/speedtracks/versions) 下载最新版本。
2. 将 `SpeedTracks-X.X.jar` 文件放入您的 **Paper 1.21+** 服务器的 `plugins/` 目录中。
3. 启动您的服务器。 默认配置文件将生成在 `plugins/SpeedTracks/config.yml` 中。
## 配置文件 (`config.yml`)
配置文件设计得尽可能简单。
```yaml
# ------------------------------------------------------------------ #
# 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 ` | 显示特定方块的速度倍数。 | `speedtracks.command.info` | `everyone` |
## 从源代码构建
要自己构建 SpeedTracks，您需要 JDK 17+ 和 Git.
```bash
# 克隆仓库
git clone https://github.com/basiszock/SpeedTracks.git
cd SpeedTracks
# 使用 Gradle 包装器构建
./gradlew build
```
编译后的插件位于 `build/libs/` 目录中。
## 支持 & 反馈
遇到 bug 或对新功能有好的想法吗？ 您的反馈非常有价值！
- **🐛 报告 Bug：** 如果您发现问题，请在我们的 GitHub 问题跟踪器中 [**打开一个 Bug 报告**](https://github.com/basiszock/SpeedTracks/issues)。 请包含您的服务器版本、插件版本、重现步骤以及任何相关的控制台错误。
- **💡 建议功能：** 要建议一个新功能，请 [**创建一个功能请求**](https://github.com/basiszock/SpeedTracks/issues) 并描述您想要看到的功能。
请使用 GitHub 问题跟踪器来处理所有支持请求，而不是插件下载网站的评论部分。
## 许可
此项目使用 **GNU 通用公共许可证 v3.0** 获得许可。 更多详情请参阅 [LICENSE](LICENSE) 文件。