地铁铁路

"MetroRail."

一个为游戏设计的实用列车系统（基于连接的矿车/车厢）。
近距检测与碰撞预防。
动态配置（速度、制动距离等）。
站点停靠功能与沉浸式音效。

要使用 Metro Villa Starship 模组，你可以通过一系列命令和自定义方块，在游戏内创建、配置并管理你的地铁系统。

以下是使用该模组主要功能的指南：

1. 主要命令 (/metro)

该模组包含一个基础命令 /metro，可让你控制列车并实时修改模组设置（需要管理员权限或创造/操作员模式）：

生成列车：

/metro spawn
在你当前位置（面向你注视的方向）生成一列使用默认配置车厢数量的列车。

/metro spawn <数量>
生成一列指定车厢数量的列车（数量在 1 到 20 之间）。

列车管理：

/metro train remove
当你乘坐一节车厢时，移除整列列车。

/metro train remove all
移除世界中当前存在的该模组的所有车厢/列车。

实时配置：

/metro config <变量> <值>
允许你动态调整列车的行为方式。你可以修改的变量如下：

• speed：列车的移动速度。
• spacing：列车中每节车厢之间的距离。
• wagons：使用 spawn 命令时的默认车厢数量。
• brake_distance：当检测到前方轨道上有其他列车或障碍物时，列车开始制动的最小距离。
• chunk_load_radius：列车保持自身周围加载的区块半径，防止停运或不同步。
• station_wait_multiplier：列车在站点等待时间的倍率。

---

2. 自定义物品与方块

在创造模式物品栏的“红石”选项卡下，你可以找到模组添加的实体元素：

站点方块

站点系统的核心。当放置时（通常放在轨道下方或附近），列车会检测到它。该方块包含一个界面，允许你配置：

• 站点名称。
• 等待时间（列车在该站点停靠的时长）。
• 列车到达时应执行的动作。
• 地铁线路名称。
• 下一目的站。

地铁生成器

一个物品，可通过右键点击直接使用，无需命令即可手动生成列车。

地铁模型方块

一种装饰性/结构性透明方块，与列车或站点模型相关。

---

3. 常规功能（机制）

轨道

列车（由 MetroCartEntity 实体构成）被设定为会自动依附到游戏的铁轨上。你必须将它们放在铁轨上或非常靠近铁轨的位置，才能使其正常运行。

碰撞系统

模组的列车包含内置的近距检测系统。如果检测到同一轨道前方有另一辆列车靠得太近，它们会自动制动，防止发生事故。

站点配置

当列车经过一个“站点方块”时，它会读取其数据，逐渐减速停止，播放到达/车门音效（如果已实现），等待配置的时间，然后自动继续行驶。