Skip to content

[resource] 同模板换色资产动态分层绘制与原版 unstitch 图集压缩(木桶/瓶罐/流体/零散图标) #397

Open

Description

@Tanimodori

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

所属阶段:Phase 3(Step 1:动态分层绘制;Step 2:静态小图 unstitch 合图)

前置依赖:


一、现状与定量证据

除了 material_icons 与 machines 之外,GT6CE 还存在两类合计超过 2.5+ MiB 的贴图浪费:

  1. “同模换色”硬拷贝预烘焙:
    • item/wooden_buckets:126 张 PNG(0.09 MiB),对应 WoodenBucketCatalog 的 9 种金属箍 × 14 种内容物,唯一 Alpha 掩码只有 1 个——全部木桶外形一模一样,仅金属箍与液面颜色不同;
    • item/bottles:167 张 PNG(0.09 MiB),仅 94 个调色板同构、唯一 Alpha 掩码仅 18 个(约 29 张在代码与模型中无引用);
    • item/cans:57 张 PNG(0.05 MiB),仅 22 个调色板同构、唯一 Alpha 掩码仅 7 个;
    • block/fluids:183 张 PNG + 169 .mcmeta = 0.97 MiB(占贴图总体积近 9%),其中 160 张是 16×512、8 张是 16×320 的高长动画条,但仅 61 个调色板同构、唯一 Alpha 掩码仅 10 个(且 beer 等 10 种流体共用同图)。
  2. 大量分散的 16×16 手绘小图推高 ZIP 目录税与 PNG 帧头税:
    • block/iconsets(392 PNG / 0.29 MiB)、block/stones(304 PNG / 0.24 MiB,仅 2 个唯一 Alpha)、item/food(264 PNG / 0.19 MiB)、item/technological(302 PNG / 0.18 MiB)、item/randomtools(145 PNG / 0.13 MiB)、item/iconsets(188 PNG / 0.09 MiB)、item/triggers(80 PNG / 0.10 MiB)等合计 1,800+ 个小文件,单单 ZIP 头部与 PNG 帧头就占去 ~0.35–0.45 MiB。

二、分步骤实施方案(双平台 1.20.1 / 1.21.1 统一可行路径)

Step 1(Phase 3A):同模换色资产“分层动态染色”或“运行期 NativeImage 动态绘制”

  1. 优先路径——原生多层模型 + ItemColor 动态染色(零额外图集像素、零运行期构图开销):
    • wooden_buckets(126 PNG → 3 PNG):拆为 wooden_bucket_base.png、wooden_bucket_band_overlay.png(layer1,按 Band.material 染色)、wooden_bucket_liquid_overlay.png(layer2,按流体颜色染色,空桶不声明 layer2)。126 个物品通过 SharedInventoryModelPack + ItemColor 渲染,同步消除 123 张冗余 PNG 与 126 个静态模型 JSON。
    • block/fluids(扩大 FluidVisualPolicy 模板覆盖):审计其余 183 张 16×512 流体动画图,将纯单色/双色换色流体全部改为引用少数灰度波纹动画模板 + IClientFluidTypeExtensions / FluidType 动态着色(顺带核实/修复旧注提及的 beer 等 10 种流体同图问题),预计将 block/fluids 0.97 MiB 压缩 60%–75%。
  2. 补充路径——双平台兼容的低优先级 PackResources + NativeImage 运行期动态绘制:
    • 对于单像素内部存在多色渐变、不便用多层 tintindex 表达的换色资产(部分 bottles、cans、个别复合流体/图标),在共享客户端低优先级内置 PackResources 中,读取少量灰度模板与调色板表,在图集加载后台线程用 MC 原生 NativeImage.mappedCopy(...) + NativeImage.asByteArray() 动态合成 PNG 字节流(注意不调用渲染线程断言方法并及时 close() 释放堆外内存;优先探测上层用户资源包覆盖)。
    • 技术红线:不使用 NeoForge 独占的 RegisterSpriteSourceTypesEvent,不使用会撑爆图集的 minecraft:paletted_permutations。

Step 2(Phase 3B):留存 16×16 静态图标集使用原版 minecraft:unstitch 合图

在 Phase 1–2(#384、机器)与本课题 Step 1 均收敛完毕后,针对最终确认保留的不可动态染色静态 16×16 手绘图标(留存材料唯一样本、block/stones、block/iconsets、item/iconsets、item/food、item/technological、item/randomtools、item/triggers 等):

  • 提供打包工具将无 .mcmeta 动画的同类 16×16 静态图拼合为少数 512×512(单张可纳 1,024 张 16×16)大图;
  • 在 assets/minecraft/atlases/blocks.json 中使用 MC 1.20.1 / 1.21.1 原生 "type": "minecraft:unstitch" 切分还原回原 ResourceLocation sprite ID(用户资源包仍可按原路径单独覆盖任意小图),将上千个 ZIP 条目和 PNG 帧头压到十几个条目。

三、验收标准

  • Step 1:wooden_buckets(126→3 张基图)、cans/bottles(含清理 ~29 张未引用瓶贴图)与 block/fluids 完成动态分层/动态绘制改造;
  • Step 2:留存静态 16×16 图集完成 minecraft:unstitch 合图,验证外部资源包按原路径覆盖单张贴图依然生效;
  • 双平台(1.20.1 Forge / 1.21.1 NeoForge)实机验证木桶、瓶罐、流体、石头、食物与工具图标渲染正确,无图集拼接警告与堆外内存泄漏。

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