列车附加包生成器

本工具基于开源模板「轨道交通列车附加包（7001 默认四节编组）」克隆生成独立的 BP + RP。控制器主包闭源，玩家必须同时安装主包与你的附加包才能运行。

默认实体：yclh:yclh7001_1（车头）～ _4（车尾）。生成器会自动改命名空间、UUID、文件名，避免多附加包冲突。

behavior_pack_yclh_default/
├── data/yclh_addons/yclh_default.json   ★ 主包扫描注册
├── entities/          yclh7001_1~4.json
├── animation_controllers/  yclh7001_1_controller.json
└── functions/
    ├── tick.json → register（每 10 tick 节流）
    ├── yclh7001/    列车运行 mcfunction ×6
    └── yclh_addons/ 注册自检 mcfunction ×4

resource_pack_yclh_default/
├── entity/ + models/entity/   各 4 个 json
├── animations/yclh7001_1.animation.json   ★ 仅车头一份
└── animation_controllers/yclh7001_1_controller.json

模板 intentionally 不含

车头 yclh7001_1

16 条动画引用、8 个 animation_controllers（含 tilt_common）：

车门动画名不可改，骨骼名可自定（见 animation.readme.txt）。

受电弓（可选，默认车头 + 第 2 节启用）

动画名不可改，骨骼可在 Blockbench 中替换（见 *.animation.readme.txt）。

地板 Y 高度 floor_y（生成器「地板高度」）

指车厢地板相对实体模型原点向上多少方块，不是世界坐标 Y。主包「列车地板」功能用此值把玩家放到正确高度。默认 1.2；7001 模板四节通常相同，填全局即可。

若某节模型 pivot 不同，可在该节单独填覆盖值。不同附加包仅当模型地板高度与 7001 不一致时才需改，否则保持 1.2。

注册 Y 偏移 headloc_y_offset（多包共存必看）

附加包注册时会在最近玩家头顶向上偏移 N 格 summon 一只 yclh:yclh_headloc 作为数据载体（never_despawn），再贴上 yreg.* 标签供主包扫描。生成器字段名 headloc_y_offset，默认模板为 36（即 execute at @p positioned ~ ~36 ~）。

每个附加包必须填不同的整数（如 30、33、36、39、42…）。与已有附加包重复会导致选择器 r=1,c=1 串台、注册冲突或车型错乱。发布前请在备案/交流群确认未被占用。

系列前缀自动命名

填写系列前缀（如 mytrain）后，四节实体短名自动变为 mytrain_1～mytrain_4，实体 JSON、模型、贴图 PNG 同步改名。

车身 / 车尾 yclh7001_2～4

基础为倾斜 4 条 + 车门 4 条；勾选受电弓后额外保留 sdgq/sdgl + controller8。

• manifest 四个 UUID 重生；BP 依赖新 RP
• 命名空间 yclh: → <addon_id>:
• 文件名同步自定义：实体、模型、贴图 PNG、车头动画/控制器
• 注册 JSON、register 广播按 display 与 visual_length 更新
• 裁剪车身/车尾 RP 未用动画；删除 legacy ani/ mcfunction

表单字段（exe / apk 相同）

输出 ZIP 解压后，分别复制 behavior_pack_* / resource_pack_* 到网易版对应目录。

tick.json → register.mcfunction（节流）
  └─ 每 10 tick → register_body
       ├─ tellraw 欢迎语
       ├─ check_main 检测主包（约 3 秒）
       └─ session 变化 → do_register（headloc + yreg 标签）

车型注册：主包扫描 behavior_packs/*/data/yclh_addons/*.json
  → 读取 addon_id / display / cars[] → 生成 UI「模型」按钮

addon_id 与文件夹名必须一致吗？

主包只认 JSON 内 addon_id 字段；生成器会三处统一，建议保持一致。

实体 yclh7001_1 必须改吗？

自用可不改；发布或多包共存须改命名空间和/或 entity_short，生成器一次性同步 entities、entity、models、注册 JSON。

多附加包共存

不同 addon_id 与 identifier；UI 显示「显示名 (1/N 点击切换)」；同一编组只能选同一附加包。

• 注册 Y 偏移 headloc_y_offset：生成器可填玩家头顶 summon 高度，自动写入 do_register.mcfunction 与注册 JSON
• 多包冲突提示：表单与手册强调每附加包偏移值不可重复
• v1.0.4：floor_y、受电弓、系列前缀同步、四张贴图

请下载最新 exe / apk（v1.0.5）后使用。

• 地板 Y 高度 floor_y：生成器表单一键设置，写入注册 JSON，无需手改
• 受电弓：按节勾选，自动保留升起/降落动画与控制器
• 系列前缀：填写后实体名、贴图、模型文件自动同步为 XXX_1～XXX_4
• 四张贴图：修复仅生成 2 张的问题，四节各有一张默认贴图

请下载最新 exe / apk（v1.0.4）后使用；旧版生成的附加包可能缺少 floor_y 或受电弓配置。

生成器中的「地板高度 floor_y」就是此前所说的 Y 坐标数值，单位是方块。

含义

从实体模型原点（pivot）沿竖直方向到车厢地板面的距离。主包开启「列车地板」后，会把玩家放到该高度，避免悬空或陷地。

要不要每个附加包不同？

• 模型基于 7001 模板、地板高度相近 → 全局填 1.2 即可，四节留空用全局。
• 自建模型、地板明显偏高/偏低 → 进游戏试「列车地板」，微调全局 floor_y（如 1.0～1.5）。
• 某一节 pivot 特殊 → 仅在该节「本节 floor_y」单独填，其余用全局。

与 visual_length 的区别

visual_length 是水平方向车长（编组间距）；floor_y 是竖直方向地板高度，两者互不影响。

模板 MIT 开源；控制器主包未开源，分发请注明需安装主包。