Skip to content

[resource] 静态配方 JSON 迁入 RecipePublishing 与代码规则化 #398

Open

Description

@Tanimodori

本课题属总课题「资源体积治理」:#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 实战方案:

  1. 第一批迁移(立减 ~2,060 文件 = 65%):
    • wire_working(1,272 个)→ 根据线缆材料表与绝缘/股数规则直接在 Java 规则表生成;
    • clay_molds(422 个)→ 按注册模具形状列表批量生成;
    • books(290 个,重点 268 个 gt6ce:book_binding)→ 程序化生成或统一由 RecipePublishing 注入;
    • extruder_shapes(78 个)→ 形状环列表自动生成循环配方。
  2. 第二批迁移(再减 ~500+ 文件):smeltery_survival(131)、catalog_repairs(82)、decorative_panels(75)、bookshelves(59)、stone_survival(57)、components(84)、engines/scaffolds/chemical_batteries 等按材料/颜色笛卡尔展开的目录。
  3. 生态与红线约束:
    • 禁止使用 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 配方查询验证。

Activity

  1. added
    enhancement建议总类 / Suggestion umbrella
    priority: medium一般的功能性错误 / General functional error
    perf卡顿、内存、启动或注册耗时 / Lag, memory, startup or registration cost
    on Nov 14, 2026
  2. self-assigned this
    on Nov 14, 2026
  3. added
    refactor重构、清理、内部实现调整,不改变对外行为 / Refactor, cleanup or internal change without external behavior change
    scope: recipe配方、配方表、砧与模具配方 / Recipes, recipe maps, anvil and mold recipes
    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: recipe配方、配方表、砧与模具配方 / Recipes, recipe maps, anvil and mold recipes

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions