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: 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 3(Step 1:动态分层绘制;Step 2:静态小图
unstitch合图)前置依赖:
- Step 1:依赖 Phase 1([resource] 材质图标与材料模型收敛:注册范围裁剪、继承回退树、去空占位与动态绘制方案 #384 · Step 1 迁出
FluidVisualPolicy3 张流体图) 与SharedInventoryModelPack基础能力;- Step 2:强前置依赖 Phase 2 收敛定稿([resource] 材质图标与材料模型收敛:注册范围裁剪、继承回退树、去空占位与动态绘制方案 #384 · Step 2 + [resource] 机器贴图与机器模型/方块状态正交重构(壳体着色 + 差异叠加层) #396 + 本课题 Step 1)——必须先确定“最终哪些静态 16×16 贴图真正保留”,再打成
unstitchspritesheet,避免反复重新打包图集;- 下游解锁:解锁 Phase 4 模型全虚拟化收口([resource] 模型/Blockstate 死文件清理、全虚拟化收口与
stack_groups瘦身 #400 · Step 2)。
一、现状与定量证据
除了 material_icons 与 machines 之外,GT6CE 还存在两类合计超过 2.5+ MiB 的贴图浪费:
- “同模换色”硬拷贝预烘焙:
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 种流体共用同图)。
- 大量分散的 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 动态绘制”
- 优先路径——原生多层模型 +
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/fluids0.97 MiB压缩 60%–75%。
- 补充路径——双平台兼容的低优先级
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"切分还原回原ResourceLocationsprite 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)实机验证木桶、瓶罐、流体、石头、食物与工具图标渲染正确,无图集拼接警告与堆外内存泄漏。
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: 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