# 光服轨道交通插件 - 建造者使用指南

# <span class="md-plain md-expand">HikariCraft RailTransit</span>

<span class="md-plain">一个功能全面的 Minecraft Paper 高速铁路/轨道交通插件，支持车站检测、线路管理、进站广播、BossBar 显示等功能，并完全兼容基岩版玩家。</span>

## <span class="md-plain">功能特性</span>

### <span class="md-plain">🚄 高速铁路系统</span>

- <span class="md-pair-s md-expand">**<span class="md-plain">可配置的速度方块</span>**</span><span class="md-plain"> - 在铁轨下方放置不同方块实现不同速度</span>
    
    
    - <span class="md-plain">干海带块：2倍速度（通勤列车）</span>
    - <span class="md-plain">金块：3倍速度（快速列车）</span>
    - <span class="md-plain">绿宝石块：4倍速度（高速铁路）</span>
    - <span class="md-plain">紫珀块：5倍速度（超级快速）</span>
    - <span class="md-plain">红砖块：6倍速度（磁悬浮）</span>
- <span class="md-pair-s ">**<span class="md-plain">仅玩家加速</span>**</span><span class="md-plain"> - 只有玩家乘坐的矿车才会加速</span>
- <span class="md-pair-s ">**<span class="md-plain">平滑加速</span>**</span><span class="md-plain md-expand"> - 速度变化平滑过渡，体验更真实</span>

### <span class="md-plain md-expand">🏢 车站与站台系统</span>

- <span class="md-pair-s ">**<span class="md-plain">车站</span>**</span><span class="md-plain"> - 代表一个物理位置，用于广播和显示</span>
- <span class="md-pair-s ">**<span class="md-plain">站台</span>**</span><span class="md-plain"> - 属于车站，关联到线路的特定方向（上行/下行）</span>
- <span class="md-pair-s ">**<span class="md-plain">自动检测</span>**</span><span class="md-plain"> - 站在两个铁块之间即可自动检测站台范围</span>
- <span class="md-pair-s ">**<span class="md-plain">粒子可视化</span>**</span><span class="md-plain"> - 检测到的站台区域会用粒子效果标记</span>

### <span class="md-plain">📍 线路管理</span>

- <span class="md-pair-s ">**<span class="md-plain">完整的线路系统</span>**</span><span class="md-plain"> - 创建、编辑、删除线路</span>
- <span class="md-pair-s ">**<span class="md-plain">随机颜色</span>**</span><span class="md-plain"> - 线路创建时自动分配随机颜色</span>
- <span class="md-pair-s ">**<span class="md-plain">上行/下行</span>**</span><span class="md-plain"> - 每条线路有两个方向，站台按顺序排列</span>
- <span class="md-pair-s ">**<span class="md-plain">终点站设置</span>**</span><span class="md-plain"> - 手动指定每个方向的终点站</span>
- <span class="md-pair-s ">**<span class="md-plain">公司分类</span>**</span><span class="md-plain"> - 不同铁路公司使用不同音效</span>

### <span class="md-plain">📊 显示系统</span>

- <span class="md-pair-s ">**<span class="md-plain">BossBar</span>**</span><span class="md-plain"> - 显示当前线路、车站、下一站信息和进度条</span>
- <span class="md-pair-s ">**<span class="md-plain">进度条</span>**</span><span class="md-plain"> - 基于距离估算到下一站的进度</span>
- <span class="md-pair-s ">**<span class="md-plain">ActionBar</span>**</span><span class="md-plain"> - 显示速度等实时信息</span>
- <span class="md-pair-s ">**<span class="md-plain">经验条</span>**</span><span class="md-plain"> - 显示到下一站的进度</span>

### <span class="md-plain">📱 基岩版支持</span>

- <span class="md-pair-s ">**<span class="md-plain">Floodgate 集成</span>**</span><span class="md-plain"> - 自动检测基岩版玩家</span>
- <span class="md-pair-s ">**<span class="md-plain">粒子优化</span>**</span><span class="md-plain"> - 减少基岩版玩家的粒子数量</span>
- <span class="md-pair-s ">**<span class="md-plain">增强同步</span>**</span><span class="md-plain"> - 更流畅的高速移动体验</span>

## <span class="md-plain md-expand">命令</span>

### <span class="md-plain">主命令</span>

- <span class="md-pair-s" spellcheck="false">`/rail help`</span><span class="md-plain"> - 显示帮助</span>
- <span class="md-pair-s" spellcheck="false">`/rail wand`</span><span class="md-plain"> - 获取选区工具</span>
- <span class="md-pair-s" spellcheck="false">`/rail debug`</span><span class="md-plain"> - 调试当前位置的速度方块</span>
- <span class="md-pair-s" spellcheck="false">`/rail reload`</span><span class="md-plain"> - 重新加载配置</span>

### <span class="md-plain">车站命令</span>

- <span class="md-pair-s" spellcheck="false">`/rail station create <名称> [显示名称]`</span><span class="md-plain"> - 创建车站</span>
- <span class="md-pair-s" spellcheck="false">`/rail station delete <名称>`</span><span class="md-plain"> - 删除车站</span>
- <span class="md-pair-s" spellcheck="false">`/rail station list`</span><span class="md-plain"> - 列出所有车站</span>
- <span class="md-pair-s" spellcheck="false">`/rail station info <名称>`</span><span class="md-plain"> - 查看车站信息</span>
- <span class="md-pair-s" spellcheck="false">`/rail station setcompany <车站> <公司>`</span><span class="md-plain"> - 设置公司</span>

### <span class="md-plain">线路命令</span>

- <span class="md-pair-s" spellcheck="false">`/rail line create <名称> [颜色]`</span><span class="md-plain"> - 创建线路（不指定颜色则随机）</span>
- <span class="md-pair-s" spellcheck="false">`/rail line delete <名称>`</span><span class="md-plain"> - 删除线路</span>
- <span class="md-pair-s" spellcheck="false">`/rail line list`</span><span class="md-plain"> - 列出所有线路</span>
- <span class="md-pair-s" spellcheck="false">`/rail line addstation <线路> <车站> [位置]`</span><span class="md-plain"> - 添加车站到线路</span>
- <span class="md-pair-s" spellcheck="false">`/rail line removestation <线路> <车站>`</span><span class="md-plain"> - 从线路移除车站</span>
- <span class="md-pair-s" spellcheck="false">`/rail line setcolor <线路> <颜色>`</span><span class="md-plain"> - 设置线路颜色</span>
- <span class="md-pair-s" spellcheck="false">`/rail line setterminus <线路> <方向> <车站>`</span><span class="md-plain"> - 设置终点站</span>

### <span class="md-plain">站台命令</span>

- <span class="md-pair-s" spellcheck="false">`/rail platform detect`</span><span class="md-plain"> - 检测站台（站在两个铁块之间）</span>
- <span class="md-pair-s" spellcheck="false">`/rail platform confirm <车站> <名称> <线路> <方向>`</span><span class="md-plain"> - 确认创建站台</span>
- <span class="md-pair-s" spellcheck="false">`/rail platform cancel`</span><span class="md-plain"> - 取消当前检测</span>
- <span class="md-pair-s" spellcheck="false">`/rail platform delete <ID>`</span><span class="md-plain"> - 删除站台</span>
- <span class="md-pair-s" spellcheck="false">`/rail platform list [车站]`</span><span class="md-plain"> - 列出站台</span>

<span class="md-pair-s ">**<span class="md-plain">方向参数</span>**</span><span class="md-plain">: </span><span class="md-pair-s" spellcheck="false">`up`</span><span class="md-plain">/</span><span class="md-pair-s" spellcheck="false">`上行`</span><span class="md-plain"> 或 </span><span class="md-pair-s" spellcheck="false">`down`</span><span class="md-plain">/</span><span class="md-pair-s md-expand" spellcheck="false">`下行`</span>

## <span class="md-plain md-expand">站台检测模式</span>

<span class="md-plain">站台使用铁块和石英块组合来定义边界：</span>

```
站台结构示意图（俯视）:<br></br>​<br></br>[Q][Q][Q][I]=========站台区域=========[I][Q][Q][Q]<br></br>                    铁轨<br></br>​<br></br>Q = 石英块 (Quartz Block)<br></br>I = 铁块 (Iron Block) - 定义站台边界<br></br>= = 站台区域（玩家等待区）
```

### <span class="md-plain">检测流程</span>

1. <span class="md-pair-s ">**<span class="md-plain">建造站台</span>**</span>
    
    
    - <span class="md-plain">在站台两端各放置一个铁块</span>
    - <span class="md-plain">每个铁块后面放置3个石英块（用于验证）</span>
2. <span class="md-pair-s ">**<span class="md-plain">检测站台</span>**</span>
    
    
    - <span class="md-plain">站在两个铁块之间的区域</span>
    - <span class="md-plain">执行 </span><span class="md-pair-s" spellcheck="false">`/rail platform detect`</span>
    - <span class="md-plain">系统会自动找到两个铁块并计算站台范围</span>
    - <span class="md-plain">粒子效果会标记检测到的区域</span>
3. <span class="md-pair-s ">**<span class="md-plain">确认创建</span>**</span>
    
    
    - <span class="md-plain">执行 </span><span class="md-pair-s" spellcheck="false">`/rail platform confirm <车站名> <站台名> <线路名> <方向>`</span>
    - <span class="md-plain">方向: </span><span class="md-pair-s" spellcheck="false">`up`</span><span class="md-plain">(上行) 或 </span><span class="md-pair-s" spellcheck="false">`down`</span><span class="md-plain">(下行)</span>

### <span class="md-plain">示例</span>

```
/rail platform detect<br></br>/rail platform confirm 东京站 1号站台 山手线 up
```

## <span class="md-plain">概念说明</span>

### <span class="md-plain">车站 (Station)</span>

- <span class="md-plain">代表一个物理位置（如"火车站"）</span>
- <span class="md-plain">可以有多个站台</span>
- <span class="md-plain">用于到站广播和显示</span>

### <span class="md-plain">站台 (Platform)</span>

- <span class="md-plain">属于一个车站</span>
- <span class="md-plain">关联到一条线路的特定方向</span>
- <span class="md-plain">有检测区域（用于判断列车是否到站）</span>
- <span class="md-plain">有顺序编号（决定在线路上的位置）</span>

### <span class="md-plain">线路 (Line)</span>

- <span class="md-plain">有名称和颜色</span>
- <span class="md-plain">包含多个站台（按上行/下行方向分组）</span>
- <span class="md-plain">站台按 </span><span class="md-pair-s" spellcheck="false">`orderIndex`</span><span class="md-plain"> 排序</span>
- <span class="md-plain">可以设置每个方向的终点站（用于离站广播）</span>

### <span class="md-plain">终点站 (Terminus)</span>

- <span class="md-plain">每条线路的每个方向可以设置一个终点站</span>
- <span class="md-plain">用于离站广播："本次列车开往（终点站）方向，下一站 XXX"</span>
- <span class="md-plain">使用 </span><span class="md-pair-s" spellcheck="false">`/rail line setterminus <线路> <方向> <车站>`</span><span class="md-plain"> 命令设置</span>

### <span class="md-plain">方向 (Direction)</span>

- <span class="md-pair-s ">**<span class="md-plain">上行 (UP)</span>**</span>
- <span class="md-pair-s ">**<span class="md-plain">下行 (DOWN)</span>**</span>

## <span class="md-plain md-expand">使用流程</span>

### <span class="md-plain">快速开始</span>

1. <span class="md-pair-s ">**<span class="md-plain">创建线路</span>**</span>
    
    ```
    /rail line create 1号线
    ```
2. 输入 /rail wand 命令来获取选区工具
3. 像圈地那样，把要创建的车站的区域划分完成
4. <span class="md-pair-s ">**<span class="md-plain">创建车站</span>**</span>
    
    ```
    /rail station create 火车站
    ```
5. <span class="md-pair-s ">**<span class="md-plain">建造站台</span>**</span>
    
    
    - <span class="md-plain">建造站台结构（铁块 + 石英块）</span>
6. <span class="md-pair-s ">**<span class="md-plain">检测并注册站台</span>**</span>
    
    ```
    /rail platform detect
    /rail platform confirm 火车站 1号站台 1号线 up
    ```
    
    在这里意为：设置火车站这个车站的 1 号线的 1 号上行站台
7. <span class="md-pair-s ">**<span class="md-plain">设置终点站</span>**</span>
    
    ```
    # 设置上行方向的终点站
    /rail line setterminus 一号线 up 终点站
    ​
    # 设置下行方向的终点站
    /rail line setterminus 一号线 down 终点站
    ```
8. <span class="md-pair-s ">**<span class="md-plain">测试</span>**</span>
    
    
    - <span class="md-plain">坐上矿车</span>
    - <span class="md-plain md-expand">经过站台时应该会显示 BossBar 和播放广播</span>