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 errorscope: 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:最先落地的无损瘦身与基础门禁) → Phase 4(Step 2:全线收口后最终基线锁定)
依赖关系:
- Phase 1 · Step 1:无前置依赖(建议最先启动),为后续 [resource] 材质图标与材料模型收敛:注册范围裁剪、继承回退树、去空占位与动态绘制方案 #384、[resource] 机器贴图与机器模型/方块状态正交重构(壳体着色 + 差异叠加层) #396/[resource] 同模板换色资产动态分层绘制与原版
unstitch图集压缩(木桶/瓶罐/流体/零散图标) #397/[resource] 模型/Blockstate 死文件清理、全虚拟化收口与stack_groups瘦身 #400 提供干净无坏块的 PNG 与准确 JAR 度量基线;- Phase 4 · Step 2:依赖 Phase 1–4 其余治理子课题合入,刷新并锁定最终 JAR 体积与条目数门禁阈值。
一、现状与定量证据
在不动任何游戏玩法、模型结构与贴图内容的前提下,仅构建打包层与 PNG 元数据剥离两项“纯工程红利”,在 1.0.7 JAR 中就隐藏着 ~1.77 MiB 的确定性浪费:
- JAR 内含
1,702个空目录条目(dir_entries):浪费368,752 B(0.35 MiB)- Gradle
Jar任务默认includeEmptyDirs = true,在包内生成了 1,702 个 0 字节目录条目(1.20.1 为 1,695 条 / 367,800 B),白白缴纳 LFH+CD 结构税; - 核对
_reference/Minecraft-1.21.1-NeoForgeFilePackResources.java:原版getResource按完整路径查找,listResources显式跳过!zipentry.isDirectory()。
- Gradle
- PNG 夹带
1.84 MiB非必要元数据 chunk 与 10 处 CRC 损坏:- 扫描全部 17,611 张 PNG 发现海量导出工具遗留 chunk:
pHYs(17,309 次 / 156 KB)、tIME(17,140 次 / 120 KB)、bKGD(17,142 次 / 103 KB)、iCCP(228 次 / 349 KB)、iTXt(193 次 / 387 KB)、zTXt(120 次 / 188 KB),含 12 B chunk 帧头总计 1,929,109 B(1.84 MiB 原始)。极端案例:block/overlays/characters/neutron.png(64×64)单张藏有 7,153 BzTXt块;gui/machines88 张图含 234,608 B 非必要块; - 发现 10 张 PNG 的
iCCPchunk CRC 校验损坏(9 张block/fluids/*+neutron.png),导致严格 PNG 解析器直接抛错; - 关键实测对比:
- 若对源码做离线 Pillow
optimize=True重编:既会在 Phase 1 把 ~1.7 万个即将于 [resource] 材质图标与材料模型收敛:注册范围裁剪、继承回退树、去空占位与动态绘制方案 #384/[resource] 机器贴图与机器模型/方块状态正交重构(壳体着色 + 差异叠加层) #396/[resource] 同模板换色资产动态分层绘制与原版unstitch图集压缩(木桶/瓶罐/流体/零散图标) #397 被删除的二进制 PNG blob 永久写入 Git 历史(造成严重 Git 膨胀),又因部分小图IDAT重压膨胀与坏块跳过,JAR 仅省761,549 B(0.73 MiB); - 若采用构建期纯 Chunk 过滤(不解码像素、
IDAT字节原样透传,仅保留IHDR/PLTE/tRNS/IDAT/IEND):不仅零 Git 历史膨胀、纯 Java 即可跑完且自动剔除 10 处损坏iCCP,1.0.7JAR 实测净省高达1,492,697 B(1.42 MiB)(压缩载荷7,323,584 B → 5,830,887 B)!
- 若对源码做离线 Pillow
- 扫描全部 17,611 张 PNG 发现海量导出工具遗留 chunk:
- 增量构建缓存幽灵残留与 1.20.1 源码残留:
minecraft/versions/1.20.1-forge/src/main/resources/assets/gt6ce/textures/block/overlays/characters/GIMP.txt(113 B)为无效开发残留;1.0.7JAR 因core/build/resources/main增量残留而夹带已从源码删除的coin资源(187 条 / 0.12 MiB),需检查gradle/incremental-resources.gradle对删除源文件的清理同步。
二、分阶段实施方案
Step 1(Phase 1:零 Git 膨胀构建期瘦身 + 基础门禁,立省 ~1.77 MiB)
- 验证并开启
includeEmptyDirs = false:在core/build.gradle、gradle/platform-forge.gradle、gradle/platform-neoforge.gradle的jar/distributionJar任务上配置includeEmptyDirs = false,实测验证双端ModFile/SecureJar、Mixin 扫描、ServiceLoader 与FilePackResources正常加载。 - Gradle 增量缓存式 PNG 纯 Chunk 过滤(不改源码、不写 Git):
- 新增纯 Java 增量/可缓存 Gradle 任务(输出缓存至
build/清洗目录,按文件变更增量同步,本地构建基本只需首次跑一次,后续只处理变动 PNG,且完全不污染 Git 仓库):仅读取 12 B chunk 头,原样透传IHDR/PLTE/tRNS/IDAT/IEND,剥离全部pHYs/tIME/bKGD/iCCP/iTXt/tEXt/zTXt等非关键元数据(同时剔除 10 处损坏iCCP块); - 不在此阶段对 1.7 万张即将删减的 PNG 做离线重提交;仅删除 1.20.1 的
GIMP.txt残留,并视需要单修极少数在开发期runClient确定会触发严格解码报错的留存坏块文件。
- 新增纯 Java 增量/可缓存 Gradle 任务(输出缓存至
- 修复
incremental-resources.gradle删文件同步滞后 & 建设增量门禁:确保源码删除文件时同步清理build/resources与 PNG 清洗缓存目录产物;在tools/resources/增加只读检测脚本拦截新 PR 引入损坏 PNG CRC、超标元数据与 0-Alpha 全透明占位图(存量历史图在 [resource] 材质图标与材料模型收敛:注册范围裁剪、继承回退树、去空占位与动态绘制方案 #384/[resource] 机器贴图与机器模型/方块状态正交重构(壳体着色 + 差异叠加层) #396/[resource] 同模板换色资产动态分层绘制与原版unstitch图集压缩(木桶/瓶罐/流体/零散图标) #397 清理期间暂走基线追踪)。
Step 2(Phase 4:全治理收口后终局离线压榨与基线锁定)
- 待 [resource] 材质图标与材料模型收敛:注册范围裁剪、继承回退树、去空占位与动态绘制方案 #384 与 [resource] 机器贴图与机器模型/方块状态正交重构(壳体着色 + 差异叠加层) #396–[resource] 模型/Blockstate 死文件清理、全虚拟化收口与
stack_groups瘦身 #400 全部收口(大部分冗余图已删除、unstitch大图已重绘),仅对最终留存的少量源码 PNG 执行一次性的离线元数据净化与深度IDAT无损压榨(此时 Git 历史增量极微),并在tools/resources/锁定最终 JAR 体积、条目数与零元数据/零坏块门禁(同时保留本地/打包期 PNG 过滤作为防回退兜底)。
三、验收标准
- Phase 1:
includeEmptyDirs = false在 1.20.1 Forge 与 1.21.1 NeoForge 发行 JAR 通过完整启动、Mixin/SPI 加载、材质加载与 GameTest 验证,条目数立减 ~1,700、体积立减 ~0.35 MiB; - Phase 1:Gradle 增量缓存式 PNG Chunk 过滤落地,本地二次构建增量耗时极低、Git 源码零批量改写,JAR 体积再减 ~1.42 MiB;
GIMP.txt已删且incremental-resources.gradle删文件同步验证通过; - Phase 4:对最终留存 PNG 完成终局离线
IDAT压榨与损坏源码清理,tools/resources/门禁脚本锁定最终基线。
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 errorscope: 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
build(resources): wire verifyPngFilter into check and refine CI and docs