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: recipe配方、配方表、砧与模具配方 / Recipes, recipe maps, anvil and mold recipes配方、配方表、砧与模具配方 / Recipes, recipe maps, anvil and mold recipes
Description
本课题属总课题「资源体积治理」:#383 。全包空间账本与总路线图见该课题。
所属阶段:Phase 2(独立并行)
前置依赖:无(完全独立于贴图、模型与客户端资源包改造,可全程并行推进);下游解锁:减轻 1.21.1
generateRecipeResources构建链路负担,并与 Phase 4 共同达成源码去膨胀目标。
一、现状与定量诊断
静态配方 JSON 是仅次于贴图的第二大 JAR 占用来源,也是**“小文件条目税高于内容本身”**的最典型案例:
| 指标 | 1.20.1 Forge (data/gt6ce/recipes/) |
1.21.1 NeoForge (data/gt6ce/recipe/) |
|---|---|---|
| 条目数 | 3,151 | 3,107(转换器排除 44 个 *_efrine.json) |
| 原始大小(min / med / mean / max) | 1.27 MiB(65 / 386 / 424 / 893 B) | 1.19 MiB(61 / 367 / 401 / 853 B) |
| 压缩载荷 | 622,398 B(0.59 MiB) | 604,706 B(0.58 MiB) |
| ZIP 结构开销 | 661,102 B(0.63 MiB) | 645,884 B(0.62 MiB) |
| JAR 实际合计 | 1,283,500 B(1.22 MiB,占整包 5.37%) | 1,250,590 B(1.19 MiB,占整包 5.22%) |
深度结构特征:
- 3,107 个配方文件的 ZIP 头部开销(645,884 B)大于配方压缩载荷本身(604,706 B);
- 96.7% 为高度机械化的模板展开:3,107 个 JSON 仅对应 277 个唯一结构模板(176 个重复模板覆盖了 3,006 个文件),且内含大量仅作注释用途的
"_comment"与"_autocrafting_source"字段; - 源目录文件数分布(3,151 个):
wire_working/:1,272 个(564 KB 原始,占总数 40.4%)——按线材 × 股数 × 橡胶/绝缘规格机械展开(且FormConversionCraftingRecipeInjector.dedupGenerated()还要在运行时去重);clay_molds/:422 个(130 KB)——clay_mold + #gt6ce:molds/forms/<form>/<material>拓印;books/:290 个(139 KB,含 268 个gt6ce:book_binding)——按颜色 × 复制本数 1..8 逐一展开;smeltery_survival/:131 个(63 KB)、food/:86 个、components/:84 个、catalog_repairs/:82 个、extruder_shapes/:78 个(剪线钳循环切换模具形状的 1-to-1 配方)、decorative_panels/:75 个、bookshelves/:59 个、stone_survival/:57 个。
二、Phase 2 实施方案(保持原版配方书、EMI/JEI 与 /reload 原生兼容)
参考 GT6CE 现有的 RecipePublishing(AddPackFindersEvent(SERVER_DATA) 注入 gt6ce:generated_recipes 与 gt6ce:recipe_overrides)及 GregTech-Modern GTDynamicDataPack 实战方案:
- 第一批迁移(立减 ~2,060 文件 = 65%):
wire_working(1,272 个)→ 根据线缆材料表与绝缘/股数规则直接在 Java 规则表生成;clay_molds(422 个)→ 按注册模具形状列表批量生成;books(290 个,重点 268 个gt6ce:book_binding)→ 程序化生成或统一由RecipePublishing注入;extruder_shapes(78 个)→ 形状环列表自动生成循环配方。
- 第二批迁移(再减 ~500+ 文件):
smeltery_survival(131)、catalog_repairs(82)、decorative_panels(75)、bookshelves(59)、stone_survival(57)、components(84)、engines/scaffolds/chemical_batteries等按材料/颜色笛卡尔展开的目录。 - 生态与红线约束:
- 禁止使用
CustomRecipe替代普通材料/合成配方(CustomRecipe.isSpecial() == true会从原版配方书与 JEI/EMI 配方列表消失); - 保持
RecipePublishing的SERVER_DATA动态数据包机制,确保 EMI/JEI 展示、原版/reload、数据包覆盖(gt6ce:recipe_overrides/ 用户数据包) 以及 1.20.1 / 1.21.1 双平台差异由共享生成器统一处理; - 迁出后同步更新
tools/buildtools的static-publish-exclusions.txt与tools/recipes/audit_recipes.py检查,避免残留孤儿排除规则。
- 禁止使用
三、验收标准
-
wire_working、clay_molds、books、extruder_shapes等强规则目录迁入RecipePublishing(静态配方文件总数从 3,151 降至 ≤600,JAR 配方相关占用从 1.19 MiB 降至 ≤0.25 MiB); - 迁入前后通过自动化对比测试验证:1.20.1 与 1.21.1 加载出的
RecipeManager中每一条配方的输入、输出、数量、工具标签与gregtech_autocraftable语义 100% 等价(含原 44 个*_efrine排除逻辑不退化); - 更新
tools/recipes/audit_recipes.py及static-publish-exclusions.txt,并通过:core:test、双端编译与游戏内 EMI/JEI 配方查询验证。
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: recipe配方、配方表、砧与模具配方 / Recipes, recipe maps, anvil and mold recipes配方、配方表、砧与模具配方 / Recipes, recipe maps, anvil and mold recipes
Activity