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

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) - 定义站台边界
= = 站台区域（玩家等待区）

检测流程

1. 建造站台

   • 在站台两端各放置一个铁块

   • 每个铁块后面放置3个石英块（用于验证）

2. 检测站台

   • 站在两个铁块之间的区域

   • 执行 /rail platform detect

   • 系统会自动找到两个铁块并计算站台范围

   • 粒子效果会标记检测到的区域

3. 确认创建

   • 执行 /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)

使用流程

快速开始

1. 创建线路

   /rail line create 1号线

2. 输入 /rail wand 命令来获取选区工具
3. 像圈地那样，把要创建的车站的区域划分完成

4. 创建车站

   /rail station create 火车站

5. 建造站台

   • 建造站台结构（铁块 + 石英块）

6. 检测并注册站台

   /rail platform detect
   /rail platform confirm 火车站 1号站台 1号线 up

   在这里意为：设置火车站这个车站的 1 号线的 1 号上行站台

7. 设置终点站

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

8. 测试

   • 坐上矿车

   • 经过站台时应该会显示 BossBar 和播放广播