Windows · Desktop
列车附加包生成器
双击运行，无需 Python。填写参数 → 选择保存路径 → 一键生成 ZIP。
下载 Windows 版 (.exe)下载客户端，离线一键生成行为包与资源包。
面向创作者 · 需配合宇创领航控制器主包使用
双击运行，无需 Python。填写参数 → 选择保存路径 → 一键生成 ZIP。
下载 Windows 版 (.exe)手机端离线生成，与桌面版相同逻辑。支持导出到系统文件夹。
下载 Android 版 (.apk)Windows 或 Android，离线可用
自定义 addon_id、车厢、贴图与动画名
装入行为包 + 资源包，配合主包游玩
以下内容为附加包模板技术说明，供其他创作者查阅。点击章节展开。
本工具基于开源模板「轨道交通列车附加包（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
| 不含 | 说明 |
|---|---|
textures/entity/*.png | 生成器从主包自动复制；可自定义路径 |
functions/*/ani/ | 已废弃，灯光由主包 Python 触发 |
| 车身独立动画文件 | 中间/车尾引用车头 animation_base |
| ani3～15、mode3～33 | 已裁剪，与主包 UI 对齐 |
16 条动画引用、8 个 animation_controllers（含 tilt_common）：
车门动画名不可改，骨骼名可自定（见 animation.readme.txt）。
已裁剪为 8 动画 + 2 控制器：倾斜 4 条 + 车门 4 条，引用车头动画 ID。
yclh: → <addon_id>:ani/ mcfunction| 字段 | 说明 |
|---|---|
addon_id | 全模组唯一，小写字母开头 |
display | 生成 UI 车系名 |
entity_short | 实体短名 → 输出文件名 |
visual_length | 车长（方块），头尾 32.0、中间 28.75 |
animation_base | 仅车头填写，中间/车尾自动继承 |
输出 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「模型」按钮
主包只认 JSON 内 addon_id 字段；生成器会三处统一，建议保持一致。
自用可不改；发布或多包共存须改命名空间和/或 entity_short，生成器一次性同步 entities、entity、models、注册 JSON。
不同 addon_id 与 identifier；UI 显示「显示名 (1/N 点击切换)」；同一编组只能选同一附加包。
| 现象 | 排查 |
|---|---|
| 未检测到控制器主包 | 未安装或未启用主包 |
| 生成 UI 无车型 | BP 未启用；注册 JSON 缺失/错误 |
| 命名冲突 | addon_id 或 entity type 重复 |
| 列车不动 | cars[] 缺少 role: head |
| 编组脱钩 | visual_length 与模型实际长度不符 |
| 多余 ani/*.mcfunction | 使用最新客户端，会自动删除 |
模板 MIT 开源；控制器主包未开源，分发请注明需安装主包。