TC HangRail - 列车悬挂轨道插件

本插件为 TrainCarts 的扩展，允许矿车悬挂在铁栏杆等方块下方，如同在轨道上一样移动。直线、弯道和斜坡逻辑均与普通铁轨相同，让你可以创建空中游览路线，而无需在下方铺设难看的轨道。

💡前置需求与兼容性

• 必须安装 TrainCarts 插件。
• 确保 BKCommonLib 和 TrainCarts 保持最新版本，以便在较新的 Minecraft 版本上正常运行。

🎮安装方法

• 确保已安装 TrainCarts。
• 将此扩展的 .jar 文件放入服务器的 plugins 文件夹。
• 重启服务器，插件将自动注册新的轨道类型。

🔧使用方法

创建悬挂轨道

• 将铁栏杆水平放置成一条线，即可形成轨道。
• 要让矿车驶上悬挂轨道，请在轨道下方 2 格处放置一段普通铁轨与之连接。当矿车离开普通铁轨时，便会自动吸附到悬挂轨道上。

放置 TrainCarts 标志牌

• 在悬挂轨道上方放置一个方块（如石头、草方块、木头等）。
• 将标志牌附着在该方块侧面。
• 所有类型的标志牌（包括车站、刷怪器等）均可正常使用，路径查找系统也完全支持悬挂轨道。

无需额外设置

• 本插件无需任何命令或权限配置，放置好轨道即可使用。

⭐自定义悬挂显示方块

你可以更改矿车在悬挂轨道上运行时，其上方显示的视觉方块。

使用命令

/train setblock cobblewall
/train blockoffset 48

使用方块更换器标志牌

[train]
blockchanger 48
cobblewall

✨配置自定义轨道方块类型

你可以通过编辑 config.yml 文件，指定哪些方块类型可以作为悬挂轨道使用。这允许你超越铁栏杆，实现更多功能（例如让矿车悬浮在方块上方）。配置文件会在插件首次运行时自动生成。

配置说明

• 使用方块材质名进行配置。对于旧版（1.13 之前）的方块数据值，可使用冒号指定，例如 WOOL:RED。
• 使用 WOOL: 可匹配该材质的所有数据变种。
• 省略数据值则忽略方块的元数据。
• offset：矿车相对于方块的位置偏移。>0 为上方，<0 为下方。
• signOffset：标志牌相对于方块的查找高度偏移。
• signDirection：矿车为此类轨道寻找标志牌的方向。SELF（默认值）会根据矿车的偏移自动使用 UP 或 DOWN。

配置示例

以下配置使矿车悬浮在红色羊毛上方（其他颜色无效），同时保留了铁栏杆的默认设置。目前仅支持整数偏移值。

# 定义作为悬挂轨道使用的方块类型及其偏移设置
types:
  - block: IRON_FENCE
    offset: -2
    signOffset: 0
    signDirection: SELF
  - block: WOOL:RED
    offset: 1
    signOffset: 0
    signDirection: DOWN