列车附加包生成器

从 v1.0.20 起，每个列车附加包都会自带一把本包列车生成器，不必再依赖主包里的通用 yclh:i_spawn 才能开本包车系。

列车 ID 怎么定

• 填写了列车系列前缀，且不是默认 yclh7001 → 列车 ID = 该前缀，例如 yclh105 → 物品 yclh:yclh105scq。
• 未填或仍是 yclh7001 → 列车 ID = 附加包 ID，例如 yclh_yi → 物品 yclh:yclh_yiscq，避免多包抢同一个物品。

生成时上传图标

1. 在「基本信息」里填好附加包 ID、显示名称、列车系列前缀。
2. 选择 列车生成器工具图标（PNG）。建议正方形、透明底，和游戏物品图标一致。
3. 点「生成并保存」。程序把文件写到 resource_pack_*/textures/yclh_items/列车ID.png，并改好 item_texture.json。

不上传图标时，会把默认 spawn.png 复制为 列车ID.png。不会删除 spawn.png。生成清单预览里能看到物品 ID 和图标路径。

游戏内怎么用

1. 启用控制器主包 + 你的附加包（行为包、资源包都要开）。
2. 创造栏打开分类「宇创轨道交通」，拿取本包生成器。
3. 手持该物品右键：打开列车生成 UI，并锁定本包车系（跳过选模型页）。

主包自带的 yclh:i_spawn 仍然可用，会列出已注册的全部附加包。本包 scq 只负责打开「这一包」。

适用于早期用旧版生成器做出的附加包：游戏里没有本包生成器物品、缺少 yclh_spawn_* 脚本，或图标还停在共用的 spawn.png。

准备

• 把该附加包的 behavior_pack_* 和 resource_pack_* 打进同一个 ZIP。
• 准备一张 PNG 作为新的生成器工具图标。
• 在生成器顶部选好保存路径。

操作步骤

1. 打开最新版客户端（exe / apk v1.0.21），点底部「升级」。
2. 选择旧附加包 ZIP。
3. 同时选择生成器工具图标 PNG。程序按注册 JSON 识别列车 ID，把图标自动命名为 列车ID.png。
4. 点「导入并导出升级后的 ZIP」。新文件名带 _功能升级，不会覆盖原 ZIP。

会自动补上什么

升级只补齐生成器相关文件，不会重做水牌。若你后来又换过模型，请另外使用「重新扫描现有附加包水牌」。

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

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

1. 在 Blockbench 中将屏幕骨骼命名为 neiping* 或 waiping*。
2. 骨骼末尾追加准确的 __face_north/south/east/west/up/down。
3. 在生成器四节车厢卡片中分别导入最终模型 JSON。
4. 生成器先替换模型，再烘焙 ScreenFace v2，最后写入 cars[].screens 与 yreg.q。
5. 如果生成后又手工替换模型，必须使用客户端中的“重新扫描现有附加包水牌”生成新 ZIP。

不导入模型时会继续使用默认 7001 模型和默认屏幕数据；单纯替换生成后 ZIP 内的模型不会自动更新水牌。

behavior_pack_yclh_default/
├── data/yclh_addons/yclh_default.json   ★ 主包扫描注册
├── netease_items_beh/yclh7001scq.json   ★ 本包列车生成器物品
├── netease_tab/                         ★ 创造栏「宇创轨道交通」
├── yclh_spawn_yclh_default/             ★ 独立脚本，勿放到 BlockEntityScripts
├── 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
├── netease_items_res/yclh7001scq.json
└── textures/yclh_items/
    ├── spawn.png          ★ 保留
    └── yclh7001.png       ★ 本包生成器图标（列车 ID）

模板 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
• 写入本包生成器物品 yclh:<列车ID>scq、独立脚本 yclh_spawn_<addon_id>/、创造栏分类
• 生成器图标保存为 textures/yclh_items/列车ID.png（可上传；不上传则复制默认 spawn.png）

表单字段（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。列车系列前缀也建议不同；若留空，本包生成器物品会写成 yclh:<addon_id>scq，脚本目录为 yclh_spawn_<addon_id>（含 __init__.py），不会与主包 BlockEntityScripts 冲突。主包 yclh:i_spawn 仍可检索全部附加包。

旧附加包没有生成器物品？

在生成器中使用「升级旧附加包」：导入旧 ZIP，并同时上传生成器图标 PNG。程序按列车 ID 命名为 textures/yclh_items/列车ID.png，补齐 scq 物品与独立脚本，另存新 ZIP，不覆盖原文件。

• 底部四页：生成、水牌、升级、关于分成独立子页，底部栏切换
• 顶部保存路径：生成、重扫水牌、升级旧包共用同一保存位置
• 须知、备案与联系方式收进「关于」页，主界面更干净

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

• 本包列车生成器物品：每个附加包生成 yclh:<列车ID>scq，右键打开生成 UI 并锁定本包车系；多包共存不再抢同一个物品
• 自定义工具图标：生成时可上传 PNG，自动放到 textures/yclh_items/列车ID.png，保留 spawn.png
• 升级旧附加包：导入旧 ZIP 并同时上传图标，补齐 scq 物品、独立脚本 yclh_spawn_* 与创造栏分类，另存新 ZIP
• 独立脚本目录：附加包 Python 放在 yclh_spawn_<addon_id>/（含 __init__.py），禁止使用主包的 BlockEntityScripts

请下载最新 exe / apk（v1.0.21）后使用。旧版生成的附加包可用客户端「升级」页补齐。

• 启动更新检测：拉取 update.json，低于 min_supported 强制更新，低于 latest 建议更新
• 强制更新锁定：过旧版本禁用生成与水牌重扫，引导打开飞书下载页
• Windows / Android 共用策略：两端读取同一策略文件，发版只需改一处

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

• 四车型归纳识别：基于默认 7001、JNDT、Tokyu 与 Craf 的实测结果统一 ScreenFace v2 规则
• 内屏自动朝车厢：端墙与侧墙按车厢几何中心选择物理面，不再依赖头尾车型文件名翻面
• 倾斜顶屏保留指定面：显式 up/down 面优先，避免倾斜后的水平法线分量导致 JNDT 顶屏误翻
• 外屏自动朝车外：只给内侧 UV 时自动跨过方块厚度构造外露面
• 外壳遮挡自动补偿：比较同位置左右外屏外缘，自动外移内缩的一侧，避免玩家靠近时文字消失
• 车型级精细覆盖：支持仅调整特定实体的间距、居中与缩放，不影响同包其他车厢

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

• 支持生成前导入四节最终模型，并可重新扫描现有附加包水牌。
• 生成 ScreenFace v2、cars[].screens 与 yreg.q，报告每节识别结果。
• 支持旋转屏幕长边识别、外屏物理外露面与注册 Y 偏移。

• 地板 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 开源；控制器主包未开源，分发请注明需安装主包。