Skip to content

[resource] 机器贴图与机器模型/方块状态正交重构(壳体着色 + 差异叠加层) #396

Open

Description

@Tanimodori

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

所属阶段:Phase 2(正交收敛,与 #384 Step 2 / 配方 / Lang 并行)

前置依赖:Phase 1 基线稳定,复用既有 MaterialBlockBakedModel / BakedModelMap / SharedInventoryModelPack 基础设施;下游解锁:Phase 3 unstitch 合图(#397 · Step 2)与 Phase 4 平铺模型全虚拟化(#400 · Step 2)。


一、现状与问题定位

assets/gt6ce/textures/block/machines/ 与对应的机器模型/方块状态是仅次于材质图标的第二大贴图与大 JSON 膨胀源:

  1. 贴图规模与高度重复(textures/block/machines/):
    • 1.0.7 JAR 共 3,996 条目(源码 851c92179 为 3,988 文件 = 3,825 PNG + 163 .mcmeta),JAR 占用 2.51 MiB(压缩载荷 1.53 MiB + ZIP 开销 0.98 MiB)。
    • 字节去重后仅 1,019 个唯一 SHA-1:2,814 张(73.4%)为完全重复副本(浪费 1.68 MiB),其中 685 张为全透明空图(浪费 0.25 MiB),且调色板同构模板仅 739 个(唯一 Alpha 掩码仅 299 个)。
    • 最大大户是 basicmachines/:79 种机器 × 24 张贴图(colored、overlay、overlay_active、overlay_running × 6 面)= 1,896 张 PNG,但仅 310 个唯一 MD5(1,586 张重复 = 83.7%,含 415 张全透明空图)。
    • 大尺寸与未引用贴图:multiblockmains/turbine_active.png(48×384,22.5 KB)为全包单张最大贴图;另有 351 张 PNG 无字面路径匹配(含部分 MachineTextures/covers/barometer 动态拼接引用及一批废弃/未移植残余图)。
  2. 模型 JSON 体积庞大(models/block/machine/):
    • minecraft/src/main/resources/assets/gt6ce/models/block/machine/ 共 1,724 个 JSON(含 basic/ 237 个、energy/ 460 个、多方块/物流等),每个均为 ~220 行的完整 forge:composite 内联立方体(仅 basic/ + energy/ 折前源码就超 2.1 MiB)。

二、Phase 2 实施方案(对标 GregTech-Modern 正交模型架构)

参考 _reference/GregTech-Modern(全模组仅 495 张机器贴图 + 348 张外壳贴图)与 GT6CE 现有的 MachineBlockClientModels / MaterialBlockBakedModel 基础设施:

  1. 清理未引用死图与大尺寸冗余:梳理 351 张无字面匹配贴图,保留 MachineTextures/covers/BoilerBarometerRenderer 等代码拼接引用,移除确认废弃/未移植的死图;审查 turbine_active.png 等多帧动画图是否可精简多余帧。
  2. 正交拆分“通用壳体底图(可着色)+ 差异面 Overlay”:
    • 壳体层(Base Casing):抽离少数通用金属/砖块/框架基础壳体贴图(top、bottom、side 等),在模型层固定走 tintindex 0(按机器材质 GTMaterial.getColor() 动态着色),消除 79 台基础机器各自复制一份重复 colored/*.png 的冗余。
    • 叠加层(Overlay / Active / Running):每台机器仅保留确实有图案的非空面贴图;无叠加图案的侧面与无状态差异的面不再放置 141 B 空透明 PNG。
  3. 扩展 MachineBlockClientModels 为程序化机器 BakedModel:
    • 在 MachineBlockClientModels 注册程序化机器烘焙模型(支持基础机、能源盒、发电机等);
    • 在烘焙期按机器规格与精灵存在性,动态拼装“底壳 + 存在的 overlay* 面”(不存在的面直接跳过,连 1 张 void.png 都不需要),自动处理 FACING / ACTIVE / RUNNING 旋转与状态映射;
    • 借此淘汰 models/block/machine/basic/(237 份)与 energy/(460 份)等上千份 220 行 forge:composite 静态 JSON 与配套 blockstates,交由 SharedInventoryModelPack 提供最简占位或动态注册。

三、验收标准

  • textures/block/machines/ 全透明空图清零(消除 685 张空 PNG),跨机器重复壳体与相同 overlay 副本归并完成(3,825 张 PNG 收敛至 ≤950 张);
  • basicmachines / energy 等同构 220 行 forge:composite 模型迁移至动态 BakedModel 体系,消除上千份重复机器 JSON;
  • 核验 MachineTextures、BoilerBarometerRenderer、Cover 渲染器等全部代码拼接路径无遗漏;
  • 双平台(1.20.1 Forge / 1.21.1 NeoForge)进入游戏实际放置、旋转朝向、切换闲置/运行状态与机器染色,确认所有面渲染、破坏粒子与物品栏图标 100% 正常且无缺图日志警告。

Activity

  1. self-assigned this
    on Nov 14, 2026
  2. added
    enhancement建议总类 / Suggestion umbrella
    priority: high崩溃、数据丢失或主要功能不可用 / Crash, data loss or major feature unusable
    perf卡顿、内存、启动或注册耗时 / Lag, memory, startup or registration cost
    refactor重构、清理、内部实现调整,不改变对外行为 / Refactor, cleanup or internal change without external behavior change
    scope: machine机器、多方块、坩埚、核与传感器 / Machines, multiblocks, crucible, nuclear and sensors
    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: high崩溃、数据丢失或主要功能不可用 / Crash, data loss or major feature unusablerefactor重构、清理、内部实现调整,不改变对外行为 / Refactor, cleanup or internal change without external behavior changescope: machine机器、多方块、坩埚、核与传感器 / Machines, multiblocks, crucible, nuclear and sensorsscope: 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