Skip to content

[resource] 构建打包与 PNG 底层无损瘦身(去除空目录条目、剥离元数据、修复坏块与 CI 门禁) #401

Open

Description

@Tanimodori

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

所属阶段:跨越 Phase 1(Step 1:最先落地的无损瘦身与基础门禁) → Phase 4(Step 2:全线收口后最终基线锁定)

依赖关系:


一、现状与定量证据

在不动任何游戏玩法、模型结构与贴图内容的前提下,仅构建打包层与 PNG 元数据剥离两项“纯工程红利”,在 1.0.7 JAR 中就隐藏着 ~1.77 MiB 的确定性浪费:

  1. 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-NeoForge FilePackResources.java:原版 getResource 按完整路径查找,listResources 显式跳过 !zipentry.isDirectory()。
  2. PNG 夹带 1.84 MiB 非必要元数据 chunk 与 10 处 CRC 损坏:
  3. 增量构建缓存幽灵残留与 1.20.1 源码残留:
    • minecraft/versions/1.20.1-forge/src/main/resources/assets/gt6ce/textures/block/overlays/characters/GIMP.txt(113 B)为无效开发残留;
    • 1.0.7 JAR 因 core/build/resources/main 增量残留而夹带已从源码删除的 coin 资源(187 条 / 0.12 MiB),需检查 gradle/incremental-resources.gradle 对删除源文件的清理同步。

二、分阶段实施方案

Step 1(Phase 1:零 Git 膨胀构建期瘦身 + 基础门禁,立省 ~1.77 MiB)

  1. 验证并开启 includeEmptyDirs = false:在 core/build.gradle、gradle/platform-forge.gradle、gradle/platform-neoforge.gradle 的 jar / distributionJar 任务上配置 includeEmptyDirs = false,实测验证双端 ModFile / SecureJar、Mixin 扫描、ServiceLoader 与 FilePackResources 正常加载。
  2. 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 确定会触发严格解码报错的留存坏块文件。
  3. 修复 incremental-resources.gradle 删文件同步滞后 & 建设增量门禁:确保源码删除文件时同步清理 build/resources 与 PNG 清洗缓存目录产物;在 tools/resources/ 增加只读检测脚本拦截新 PR 引入损坏 PNG CRC、超标元数据与 0-Alpha 全透明占位图(存量历史图在 [resource] 材质图标与材料模型收敛:注册范围裁剪、继承回退树、去空占位与动态绘制方案 #384/[resource] 机器贴图与机器模型/方块状态正交重构(壳体着色 + 差异叠加层) #396/[resource] 同模板换色资产动态分层绘制与原版 unstitch 图集压缩(木桶/瓶罐/流体/零散图标) #397 清理期间暂走基线追踪)。

Step 2(Phase 4:全治理收口后终局离线压榨与基线锁定)


三、验收标准

  • 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/ 门禁脚本锁定最终基线。

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
    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 errorscope: 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