Repository navigation
feat(resources): 第二阶段材料图标收敛与机器正交重构(Part of #383) - #404
Tanimodori wants to merge 9 commits into
Conversation
lombinaxmasson
left a comment
There was a problem hiding this comment.
核对后确认这四点均成立,均为 P2:
- #1、#2 是渲染回归:#1 会让机器面在每个渲染层重复提交并绕过相邻遮挡(1.20.1 与 1.21.1 的区块渲染器、ItemRenderer 行为均已对照反编译代码确认);#2 让所有 molten 材料丢失按材料贴图集选择的液面/世界流体贴图。
- #3、#4 是资源包兼容回归:机器模型烘焙会覆盖资源包提供的 blockstate / 共享模型 / 物品模型,且共享模型被替换时朝向旋转丢失;共享材料模型在打包阶段只按内置资源选择贴图,资源包新增子级贴图不生效。
这两类问题现有测试覆盖不到:MaterialIconIntegrityTest 全部使用 classpath 谓词,FluidVisualPolicy 的探测分支没有测试。建议合并前修复,或至少在 PR 中明确说明这些限制的接受范围。
另有一处请确认(不计入上述四点):OreClientModels.resolveOverlayTexture 从旧的固定回退 {primary, DULL, METALLIC} 改成父链回退后,DIAMOND/EMERALD(没有 ore/oresmall)会从 DULL 的覆盖层换成父级 RUBY 的覆盖层,两者像素不同,钻石/绿宝石矿的外观会变化——如果这是继承树的预期语义,建议在 PR 描述里写明。
1. [P2] 机器模型重复提交面并绕过相邻遮挡
minecraft/src/main/java/gregtech/client/OrthogonalMachineBakedModel.java:149-152
[P2] side == null 返回全部面:区块渲染与物品渲染都会重复提交
getQuads 在 side == null 时返回 base/overlay 全集,但两个调用方都不是这样使用返回值的:
- 区块渲染器(1.20.1
ModelBlockRenderer、1.21.1 NeoForge 版)先按Direction.values()取面并用Block.shouldRenderFace做相邻遮挡剔除,循环结束后再无条件渲染getQuads(state, null, …)。这里返回全集等于把刚剔除的面重新画一遍,相邻不透明方块挡不住它。 - 1.20.1 与 1.21.1 的
ItemRenderer.renderModelLists都是先逐方向查询、再查一次null。getRenderPasses返回的每一层因此也会被提交两次。
影响:solid/cutout 两层顶点翻倍;被遮挡的面与相邻方块的面共面且深度相等,cutout 层晚于 solid 绘制时会透出/闪烁,相邻机器之间会出现 z-fighting。旧 forge:composite 模型(layer0/layer1 子模型)的 null 查询返回空,不存在这个行为,属回归。
建议:这类立方体模型的所有面都带旋转后的方向,side == null 直接返回空列表;LayerPass.getQuads(330 行)同样处理。若确实存在无方向的四边面,只返回 getDirection() == null 的那些,而不是重复全集:
if (side == null) return List.of();2. [P2] 熔融流体会跳过材料专用贴图
minecraft/src/main/java/gregtech/engine/fluid/FluidVisualPolicy.java:48-52
[P2] 熔融流体的继承探测路径拼错,材料专用贴图永远不被选中
resolveBlockTextureOwner 传给谓词的是相对路径(如 textures/block/material_icons/wood/molten.png);这里把它包成 gt6ce:<path> 再交给 exists,而 FluidAppearance 的谓词把入参当精灵 ID,又拼一次 textures/ 和 .png,实际查找变成 textures/textures/block/material_icons/wood/molten.png.png,恒为 false。于是 owner 永远为 null,模板落到 block/fluids/templates/molten。
实测:wood/molten.png 是 16×512(20 帧动画),通用模板是 16×320(13 帧);metallic 没有 molten.png,本应继承 dull。凡是通过 GENERIC_MOLTEN 自动注册或登记了 molten 入口的材料,世界流体(GTFluids)、流体物品预览(FluidItemOverrideList)和坩埚/模具液面(MaterialFluidVisuals.fromFluidEntry)都会丢材料专用贴图;只有无流体入口的 genericMolten 路径是正确的。
建议让探测只保留一种口径:
- 让
exists接收相对路径,例如rel -> current.getResource(ResourceLocation.fromNamespaceAndPath(ns, rel));或 - 在传给
exists前把textures/…png剥回精灵 ID。
MaterialIconIntegrityTest 全部使用 classpath 相对路径谓词,覆盖不到这条运行期分支;建议补一个以精灵 ID 为输入的谓词测试。
3. [P2] 机器烘焙会覆盖高优先级资源包的模型
minecraft/src/main/java/gregtech/client/MachineBlockClientModels.java:141-147
[P2] 烘焙会覆盖资源包的机器 blockstate / 共享模型 / 物品模型
OrthogonalMachineFamilies.usesTable(...) 只查静态 TSV,与资源包无关,因此这里对所有可能状态无条件 putState:资源包为 autoclave_stainless_steel.json(或共享行模型)提供的自定义几何,会在烘焙回调里被表模型覆盖。
另一半问题:当共享行模型被资源包替换时,Bakes.get 的回退分支(296 行)用 models.find(modelId) 只拿到一个未旋转实例,并按 (modelId, xRot, yRot, uvLock) 缓存(300 行),于是东/南/西朝向复用北向几何,朝东/南/西仍显示朝北的贴图。
物品侧同样是无条件覆盖(127、163、191 行的 aliasBlockItem),资源包自定义的机器物品模型也会被忽略。
建议:覆盖前判断该槽位是否仍来自共享包占位/表模型(例如烘焙结果不是占位 stone/表模型时保留资源包模型);回退分支不要用一个 models.find 的结果服务所有旋转,至少按状态自身的 BlockModelShaper 键取已烘焙模型再决定。
4. [P2] 仅替换子级贴图的材料资源包会失效
minecraft/src/main/java/gregtech/client/SharedInventoryModelPack.java:258-259
[P2] 共享材料模型生成看不到资源包,子级贴图替换失效
emitSharedMaterialModels 在 buildResources() 内、building = true 期间执行,而 MaterialIcons.resourceExists 在 building 时刻意跳过资源管理器、只查 classpath(MaterialIcons.java:29-41)。因此父链探测看不到任何资源包:
- 内置
magnetic/没有ingot.png(继承metallic);资源包新增magnetic/ingot.png后,生成的models/item/material/magnetic/ingot.json仍写metallic/ingot; - 每次重载重新生成,结果都一样。
附带一个同源的不一致:MaterialSharedModelIndex 在 RegisterAdditional 阶段用资源管理器计算(能看到资源包),打包阶段却用 classpath;资源包为"整条链都不内置该贴图"的前缀新增贴图时,会注册出一个打包阶段根本不会生成的共享模型,表现为缺失模型。
建议:把 owner 决策移到烘焙期(类似 orthogonal_machine 的几何加载器),或在生成 JSON 时读取已选资源包内容(排除自身包避免递归);若暂不支持,至少在文档中写明"共享模型只按内置资源选择贴图",并让完整性与运行期探测使用同一口径。
|
感谢详细复核,4 项 P2 问题及附带确认项已在提交 1. [P2] 机器模型
|
|
沿资源枚举链路复核了 head 1. [P3] 材料贴图索引忽略
|
变更概要
1. 材料外观集继承回退树、模型虚拟化与冗余去重(#384 Step 2)
MaterialTextureSet与MaterialIconDefinitions引入父级继承回退树与贴图路径解析,将材料纹理集图标引用与块状流体精灵路径拆分为明确入口(resolveBlockTextureOwner/resolveBlockIconOwner/blockIconPath),避免资源路径与精灵 ID 混淆;OreClientModels.resolveOverlayTexture、FluidVisualPolicy、BottleCrateBlock与BlockMaterialIcons统一按该继承链解析(例如DIAMOND/EMERALD矿石覆盖层沿EMERALD -> DIAMOND -> RUBY解析到像素完全一致的ruby/ore.png/oresmall.png;第三方资源包在diamond/或子级目录下新增贴图仍优先命中,只是若仅保留未带贴图的默认配置则会走父链路径)。SharedInventoryModelPack在构造共享模型前通过ResourceManager.listPacks()排除自身包后枚举已启用外部资源包的textures/{item,block}/material_icons,与内置 classpath 合并传入MaterialSharedModelIndex及模型生成器,使外部资源包新增的子级材料基础图与_overlay在启动与F3+T重载期均动态生效(BottleCrateBlock继续使用编译期/启动期 classpath 探测,不按热重载切换)。MaterialIconIntegrityTest(5 → 11 项),校验父级无环与闭包、沿链贴图去重、孤立.mcmeta清理、静态材料模型清零、精灵 ID 探测契约以及全部内置方块/矿石与覆盖板图标解析,并新增FluidVisualPolicyTests(2 项 GameTest)验证FINE/METALLIC熔融流体贴图解析。2. 机器正交模型表、壳体着色合并与物品显示分流(#396)
core/src/main/resources/assets/gt6ce/machine_models.tsv(842 行数据,统一设置全不透明底壳列solidBase = 1)与OrthogonalMachineModels,将机器底壳与叠加层按朝向/点亮/运行/活动状态正交拆表管理。OrthogonalMachineModelLoader、OrthogonalMachineBakedModel、OrthogonalMachineFamilies并接入SharedInventoryModelPack与MachineBlockClientModels(移除旧MachineTextures、BurningBoxBakedModel、MachineBlockIcons及SmelteryModelHelper中未调用的漏斗模型辅助方法);表内所有面片均带非空cullface烘焙,getQuads(..., null, ...)与LayerPass.getQuads均返回空列表以避免块/物品重复提交与绕过邻接剔除;物品层使用Sheets.cutoutBlockSheet()恢复三面定向光照,并在 1.21.1 利用Variant/BlockModelRotation对齐 1.20.1 旋转绕序与uvlock。SharedInventoryModelPack为表内机器生成真实虚拟blockstates/*.json(含x/y/uvlock)及基于gt6ce:shared_inventory的models/item/*.json引用(统一使用putIfAbsent,且移除burning_box_solid_brick、distillation_tower_main、fusion_reactor_main、implosion_compressor_main遗留的 7 个静态遮蔽 JSON),使外部资源包覆盖blockstates/、共享行模型或models/item/均保留预期几何与旋转;MachineBlockClientModels仅在无外部models/item/覆盖时为物品接入方案 A 显示分流(DisplayContextItemBakedModel+BlockItemClientModels.asBlockItem(guiShared, worldShared):BasicMachineBlock在ItemDisplayContext.GUI显示_active工作面板,手持、掉落物与物品展示框显示闲置基模型;燃烧室north_off、能源节点、柴油/旋转引擎与旋转泵在全部物品场景保持关闭/闲置态)。casing/与shared_overlay/(core/src/main/resources/assets/gt6ce/textures/block/machines/收敛至 948 张受跟踪 PNG,含endergarbage/bin/overlay/3 张,位于 950 预算内),校准hull_bright与大型坩埚底图亮度与hull对齐,清理冗余静态机器模型/方块状态 JSON 与全透明占位图,并新增MachineModelIntegrityTest(6 项)与MachineModelCoverageTests(4 项 GameTest,含表内机器零静态遮蔽校验)。3. 构建接线与文档同步
core/build.gradle新增compileOnly 'org.jspecify:jspecify:1.0.0',并为:core:test增加gt6ce.coreAssets、gt6ce.minecraftAssets、gt6ce.forgeAssets、gt6ce.neoforgeAssets资产根目录系统属性。docs/architecture/resources.md、docs/architecture/packages/engine.md、docs/architecture/packages/runtime.md、docs/development/validation/checks/junit.md与docs/architecture/stonecutter/ClientModel/pack-facade.md。体积对比(本地构建产物实测,对照 #402 第一阶段基线)
16,134,695 B(10,357条生成 JSON /15,306项验证资源 /4,779张 PNG;对比#402基线20,231,406 B/12,228张 PNG)16,208,363 B(10,303条生成 JSON /15,250项验证资源 /4,779张 PNG;对比#402基线20,297,425 B/12,228张 PNG)验证记录
python tools/validation/route.py check:通过python tools/comments/check_comment_refs.py --diff origin/master:0 failure(s)./gradlew :api:check :core:check :buildtools:check :minecraft:spotlessCheck :minecraft:1.20.1-forge:spotlessCheck :minecraft:1.21.1-neoforge:spotlessCheck assembleBothPlatforms :minecraft:1.20.1-forge:compileTestJava :minecraft:1.21.1-neoforge:compileTestJava --no-build-cache --console=plain:通过./gradlew :core:test:MaterialIconIntegrityTest11/11、MachineModelIntegrityTest6/6 通过tools/resources/check_compact_model_json.py与tools/resources/check_png_metadata.py --strict(双平台 JAR 及处理后资源目录):0 告警./gradlew :minecraft:1.20.1-forge:runGameTestServer "-PgameTestHeap=4g" --console=plain:All 114 required tests passed./gradlew :minecraft:1.21.1-neoforge:runGameTestServer "-PgameTestHeap=4g" --console=plain:All 119 required tests passedmolten.cheese等)、坩埚/壁板光照亮度、材料图标及F3+T重载通过(尚未进行外部自定义资源包客户端实机目测;按本轮验收确认,继续豁免 1.20.1 Forge 图形客户端人工目测与BottleCrateBlock热重载一致性,Forge 侧由上述编译、打包校验与 114 项 GameTest 覆盖)Part of #383
Closes #384
Closes #396