Repository navigation
Open
Labels
enhancement建议总类 / Suggestion umbrella建议总类 / Suggestion umbrellaperf卡顿、内存、启动或注册耗时 / Lag, memory, startup or registration cost卡顿、内存、启动或注册耗时 / Lag, memory, startup or registration costpriority: medium一般的功能性错误 / General functional error一般的功能性错误 / General functional errorrefactor重构、清理、内部实现调整,不改变对外行为 / Refactor, cleanup or internal change without external behavior change重构、清理、内部实现调整,不改变对外行为 / Refactor, cleanup or internal change without external behavior changescope: uiGUI、tooltip、Jade/EMI/JEI、模型、贴图与渲染 / GUI, tooltips, Jade/EMI/JEI, models, textures, renderingGUI、tooltip、Jade/EMI/JEI、模型、贴图与渲染 / GUI, tooltips, Jade/EMI/JEI, models, textures, renderingtranslation翻译缺失、错误或硬编码 / Missing, wrong or hardcoded translation翻译缺失、错误或硬编码 / Missing, wrong or hardcoded translation
Description
本课题属总课题「资源体积治理」:#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 先例
仓库生态内已有两套现成验证的模板化经验:
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}粉小板条箱),仅少数化学/特殊别名需要稀疏特例。
- 整个 GT6 中文翻译的
- GT6CE 现成的运行期解析器(
TagNameTranslations.java+GeneratedTagLanguageMixin.java):- GT6CE 已经通过 Mixin
ClientLanguage(getOrDefault/has)实现了tag.*键的运行期按当前激活语言动态组合——从语言包读取material.gt6ce.*词表与%s形态模板,在内存中实时拼出结果,且显式条目的优先级高于动态合成(不破坏用户资源包覆写)。
- GT6CE 已经通过 Mixin
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 原始):
- 编写可复用审计脚本扫描全仓 Java/JSON 对
gt.*、qwertech.*、bc.*、ic2.*、written.book.*等键的真实读取点(白名单保留MaterialPresentation、OriginalStorageTooltipData、GeneratorSourceTooltips、PlantPotBlock、SmelteryCompanionTooltips等仍在代码读取的键); - 剔除
zh_cn.json中确认零引用的 1.7.10/第三方附属遗留死键与已停注材料/前缀的oredict.*键(预计立删 ~2.0–3.0 万条)。
Step 2(Phase 2 - oredict.* 运行期模板化生成,消除 65,482 条静态条目):
- 建立多语言通用的
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。
- 将
- 与
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 中文显示正常。
Metadata
Metadata
Assignees
Labels
enhancement建议总类 / Suggestion umbrella建议总类 / Suggestion umbrellaperf卡顿、内存、启动或注册耗时 / Lag, memory, startup or registration cost卡顿、内存、启动或注册耗时 / Lag, memory, startup or registration costpriority: medium一般的功能性错误 / General functional error一般的功能性错误 / General functional errorrefactor重构、清理、内部实现调整,不改变对外行为 / Refactor, cleanup or internal change without external behavior change重构、清理、内部实现调整,不改变对外行为 / Refactor, cleanup or internal change without external behavior changescope: uiGUI、tooltip、Jade/EMI/JEI、模型、贴图与渲染 / GUI, tooltips, Jade/EMI/JEI, models, textures, renderingGUI、tooltip、Jade/EMI/JEI、模型、贴图与渲染 / GUI, tooltips, Jade/EMI/JEI, models, textures, renderingtranslation翻译缺失、错误或硬编码 / Missing, wrong or hardcoded translation翻译缺失、错误或硬编码 / Missing, wrong or hardcoded translation
Activity