tool export zh

工具：导出轨道模型

入口：工具 → 导出轨道模型（Action create_track_gen.export） 源码：src/build/export.ts

功能

把当前工作区轨道大组（名 = 工作区名，由「机械动力轨道生成」创建）下的各分组，按选定的导出模式 写到用户指定文件夹，并生成配套的 blockstates 与纹理 PNG。布局为两列：左侧是导出配置， 右侧是每张纹理各自的资源路径。

左侧：导出配置

元素	用途
导出模式（下拉）	四种模式任选：1.21.11+ 新 Java（format_version，多轴旋转 {x,y,z}）/ 1.21.11- 经典 Java（无 format_version，仅单轴 {angle,axis}）/ 基岩版方块模型（每形状一个 minecraft:geometry + blocks.json）/ 全部导出为 OBJ（所有体块/网格烘焙为单一合并网格，Forge 可读）。无法导出的形状自动回退 OBJ（经典：多轴旋转 / mesh 组；基岩版：多纹理 / mesh 组）。当前工作区是自由模型时下拉被锁定为「全部导出为 OBJ」——其以原点为中心的几何无法用 Java/基岩版方块格式表达
命名空间	资源包命名空间（模型 / blockstates 路径前缀），如 kuayue、create、mymod；只允许小写字母、数字、下划线
轨道 id	模型文件夹名与 blockstates 文件名（如 standard / track / meter），默认取当前工作区名
导出根目录（文本框 + 浏览…）	资源包 assets/{命名空间} 所在目录——所有文件都写到这里，归类为 models/ textures/ blockstates/。首次访问会请求「访问文件夹」权限
模型资源路径（文本框 + 重置）	blockstates 引用模型用的资源位置（{命名空间}:path/file 的 path），默认 block/track/{轨道id}。模型写到 根目录/models/{path}/。「重置」恢复默认值

右侧：纹理资源路径

元素	用途
纹理资源路径	模型引用该纹理用的资源位置（{命名空间}:path/file 的 path），默认 block/track/{轨道id}。纹理写到 根目录/textures/{path}/。每张纹理可单独设置

要点：这里的「资源路径」是写进模型 / blockstates 文件里的路径（如 kuayue:block/track/standard/…），不是实际导出目录——写盘位置由「导出根目录」决定。资源路径只 允许小写字母、数字与 / _ . -，不能以 / 开头/结尾，不能含 ..。

底部按钮

按钮	用途
导出	校验并导出。命名空间 / 轨道 id 为空或含非法字符、资源路径为空或非法时弹错误框并保持对话框打开
取消	放弃导出

输出结构

• Java / OBJ 模式：models/{模型资源路径}/{形状}.json（或 .obj/.mtl/forge:obj 引用 JSON）+ blockstates/{轨道id}_track.json + textures/ 纹理 PNG。
• 基岩版模式：models/blocks/{轨道id}/ 下 minecraft:geometry + 根目录 blocks.json + textures/blocks/{轨道id}/；多纹理 / 含 mesh 的形状回退 OBJ。
• 导出完成后弹出加宽汇总对话框（640px）：模式、写盘文件数、资源路径、判定条件，以及每条警告/提示独立显示。

前置条件

• 当前工作区必须有轨道大组（名 = 当前工作区名）。若提示「未找到轨道大组」，请先「工具 → 机械动力轨道生成」再导出。

---

← 首页 · 英文版