Skip to content

feat(resources): 第一阶段资源瘦身与打包去重(Part of #383) - #402

Merged
Tanimodori merged 5 commits into
masterfrom
feat/issue-383-phase1
Nov 14, 2026
Merged

Tanimodori merged 5 commits into
masterfrom
feat/issue-383-phase1

Conversation

@Tanimodori

Copy link
Copy Markdown
Member

Part of #383, #401, #384, #400(第一阶段瘦身与去重落地;上述四项 issue 均仍有后续步骤,合并后请保持打开)。

变更概要

1. 构建打包与 PNG 无损元数据剥离(Part of #401)

  • 在根 build.gradle、core/build.gradle、gradle/platform-forge.gradle 与 gradle/platform-neoforge.gradle 中配置 includeEmptyDirs = false,在资源打包阶段剔除空目录条目。
  • 新增 gradle/png-chunk.gradle(PngChunkFilter 与 :core:verifyPngFilter),在 gradle/incremental-resources.gradle 增量同步资源时仅保留 IHDR、PLTE、tRNS、IDAT、IEND 关键数据块,无损剥离元数据与异常 iCCP 块,并清理遗留的 GIMP.txt。
  • 新增 tools/resources/check_png_metadata.py 与 CI Verify packaged resources 严格门禁(.github/workflows/build.yml),同步更新 tools/README.md、tools/resources/README.md 与 docs/。

2. 传输方块占位虚拟化与死 JSON 清理(Part of #400)

  • 扩展 SharedInventoryModelPack.emitTransportPlaceholders(...),在 aliases 之后为 GTFluidPipes、GTItemPipes、GTWires、GTSignalWires、GTAxles 及 AddonPipeRegistration 发射引用 minecraft:block/stone 的虚拟占位 blockstate / item model,移除 PipeWireClientModels 中未使用的 AXLE_TEX。
  • 删除 3,177 份静态传输方块 blockstate / item / block model JSON。

3. 材料图标收敛、流体模板外迁与覆盖板绘制修复(Part of #384)

  • 将流体共用模板迁至 textures/block/fluids/templates/,同步调整 FluidTexturePolicy、FluidVisualPolicy 与 MaterialFluidVisuals。
  • 将 MaterialTextureSet.modeled() 收敛至 35 个实际使用材质集(保留全量 41 个枚举常量兼容性),使 MaterialIconDefinitions、MaterialIcons、BlockMaterialIcons、SmelteryModelHelper、坩埚/金属砧/工具渲染链路将 layer1 / _overlay 视作可选。
  • 清理 6 个未引用材质集资源、全透明占位 PNG 与未引用孤立贴图/JSON;保留 35 个 modeled() 材质集被 MaterialCoverRules 使用的 block/material_icons/<set>/foil.png。
  • 在 ArmRenderHelper 新增 findSprite,修复 PanelCoverRenderer 在 _overlay 贴图已清理时向 layer 1 绘制缺失贴图导致覆盖板发紫黑块的问题,并补充 MaterialIconIntegrityTest(含 coverDesignsShipTheirIconSprites)。

体积对比(本地构建产物实测)

  • 1.20.1 Forge JAR:20,231,406 B(16,063 条生成 JSON / 28,465 项验证资源 / 12,228 张 PNG 严格校验通过)
  • 1.21.1 NeoForge JAR:20,297,425 B(15,739 条生成 JSON / 28,132 项验证资源 / 12,228 张 PNG 严格校验通过)

验证记录

  • python tools/validation/route.py check:通过
  • python tools/comments/check_comment_refs.py --diff origin/master:0 失败
  • ./gradlew --no-daemon --stacktrace :core:verifyPngFilter :api:check :core:check :buildtools:check :minecraft:spotlessCheck:通过
  • ./gradlew --no-daemon --stacktrace :minecraft:1.20.1-forge:assemble :minecraft:1.20.1-forge:compileTestJava :minecraft:1.20.1-forge:spotlessCheck :minecraft:1.21.1-neoforge:assemble :minecraft:1.21.1-neoforge:compileTestJava :minecraft:1.21.1-neoforge:spotlessCheck:通过
  • tools/resources/check_compact_model_json.py 与 tools/resources/check_png_metadata.py --strict(双平台 JAR 及处理后资源目录):0 异常
  • ./gradlew --no-daemon --stacktrace :minecraft:1.21.1-neoforge:runGameTestServer:113 required tests passed
  • ./gradlew --no-daemon --stacktrace :minecraft:1.20.1-forge:runGameTestServer:108 required tests passed
  • 1.21.1 NeoForge 客户端实机测试:启动耗时 40.741s,铝合金板等覆盖板、坩埚、浸洗锅与常规渲染通过

@lombinaxmasson lombinaxmasson left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

铁砧原矿工作件仍需要非空覆盖层
位置:[MaterialAnvilRenderer.java:64]
这里整体删除了覆盖层绘制,但青金石、红石等材质仍保留有效的 blockraw_overlay.png。像素检查确认:底图有 76/256 个透明像素,覆盖层恰好补全这些位置。将对应碎矿放上铁砧后,工作件表面会出现透明缺口。
应恢复“覆盖层存在时绘制”的逻辑,缺失覆盖层时跳过。

@Tanimodori

Copy link
Copy Markdown
Member Author

已按审阅意见完成修复并推送(47a6eca61、b1a6eca61):

  1. 恢复铁砧工作件非空覆盖层绘制(47a6eca61)

    • 在 minecraft/src/main/java/gregtech/client/CrucibleRenderSprites.java 恢复 hasTexture(ResourceLocation)。
    • 在 minecraft/src/main/java/gregtech/client/MaterialAnvilRenderer.java 提取 drawMaterialCuboid(...),对工件与锤头统一保留“存在 <texture>_overlay 时叠加 0xFFFFFF 绘制、缺失时跳过”,修复 blockraw_overlay.png 对应材质集(青金石、红石、钻石等)在铁砧表面出现的透明缺口。
  2. 构建校验、文档与 CI 细节收口(b1a6eca61)

    • gradle/png-chunk.gradle:将 verifyPngFilter 接入 check 并补充输入/输出声明,避免 CI 的 :core:check 漏跑该自检;同时将注释及 docs/architecture/resources.md 表述精确为“解码后的像素与调色板数据完全一致(同时剥离 gAMA/sRGB/cHRM 等辅助元数据块)”。
    • .github/workflows/build.yml:在 Verify packaged resources 按 *-${{ steps.version.outputs.version }}.jar + [[ -f "$candidate" ]] 过滤当前版本产物。
    • tools/resources/README.md:将示例文件名中的旧版 1.0.2 替换为 <version> 占位符。

本地复测结果

  • :api:check :core:check :buildtools:check :minecraft:spotlessCheck 与双平台 assemble / compileTestJava / spotlessCheck:BUILD SUCCESSFUL(:core:check 依赖树包含 :core:verifyPngFilter)。
  • python tools/validation/route.py check、python tools/comments/check_comment_refs.py --diff origin/master:0 失败。
  • check_compact_model_json.py 与 check_png_metadata.py --strict(gt6ce-1.20.1-forge-1.0.7.jar 20,231,667 B 与 gt6ce-neoforge-1.21.1-1.0.7.jar 20,297,686 B):12228 张 PNG 检查 0 异常。
  • :minecraft:1.21.1-neoforge:runGameTestServer:All 113 required tests passed :)(37.38 s)。
  • :minecraft:1.20.1-forge:runGameTestServer:All 108 required tests passed :)。
  • 1.21.1 NeoForge 客户端实机复测(青金石/红石/钻石等铁砧工件及回归项):通过(启动耗时 39.464s)。

@Tanimodori
Tanimodori merged commit b1a6eca into master Nov 14, 2026
4 checks passed
@Tanimodori
Tanimodori deleted the feat/issue-383-phase1 branch November 14, 2026 15:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants