API Reference

create_track_gen API Reference

Source API reference (types / constants / functions), organized by module, in Chinese & English.

---

create_track_gen API Reference (English)

A Blockbench plugin that generates Create Mod track model sets from three part models (left rail / right rail / tie) plus track gauge, height, and whole-model Y offset, producing the 9 track shapes and exporting them in 4 modes.

This document covers only the exported API of the source (types, constants, functions). For usage instructions (each Tools menu entry, its buttons & fields) see the Tool Guides or the GitHub repository.

Note on this English reference: entries whose behavior is fully inferable from the symbol name alone are omitted for brevity (e.g. unit-conversion helpers). The complete per-symbol reference is available in the Chinese version.

Layered structure

Layer	Directory	Purpose
Pure logic	src/logic/	Zero-Blockbench pure functions & types, Node-testable
Assembly	src/build/	Turns logic output into real Blockbench Cube / Group / files
UI	src/ui/	Dialogs and part importing (depends on Blockbench globals)
Infra	src/plugin_api.ts, src/i18n.ts, src/index.ts	Plugin registration, i18n, entry

Table of Contents

Pure logic layer src/logic/

• types.ts — Pure type definitions
• gauge.ts — Gauge conversion
• parts.ts — Part parsing & normalization
• transform.ts — Geometric transforms
• generator.ts — Track shape assembly
• export.ts — Export conventions & serialization

Assembly layer src/build/

• assembly.ts — CubeSpec → Cube/Group
• workspace.ts — Workspace creation & texture import
• export.ts — Track model export

UI layer src/ui/

• import.ts — Part acquisition
• dialog.ts — Generate configuration dialog
• gauge.ts — Gauge converter dialog

Infrastructure

• plugin_api.ts — Type-safe plugin registration
• i18n.ts — Internationalization

Data flow

Parts (.bbmodel / selected tab elements)
      │  ui/import.ts
      ▼
PartModel ──(normalized)──► src/logic/parts.ts
      │
      │  src/logic/transform.ts (translate/rotate/mirror/bake)
      │  src/logic/generator.ts (9 shape assembly)
      ▼
ShapeSpec[] / TrackConfig
      │  src/logic/export.ts (name mapping + blockstates + serialization)
      │  src/build/export.ts (write to disk)
      ▼
Minecraft model JSON / OBJ / Bedrock geometry + blockstates + texture PNGs