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: buildGradle、CI、工具脚本、文档与仓库流程 / Gradle, CI, tool scripts, docs and repository processGradle、CI、工具脚本、文档与仓库流程 / Gradle, CI, tool scripts, docs and repository processscope: uiGUI、tooltip、Jade/EMI/JEI、模型、贴图与渲染 / GUI, tooltips, Jade/EMI/JEI, models, textures, renderingGUI、tooltip、Jade/EMI/JEI、模型、贴图与渲染 / GUI, tooltips, Jade/EMI/JEI, models, textures, rendering
Description
本课题属总课题「资源体积治理」:#383 。全包空间账本与总路线图见该课题。
所属阶段:跨越 Phase 1(Step 1:死 JSON 与空
stack_groups清理) → Phase 4(Step 2:剩余平铺模型全虚拟化与compactModelJson退场)依赖关系:
- Phase 1 · Step 1:无前置依赖(立即删除死文件与空文件,立减源码 ~2,345 文件);
- Phase 4 · Step 2:前置依赖 [resource] 材质图标与材料模型收敛:注册范围裁剪、继承回退树、去空占位与动态绘制方案 #384(材料模型)+ [resource] 机器贴图与机器模型/方块状态正交重构(壳体着色 + 差异叠加层) #396(机器模型)+ [resource] 同模板换色资产动态分层绘制与原版
unstitch图集压缩(木桶/瓶罐/流体/零散图标) #397(木桶/瓶罐模型) 各自完成专用收敛后,本步骤将剩余全部规律性平铺models与blockstates收口至SharedInventoryModelPack并淘汰源码膨胀;完成后解锁 [resource] 构建打包与 PNG 底层无损瘦身(去除空目录条目、剥离元数据、修复坏块与 CI 门禁) #401 · Step 2 最终基线锁定。
一、现状与问题定位
虽然 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 仍存在三块显著浪费:
- 已被运行时烘焙模型完全替代的“死 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。
- 平铺物品与常规方块模型/Blockstate 尚未全面迁入
SharedInventoryModelPack:- 源码中仍静态存放着
models/item/*.json(5,646 份,core4,035 +minecraft1,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-ModernGTDynamicResourcePack,全模组仅留 694 份模板 JSON),从而消除源码仓库中近 1.9 万个机器生成文件(外加运行时内存不再需要解压一份4.41 MiB的全量JsonResourceAliases字节表)。
- 源码中仍静态存放着
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等)。
- 该目录仅由可选模组 Reliable EMI(
二、分阶段实施方案
Step 1(Phase 1:死 JSON 与空 stack_groups 立即清理)
- 清理管线死文件:核实
PipeWireClientModels(双平台)与OreBakedModel对块模型/物品模型的替换范围(含破坏粒子/占位要求),移除已被完全替换的 998 blockstate + ~998 item model + 298+ block model(需要极简占位的方块改由SharedInventoryModelPack提供 1 份共享占位,如OreBlock复用minecraft:block/stone)。 - 删除无效
stack_groups:立即删除 45 个"contents": []空文件。
Step 2(Phase 4:平铺模型/Blockstate 全虚拟化收口与 compactModelJson 退场)
- 扩大
SharedInventoryModelPack覆盖范围:将全部按材质/颜色/形态规律展开的models/item/*.json、容器/石材/设备blockstates/*.json迁入SharedInventoryModelPack内存按需生成(保持Pack.Position.BOTTOM允许外部材质包覆盖)。 - 精简
stack_groups:核查 Reliable EMI 是否支持单文件内聚合分组或由ClientPackFacade虚拟注入,消除其余 419 个碎文件的 ZIP 开销。 - 淘汰/大幅收缩
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)启动零缺失模型/缺失方块状态警告。
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: buildGradle、CI、工具脚本、文档与仓库流程 / Gradle, CI, tool scripts, docs and repository processGradle、CI、工具脚本、文档与仓库流程 / Gradle, CI, tool scripts, docs and repository processscope: uiGUI、tooltip、Jade/EMI/JEI、模型、贴图与渲染 / GUI, tooltips, Jade/EMI/JEI, models, textures, renderingGUI、tooltip、Jade/EMI/JEI、模型、贴图与渲染 / GUI, tooltips, Jade/EMI/JEI, models, textures, rendering
Activity