Skip to content

[resource] 模型/Blockstate 死文件清理、全虚拟化收口与 stack_groups 瘦身 #400

Open

Description

@Tanimodori

本课题属总课题「资源体积治理」:#383 。全包空间账本与总路线图见该课题。

所属阶段:跨越 Phase 1(Step 1:死 JSON 与空 stack_groups 清理) → Phase 4(Step 2:剩余平铺模型全虚拟化与 compactModelJson 退场)

依赖关系:


一、现状与问题定位

虽然 gradle/compact-model-json.gradle 在打发行包时已把 19,129 份静态 JSON(15,136 models + 3,993 blockstates,源码 LF 达 16.31 MiB)折叠成了 META-INF/gt6ce/model-json-aliases.json(0.21 MiB),但源码树与次要 JSON 仍存在三块显著浪费:

  1. 已被运行时烘焙模型完全替代的“死 JSON 文件”(约 2,300 个):
    • PipeWireClientModels.onModifyBakingResult()(1.20.1-forge/.../PipeWireClientModels.java 及共享逻辑)在模型烘焙完成后,会用程序化 BakedModel 全量替换所有流体管、物品管、线缆、信号线和传动轴的方块状态模型与物品模型;
    • 然而磁盘上仍静态保留着 998 个 blockstate(wire_* 467、pipe_* 217、cable_* 138、item_pipe_* 124、axle_* 52)、~998 个 item model 与 298+ 个 block model(pipe_*/wire_*/cable_*)——它们在游戏运行时根本不被渲染使用,只白白占用 Git 仓库、拖慢 processResources、并撑大 model-json-aliases.json。
  2. 平铺物品与常规方块模型/Blockstate 尚未全面迁入 SharedInventoryModelPack:
    • 源码中仍静态存放着 models/item/*.json(5,646 份,core 4,035 + minecraft 1,611)、stone_* 系列(608 blockstates / 609 item models / 913 block models)、按材质展开的容器/家具/设备方块(chest_*、drawer_*、locker_*、safe_*、crucible_*、hopper_*、bookshelf_*、scaffold_*、burning_*、battery_*、engine_* 等数千份同构 JSON);
    • 这些规则性极强的引用 JSON 完全可以由 SharedInventoryModelPack 在内存中按注册表自动生成(参考 GregTech-Modern GTDynamicResourcePack,全模组仅留 694 份模板 JSON),从而消除源码仓库中近 1.9 万个机器生成文件(外加运行时内存不再需要解压一份 4.41 MiB 的全量 JsonResourceAliases 字节表)。
  3. assets/gt6ce/stack_groups/material_forms/ 碎片膨胀与 45 个空文件(465 条 / 0.18 MiB):
    • 该目录仅由可选模组 Reliable EMI(remi:group)读取,但 465 个小文件(中位 333 B)缴纳了 106,124 B ZIP 开销(大于 85,050 B 载荷);
    • 经审计,其中竟包含 45 个 "contents": [] 的空无效文件(如 boiler_main_barometer.json、cable_01..12.json、fluid_item.json、framegt.json、gem_chipped.json 等)。

二、分阶段实施方案

Step 1(Phase 1:死 JSON 与空 stack_groups 立即清理)

  1. 清理管线死文件:核实 PipeWireClientModels(双平台)与 OreBakedModel 对块模型/物品模型的替换范围(含破坏粒子/占位要求),移除已被完全替换的 998 blockstate + ~998 item model + 298+ block model(需要极简占位的方块改由 SharedInventoryModelPack 提供 1 份共享占位,如 OreBlock 复用 minecraft:block/stone)。
  2. 删除无效 stack_groups:立即删除 45 个 "contents": [] 空文件。

Step 2(Phase 4:平铺模型/Blockstate 全虚拟化收口与 compactModelJson 退场)

  1. 扩大 SharedInventoryModelPack 覆盖范围:将全部按材质/颜色/形态规律展开的 models/item/*.json、容器/石材/设备 blockstates/*.json 迁入 SharedInventoryModelPack 内存按需生成(保持 Pack.Position.BOTTOM 允许外部材质包覆盖)。
  2. 精简 stack_groups:核查 Reliable EMI 是否支持单文件内聚合分组或由 ClientPackFacade 虚拟注入,消除其余 419 个碎文件的 ZIP 开销。
  3. 淘汰/大幅收缩 compact-model-json.gradle:待源码静态 models + blockstates 降至仅余少量手工模板(< 1,000 份)后,评估移除构建期 compactModelJson 折叠流程与运行时 JsonResourceAliases 解压逻辑。

三、验收标准

  • Phase 1:PipeWireClientModels 覆盖的约 2,300 个死 JSON 与 45 个空 stack_groups 清理完毕,双端管线世界渲染、物品栏显示与破坏粒子正常;
  • Phase 4:源码静态 models + blockstates 数量从 ~20,000 降至 ≤1,500,:core:processResources 复制文件数与构建耗时显著下降,Reliable EMI 侧边栏分组与外部材质包覆写验证正常;
  • 双端(1.20.1 / 1.21.1)启动零缺失模型/缺失方块状态警告。

Activity

  1. self-assigned this
    on Nov 14, 2026
  2. added
    enhancement建议总类 / Suggestion umbrella
    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
    scope: buildGradle、CI、工具脚本、文档与仓库流程 / Gradle, CI, tool scripts, docs and repository process
    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: buildGradle、CI、工具脚本、文档与仓库流程 / Gradle, CI, tool scripts, docs and repository processscope: uiGUI、tooltip、Jade/EMI/JEI、模型、贴图与渲染 / GUI, tooltips, Jade/EMI/JEI, models, textures, rendering

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions