# 增强型铁轨
## ⚡ 概述
欢迎来到 **增强型铁轨 v1.1**，这款插件将通过令人兴奋的功能，例如极速速度到智能自动化，改变你的 Minecraft 铁轨系统。 无论你是在构建复杂的交通网络还是简单的自动化物品传送系统，这款插件为矿车旅行带来了全新的功能。
增强型铁轨在特定条件下修改了供电铁轨的行为，从而显著提高玩家的矿车速度，并能够实现自动化的矿车装卸系统。
## ✨ 特性
- **超速旅行**: 将矿车速度大幅增加，为玩家提供比原版 Minecraft 快达 10 倍的速度
- **自动装卸 ✨ V1.1 新增! ✨**: 在无需复杂红石电路的情况下，创建自动化的物品运输系统！ 当矿车满载或空载时，矿车将被自动调度
- **特殊物品激活**: 配置玩家必须持有的稀有物品以激活超速，从而创建完美的任务奖励或 VIP 特权
- **基于方块的激活**: 或者，当铁轨放置在特定方块上时，启用特殊功能，提供可见的基础设施升级
- **智能减速系统**: 配置会自动降低速度以应对曲线和斜坡的特殊方块，从而防止脱轨
- **可定制设置**: 通过全面的配置系统微调所有参数，以满足你的服务器需求
这款插件非常适合创建任务奖励、增强运输网络、构建令人兴奋的铁轨系统以及自动化你的 Minecraft 世界中的物品运输。
## 📋 要求
- Minecraft 1.21.4+
- Paper 服务器（纯 Spigot 服务器上的功能不能保证，因为 Paper 最近进行了硬分叉）
- Java 17 或更高版本
> **注意：** 从版本 1.21.4 开始，Paper 进行了硬分叉，不再遵循 Spigot 作为基本 API。 本插件使用最新的 Paper API 构建，可能无法在纯 Spigot 服务器上正常工作。
## 🔧 安装
1. **下载插件**
- 从 [elfahja.com](https://elfahja.com) 获取最新版本的 EnhancedRails.jar
2. **安装到你的服务器**
- 停止你的服务器（以避免配置冲突）
- 将 EnhancedRails.jar 放入你的服务器的 `plugins/` 文件夹中
- 重新启动服务器—EnhancedRails 将在 `plugins/EnhancedRails/` 中生成默认的 `config.yml`
3. **验证安装**
- 检查服务器控制台： "EnhancedRails 已启用！ 从 [路径] 加载配置"
- 你已经准备就绪！
## ⚙️ 配置指南
`plugins/EnhancedRails/` 文件夹中的 `config.yml` 文件控制所有插件功能。 以下是默认配置及其解释：
### 超速配置
```yaml
super-speed:
enabled: true
```
### 特殊物品配置
启用时，只有当玩家在主手中持有指定的物品时，才会提供超速。
```yaml
special-item:
enabled: true
material: "TRIAL_KEY" # 推荐：使用稀有物品
custom-name: "超速钥匙" # 可选的自定义名称要求
```
### 特殊方块配置
如果你不使用特殊物品方法，你可以根据放置在供电铁轨下方的方块来启用超速。 注意：如果特殊物品已启用，则忽略此部分。
```yaml
special-block:
enabled: true
material: "SMOOTH_STONE"
```
### 速度参数
微调不同轨道条件下速度设置。 超过推荐限制需自担风险！
```yaml
super-speed-parameters:
flat-speed-multiplier: 2.0 # 推荐最大值：2.0
flat-max-speed: 4.0 # 推荐最大值：4.0
slope-speed-multiplier: 1.1 # 必须大于 1.0，推荐最大值：1.1
slope-max-speed: 1.0 # 推荐最大值：1.0
max-uphill-velocity: 2.0 # 推荐最大值：2.0
max-downhill-velocity: 2.0 # 推荐最大值：2.0
```
### 减速方块
配置会自动降低矿车速度的特殊方块。
```yaml
slow-down-parameters:
enabled: true
block1-material: "GRAVEL"
block1-max-speed: 0.4 # 0.4 是一个相对较慢的速度
block2-material: "SAND"
block2-max-speed: 0.1 # 0.1 用于极速减速
```
### 矿车装载器/卸载器配置
配置新的自动矿车装载/卸载系统 (v1.1 新增)。
```yaml
minecart-loader:
enabled: true
# 推送应有的强度 (默认 Minecraft 矿车速度约为 0.4)
push-strength: 1.0
# 启用调试日志
debug: false
# 特殊方块设置
special-block:
enabled: true
material: "SMOOTH_STONE"
```
> **注意：** 更改前始终备份你的配置，并避免超过推荐的速度值以防止意外行为。
## 🎮 游戏内命令
需要更新设置而无需重新启动吗？ 使用重新加载命令：
- **命令**: `/enhancedrails reload`
- **权限**: `enhancedrails.use` (默认：仅限操作员)
- **用法**:
1. 编辑 `plugins/EnhancedRails/` 中的 `config.yml`
2. 在游戏中或控制台中运行 `/enhancedrails reload`
3. 控制台将显示“EnhancedRails 配置已重新加载！” 确认更改
## 🔄 矿车装载器/卸载器系统
新的矿车装载器/卸载器功能 (v1.1) 简化了自动化的物品运输，无需复杂的红石电路，使其比以往任何时候都更容易构建高效的运输网络。
### 矿车装载器设置
装载器系统会自动调度全部装满的或供应容器为空但矿车包含物品的 Hopper 矿车。
**设置要求：**
1. 在任何方块（非漏斗）上放置一个供电铁轨
2. 将漏斗或箱子直接放置在 Hopper 矿车将要坐下的地方
3. 将 Hopper 矿车放在供电铁轨上
4. 如果启用了特殊方块功能，请在铁轨末端放置配置的方块
**工作原理：**
- 当 Hopper 矿车完全装满 (所有插槽都处于最大堆叠尺寸时) 时，它将沿着铁轨自动推送
- 当上面的容器为空但矿车包含一些物品时，它也将被推送
- 如果容器和矿车都为空，则矿车将保持静止，等待新的物品
### 矿车卸载器设置
卸载器系统会自动调度在转移完所有物品后变为空矿车的 Hopper 矿车。
**设置要求：**
1. 在漏斗上方放置一个供电铁轨
2. 确保在 Hopper 矿车将要坐下的地方上方没有漏斗或箱子
3. 将 Hopper 矿车放在供电铁轨上
4. 如果启用了特殊方块功能，请在铁轨末端放置配置的方块
**工作原理：**
- Hopper 矿车会将其物品内容转移到下面的漏斗中
- 完全清空后，矿车将沿着铁轨自动推送
## 🛤️ 轨道设计指南
超速旅行令人兴奋，但需要仔细规划轨道以防止脱轨。 以下是一些基本的设计技巧：
> **重要：** 以下提到的所有减速方块都必须 *直接放置在* 供电铁轨的下面。 插件检测供电铁轨下方的方块类型以确定速度行为。
### 1. 处理曲线
- **问题**: 以 4.0 米/秒的速度，90 度锐角弯道会导致矿车脱轨
- **解决方案**: 在曲线之前放置两个带有砾石方块在下方的供电铁轨，以将矿车减速至 0.4 米/秒
- **提示**: 在曲线后使用普通的供电铁轨进行加速以达到超速
### 2. 管理上坡
- **问题**: 以全速接近斜坡会导致弹回或脱轨
- **解决方案**: 在攀升之前，放置两个带有砾石方块在下方的供电铁轨以降低速度至 0.4 米/秒
- **提示**: 链式连接多个上下坡供电铁轨，实现 2.0 米/秒 的稳定攀爬速度
### 3. 控制下坡
- **问题**: 高速会导致矿车从下降的铁轨上飞出
- **解决方案**: 在下坡之前使用两个带有砾石方块在下方的供电铁轨进行制动，实现可控的 2.0 米/秒 下坡旅行
- **提示**: 避免从平地突然过渡到下坡
### 4. 设计装载/卸载站
- **车站接近**: 使用带有砂石方块（0.1 米/秒）在下方的供电铁轨进行站前刹车
- **车站布局**: 对于装载站，将漏斗/箱子放在供电铁轨上方；对于卸载站，将漏斗放在下方
- **出口铁轨**: 确保装载/卸载点之后有清晰的出口路径，带有供电铁轨
- **特殊方块**: 如果使用特殊方块进行矿车加载，请在车站的铁轨末端放置它们
> **专业提示：** 创建一个包含所有常见场景 (曲线，上坡，下坡，装载/卸载站) 的测试轨道，在你的主世界中建造之前完善你的设计。
## ❓ 故障排除
| 问题 | 解决方案 |
|---------|----------|
| 矿车脱轨 | 在曲线或斜坡之前添加更多减速方块 |
| 超速不起作用 | 检查玩家是否持有正确的特殊物品或铁轨是否放置在正确的特殊方块上 |
| 矿车装载器未激活 | 验证您的设置是否符合要求（漏斗/箱子位于上方或下方，如果启用，则有特殊方块在铁轨末端） |
| 矿车满载不推送 | 检查所有插槽是否处于最大堆叠尺寸（而不仅仅是已填充） |
| 配置未应用 | 验证您是否已正确使用重新加载命令并检查控制台是否有错误 |
| 插件无法使用 | 确认您使用的是 Minecraft 1.21.4+ 的 Paper 服务器 (而不是 Spigot) |
## 📞 支持
如需更多帮助，请提交错误报告或功能请求：
- 访问我们的网站：[elfahja.com](https://elfahja.com)
- 通过电子邮件联系我们：[support@elfahja.com](mailto:support@elfahja.com)
---
*增强型铁轨 v1.1 — 让 Minecraft 运输变得更好、更快、更令人兴奋！*
© 2025 ElFahja. 保留所有权利。