Skip to content

[resource] 语言文件(lang)模板化动态生成与历史死键清理(覆盖 oredict.* 等机械条目) #399

Open

Description

@Tanimodori

本课题属总课题「资源体积治理」:#383 。

所属阶段:Phase 2(结构化收敛,与 #384 / 机器 / 配方并行)

前置依赖:无(需只读核对仍引用 gt.*/oredict.* 的代码调用点,不阻塞也不依赖贴图/模型改动);下游解锁:Phase 4 语言资源瘦身与多语言零膨胀扩展。


一、现状与定量诊断

对比当前 core/src/main/resources/assets/gt6ce/lang/ 下两份语言文件:

文件 键总数 原始大小 JAR 压缩大小 核心构成与问题
en_us.json 13,718 857,061 B (0.82 MiB) 128,952 B (0.12 MiB) 英文端已通过 OriginalMaterialNameRules 运行期生成 oredict.*,故文件内 oredict.* = 0;但仍含大量按材质机械拼接的 block.gt6ce.<mat>_*(4,291)与 item.gt6ce.<mat>_*(4,232)。
zh_cn.json 98,009 5,998,090 B (5.72 MiB) 829,846 B (0.79 MiB) 体积是英文的 7 倍:含 65,482 条预展开 oredict.*(~2.88 MB 原始)+ ~15,800 条非本端/1.7.10/附属死键(~1.00 MB 原始)。
合计 — 6.54 MiB 0.91 MiB zh_cn.json 占 lang 体积的 86.5%,且导致客户端切换语言/加载词典时构建近 10 万条目的哈希表。

1.1 oredict.* 机械条目的双端不对称现状

  • 英文端:原版 GT6 在 1.7.10 通过 Java 代码机械拼接材料形态英文名;GT6CE 已将其移植为 OriginalMaterialNameRules.name(...) + data/gt6ce/material_name_rules.tsv(处理特例覆写),由 MaterialPresentation.formName() 在运行期合成(仅 en_* 走该分支),无需在 en_us.json 存储 6.5 万条条目。
  • 中文端:MaterialPresentation.formName() 会先查 Language.getInstance().has("oredict." + sourceName(prefix) + materialName),因此 zh_cn.json 仍被迫静态存放了由外部工具生成的 65,482 条 oredict.*(含已停注/未注册组合)。

1.2 已有基线:GregTech6-Translation-Groupware 方案与 TagNameTranslations 先例

仓库生态内已有两套现成验证的模板化经验:

  1. GregTech6-Translation-Groupware 规则集(packages/node/project.jsonc & packages/core/docs/migration-plan.md):
    • 整个 GT6 中文翻译的 125,676 条语料中,118,457 条(94.3%) 仅由 168 个生成器(103 条 rule + 65 组 dict,基础词表仅 2,507 对) 机械组合而成(其中 73 个生成器专攻 S:oredict.*,另配 6,445 条精确 fallback 特例);
    • 即:95% 以上的 oredict.<prefix><Material> 都遵循极少量的“前缀模板 × 材料名”组合规律(如 ingot → {0}锭、plate → {0}板、dustSmall → 小堆{0}粉、crateGtDust → {0}粉小板条箱),仅少数化学/特殊别名需要稀疏特例。
  2. GT6CE 现成的运行期解析器(TagNameTranslations.java + GeneratedTagLanguageMixin.java):
    • GT6CE 已经通过 Mixin ClientLanguage(getOrDefault / has)实现了 tag.* 键的运行期按当前激活语言动态组合——从语言包读取 material.gt6ce.* 词表与 %s 形态模板,在内存中实时拼出结果,且显式条目的优先级高于动态合成(不破坏用户资源包覆写)。

1.3 zh_cn.json 内混杂的历史死键(仅中文存在、英文无对应键,共 84,291 条差异键中的非 oredict 部分)

经对比源码调用与 en_us.json:

  • gt.multitileentity.*:4,305 条(~223 KB,仅极少数在 GeneratorSourceTooltips/OriginalStorageTooltipData/PlantPotBlock 中被读,其余为 1.7.10 遗留);
  • gt.multiitem.*:3,921 条(~222 KB);
  • gt.stone.*:2,023 条(~122 KB);gt.material.*:1,879 条(~82 KB);gt.block.*:1,517 条(~77 KB);
  • qwertech.*:1,356 条(~62 KB,第三方附属 QwerTech 死键);
  • written.book.*:742 条(~170 KB);bc.*(80)、ic2.*(6)等。

二、分步骤解决方案

Step 1(Phase 2 - 死键安全清洗,立减 ~1.0 MB 原始):

  1. 编写可复用审计脚本扫描全仓 Java/JSON 对 gt.*、qwertech.*、bc.*、ic2.*、written.book.* 等键的真实读取点(白名单保留 MaterialPresentation、OriginalStorageTooltipData、GeneratorSourceTooltips、PlantPotBlock、SmelteryCompanionTooltips 等仍在代码读取的键);
  2. 剔除 zh_cn.json 中确认零引用的 1.7.10/第三方附属遗留死键与已停注材料/前缀的 oredict.* 键(预计立删 ~2.0–3.0 万条)。

Step 2(Phase 2 - oredict.* 运行期模板化生成,消除 65,482 条静态条目):

  1. 建立多语言通用的 MaterialFormNameResolver(扩展 MaterialPresentation / GeneratedTagLanguageMixin 思路):
    • 将 GregTech6-Translation-Groupware(project.jsonc)中已总结的 oredict.* 组合规则(前缀模板 + 材料上下文词缀 + 稀疏特例覆写)沉淀为结构化规则表(如轻量的语言包内模板键 gt6ce.oredict.template.<prefix>(含 %s)+ 语言包或 core 内置的 material_name_rules 特例表);
    • 保持严格优先级:资源包/语言文件显式 oredict.<prefix><Mat> 特例 > 语言特例表(如木材→木板/木棍、石头→石子、天然矿等) > 当前语言的 <prefix> 模板 + material.gt6ce.<mat> 组合 > 英文 OriginalMaterialNameRules 兜底;
    • 让 en_us 与 zh_cn(以及未来任何社区翻译语言包)走同一套模板解析体系,不再把 65,482 条机械组合全量铺入 zh_cn.json。
  2. 与 GregTech6-Translation-Groupware 闭环:提供导出/校验脚本,证明模板解析器对现存全部已注册 (Material, MaterialPrefix) 组合产出的中文译名与原 zh_cn.json 逐条一致(mismatch == 0 或仅修正已知错译)。

Step 3(Phase 4 可选延伸 - 机械生成的 block/item.gt6ce.<mat>_* 模板化):

  • 评估将 en_us.json 与 zh_cn.json 中按材质展开的 block.gt6ce.<mat>_{wall,boiler_main_barometer,dynamo_main_housing,...}、item.gt6ce.wooden_bucket_* 等数千条机械方块/物品名称改为通过方块/物品 getName() 复用 "%s 墙" / "%s Wall" 模板,进一步压缩双语体积至百 KB 级。

三、验收标准

  • Step 1 清理后,zh_cn.json 零引用死键清除完毕,白名单内全部机器/储罐/植物盆/模具提示无回退英文现象;
  • Step 2 落地后,zh_cn.json 静态 oredict.* 条目从 65,482 条压缩至稀疏特例集(< 2,000 条),zh_cn.json 原始体积从 5.72 MiB 降至 ≤ 1.2 MiB(JAR 净省 ~0.6+ MiB);
  • 全量自动化 parity 测试通过:对游戏内全部已注册 (Material, MaterialPrefix) 组合,新模板引擎在 zh_cn 与 en_us 下解析结果与基线逐条对齐;
  • 外部用户资源包覆写某个 oredict.<prefix><Mat> 依然生效,双端(1.20.1 / 1.21.1)与服务端 Jade/EMI 中文显示正常。

Activity

  1. self-assigned this
    on Nov 14, 2026
  2. added
    enhancement建议总类 / Suggestion umbrella
    translation翻译缺失、错误或硬编码 / Missing, wrong or hardcoded translation
    priority: medium一般的功能性错误 / General functional error
    perf卡顿、内存、启动或注册耗时 / Lag, memory, startup or registration cost
    refactor重构、清理、内部实现调整,不改变对外行为 / Refactor, cleanup or internal change without external behavior change
    scope: uiGUI、tooltip、Jade/EMI/JEI、模型、贴图与渲染 / GUI, tooltips, Jade/EMI/JEI, models, textures, rendering
    on Nov 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

enhancement建议总类 / Suggestion umbrellaperf卡顿、内存、启动或注册耗时 / Lag, memory, startup or registration costpriority: medium一般的功能性错误 / General functional errorrefactor重构、清理、内部实现调整,不改变对外行为 / Refactor, cleanup or internal change without external behavior changescope: uiGUI、tooltip、Jade/EMI/JEI、模型、贴图与渲染 / GUI, tooltips, Jade/EMI/JEI, models, textures, renderingtranslation翻译缺失、错误或硬编码 / Missing, wrong or hardcoded translation

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions