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

HikariCraft RailTransit

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

功能特性

🚄 高速铁路系统

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

🏢 车站与站台系统

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

📍 线路管理

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

📊 显示系统

BossBar - 显示当前线路、车站、下一站信息和进度条
进度条 - 基于距离估算到下一站的进度
ActionBar - 显示速度等实时信息
经验条 - 显示到下一站的进度

📱 基岩版支持

Floodgate 集成 - 自动检测基岩版玩家
粒子优化 - 减少基岩版玩家的粒子数量
增强同步 - 更流畅的高速移动体验

命令

主命令

/rail help - 显示帮助
/rail wand - 获取选区工具
/rail debug - 调试当前位置的速度方块
/rail reload - 重新加载配置

车站命令

/rail station create <名称> [显示名称] - 创建车站
/rail station delete <名称> - 删除车站
/rail station list - 列出所有车站
/rail station info <名称> - 查看车站信息
/rail station setcompany <车站> <公司> - 设置公司

线路命令

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

站台命令

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

方向参数: up/上行 或 down/下行

站台检测模式

站台使用铁块和石英块组合来定义边界：

站台结构示意图（俯视）:

[Q][Q][Q][I]=========站台区域=========[I][Q][Q][Q]
                    铁轨

Q = 石英块 (Quartz Block)
I = 铁块 (Iron Block) - 定义站台边界
= = 站台区域（玩家等待区）

检测流程

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

示例

/rail platform detect
/rail platform confirm 东京站 1号站台 山手线 up

概念说明

车站 (Station)

代表一个物理位置（如"火车站"）
可以有多个站台
用于到站广播和显示

站台 (Platform)

属于一个车站
关联到一条线路的特定方向
有检测区域（用于判断列车是否到站）
有顺序编号（决定在线路上的位置）

线路 (Line)

有名称和颜色
包含多个站台（按上行/下行方向分组）
站台按 orderIndex 排序
可以设置每个方向的终点站（用于离站广播）

终点站 (Terminus)

每条线路的每个方向可以设置一个终点站
用于离站广播："本次列车开往（终点站）方向，下一站 XXX"
使用 /rail line setterminus <线路> <方向> <车站> 命令设置

方向 (Direction)

上行 (UP)
下行 (DOWN)

使用流程

快速开始

创建线路
```
/rail line create 1号线
```
输入 /rail wand 命令来获取选区工具
像圈地那样，把要创建的车站的区域划分完成
创建车站
```
/rail station create 火车站
```
建造站台
- 建造站台结构（铁块 + 石英块）
检测并注册站台
```
/rail platform detect
/rail platform confirm 火车站 1号站台 1号线 up
```
在这里意为：设置火车站这个车站的 1 号线的 1 号上行站台

设置终点站

# 设置上行方向的终点站
/rail line setterminus 一号线 up 终点站

# 设置下行方向的终点站
/rail line setterminus 一号线 down 终点站

测试
- 坐上矿车
- 经过站台时应该会显示 BossBar 和播放广播