Skip to content

Table 与 Localization 内容构建工具

SuperCore 把配置表和多语言制作工具放在 Unity 项目根目录的 Tools 下。两者都是独立 .NET 程序,可以在 Unity Toolbar、SuperCoreKit、BuildCfg Stage 或命令行中执行。

text
Tools/
├─ Packages/                 # 离线 NuGet 包
├─ TableBuilder/
│  ├─ TableBuilder.csproj
│  ├─ tablebuilder.conf
│  └─ build_table.bat
└─ LocalizationBuilder/
   ├─ LocalizationBuilder.csproj
   ├─ localizationbuilder.conf
   ├─ translation_prompt.txt
   └─ build_localization.bat

构建器不是运行时模块。它们生成的代码、二进制和 Manifest 才由 TableModuleLocalizationModule 加载。

子功能

执行入口

日常手动构建

  • Toolbar 的 Generate / Table
  • Toolbar 的 Generate / Localization
  • SuperCoreKit 的 Table/Localization 页面顶部 Build
  • Windows 下运行对应 .bat

Unity 入口会先确认、显示进度条,执行本地 dotnet restoredotnet run,成功后刷新 AssetDatabase。Table 生成代码可能触发脚本编译。

正式流水线

在 BuildCfg 的 Before 阶段添加:

text
Generate/Table
Generate/Localization
  • Table Stage 成功后返回 WaitForCompilation,Runner 在 Domain Reload 后继续。
  • Localization Stage 只执行离线 build 并同步刷新资源。
  • Localization Stage 不读取 API Key、不访问翻译服务,也不会自动修改模板。

配置文件格式

两个 .conf 都采用相同基本语法:

text
key:"value"
  • 每行一项,以第一个 : 分隔 Key 和 Value。
  • Value 必须由双引号包裹。
  • // 开头是注释,空行忽略。
  • 相对路径以当前 .conf 所在目录为基准。

SuperCore 使用 MIT License 开源