API Reference zh

create_track_gen 接口文档

源码 API 参考（类型 / 常量 / 函数），按模块整理，中英两版。

---

create_track_gen 接口文档（中文版）

Blockbench 插件，根据 左轨 / 右轨 / 枕木 三个零件模型与轨距、轨道高度、整体 Y 偏移等参数， 自动生成符合机械动力（Create Mod）轨道规范的 11 种轨道形状，并支持 4 种模式导出。

本文档只覆盖 源码导出的 API（类型、常量、函数），不包含使用说明——每个 工具 菜单项的用法 见工具使用指南。

分层结构

层	目录	说明
纯逻辑层	src/logic/	零 Blockbench 依赖的纯函数与类型，可在 Node 中单测
组装层	src/build/	把逻辑层产物转成 Blockbench 真实的 Cube / Group / 文件
UI 层	src/ui/	对话框与零件导入（依赖 Blockbench 全局 API）
基础设施	src/plugin_api.ts、src/i18n.ts、src/index.ts	插件注册、国际化、入口

目录

纯逻辑层 src/logic/

• types.ts — 纯类型定义
• gauge.ts — 轨距换算
• parts.ts — 零件解析与归一化
• transform.ts — 几何变换
• generator.ts — 轨道形状组装
• export.ts — 导出约定与序列化

组装层 src/build/

• assembly.ts — CubeSpec → Cube/Group
• workspace.ts — 新建工作区与纹理导入
• export.ts — 导出轨道模型

UI 层 src/ui/

• import.ts — 零件获取（导入/提取）
• dialog.ts — 生成配置对话框
• gauge.ts — 轨距换算对话框

基础设施

• plugin_api.ts — 类型安全插件注册
• i18n.ts — 国际化

数据流概览

零件（.bbmodel / 标签页选中元素）
      │  ui/import.ts
      ▼
PartModel ──(归一化)──► src/logic/parts.ts
      │
      │  src/logic/transform.ts（平移/旋转/镜像/烘焙）
      │  src/logic/generator.ts（11 种形状组装）
      ▼
ShapeSpec[] / TrackConfig
      │  src/logic/export.ts（命名映射 + blockstates + 序列化）
      │  src/build/export.ts（写盘）
      ▼
Minecraft 模型 JSON / OBJ / 基岩版 geometry + blockstates + 纹理 PNG