Skip to content

feat(resources): 第二阶段材料图标收敛与机器正交重构(Part of #383) - #404

Open
Tanimodori wants to merge 9 commits into
masterfrom
feat/issue-383-phase2
Open

Tanimodori wants to merge 9 commits into
masterfrom
feat/issue-383-phase2

Conversation

@Tanimodori

@Tanimodori Tanimodori commented Nov 15, 2026 •

Copy link
Copy Markdown
Member

变更概要

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 探测,不按热重载切换)。
  • 移除静态材料模型 JSON 与沿继承链字节重复的图标贴图,扩展 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 第一阶段基线)

  • 1.20.1 Forge JAR:16,134,695 B(10,357 条生成 JSON / 15,306 项验证资源 / 4,779 张 PNG;对比 #402 基线 20,231,406 B / 12,228 张 PNG)
  • 1.21.1 NeoForge JAR: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:MaterialIconIntegrityTest 11/11、MachineModelIntegrityTest 6/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 passed
  • 1.21.1 NeoForge 客户端游戏内人工验证:基础加工机 GUI 动画与手持/掉落/展示框关闭、产能/转换/泵全场景闲置、砖块燃烧室顶部与多方块控制器外观、熔融流体材料专用贴图(molten.cheese 等)、坩埚/壁板光照亮度、材料图标及 F3+T 重载通过(尚未进行外部自定义资源包客户端实机目测;按本轮验收确认,继续豁免 1.20.1 Forge 图形客户端人工目测与 BottleCrateBlock 热重载一致性,Forge 侧由上述编译、打包校验与 114 项 GameTest 覆盖)

Part of #383
Closes #384
Closes #396

@Tanimodori Tanimodori changed the title feat(resources): converge material icons and orthogonalize machine models (#384, #396) feat(resources): 第二阶段材料图标收敛与机器正交重构(Part of #383) Nov 15, 2026

@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.

核对后确认这四点均成立,均为 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 时读取已选资源包内容(排除自身包避免递归);若暂不支持,至少在文档中写明"共享模型只按内置资源选择贴图",并让完整性与运行期探测使用同一口径。

@Tanimodori

Copy link
Copy Markdown
Member Author

感谢详细复核,4 项 P2 问题及附带确认项已在提交 298e55aed 中逐一修复并补充说明:

1. [P2] 机器模型 side == null 重复提交面并绕过相邻剔除 — 已修复

  • 改动:OrthogonalMachineBakedModel.getQuads 与 LayerPass.getQuads 在 side == null 时均直接返回 List.of(),并移除已冗余的 baseQuads / overlayQuads 字段。表内全部分片均以非空方向作为 cullface 烘焙,SimpleBakedModel 约定 side == null 仅返回无剔除面,修复后与原 forge:composite 行为一致。
  • 补充核对:因原版 RenderType 使用 LEQUAL 深度测试与背面剔除、同顶点按固定顺序重复绘制不会出现共面 z-fighting,原实现的主要问题是双倍顶点/AO 计算与邻接剔除失效;此外 BakedQuad.getDirection() 永不为 null 且不含 cullface 字段,现直接以“全表无 unculled 面”统一返回空列表。

2. [P2] 熔融流体跳过材料专用贴图 — 已修复并补测试

  • 改动:在 MaterialIconDefinitions 新增精灵路径辅助 blockIconPath 与 resolveBlockIconOwner(与 resolveTextureOwner 共用链表遍历 resolveChainOwner),明确区分“精灵 ID(无 textures/ 与 .png)”和“相对文件路径”;FluidVisualPolicy.select 改调 resolveBlockIconOwner,消除了 textures/textures/...png.png 双重拼接。
  • 测试补齐:
    • MaterialIconIntegrityTest 新增 blockIconOwnersFollowTheParentChain 与 blockIconOwnersAreProbedWithSpriteIdsOnly(断言探测字符串不含 textures/ 前缀和 .png 后缀,覆盖 FINE -> FINE、METALLIC -> DULL 与未命中分支)。
    • 新增 FluidVisualPolicyTests(2 项 GameTest),直接验证 Molten_Cheese(FINE)与 GenMolten_Iron(METALLIC -> DULL)调用 FluidVisualPolicy.select 返回材料专用精灵路径。

3. [P2] 机器烘焙覆盖资源包与共享行模型旋转丢失 — 已采用虚拟 blockstate 彻底修复

  • 改动:
    • SharedInventoryModelPack 不再为表内机器写入 minecraft:block/stone 占位,改为在 emitMachineModelSpecs 之后由 emitMachineBlockstatesAndItems 按 OrthogonalMachineFamilies.world(state) 为表内所有机器直接生成带 model/x/y/uvlock 的虚拟 blockstates/<id>.json,以及指向行模型的 gt6ce:shared_inventory models/item/<id>.json(均用 putIfAbsent 保持 Pack.Position.BOTTOM 低优先级)。
    • MachineBlockClientModels 彻底移除 putState 世界覆写与旧 Bakes 旋转回退缓存(并删除无引用的 BurningBoxBakedModel、MachineBlockIcons 及 OrthogonalMachineBakedModel 中的 rebake/modelState/LockedModelState):世界方块状态直接由原版 ModelBakery 按 blockstate 烘焙与旋转,资源包无论覆盖 blockstates/ 还是仅覆盖共享行模型都能保留正确 x/y/uvlock;物品侧先通过 isExternalItemOverride(检测生效资源 sourcePackId 是否为 SharedInventoryModelPack.PACK_ID)放行外部 models/item/*.json 覆盖,再应用 GUI/手持显示分流。
  • 一并清理的遗留遮蔽与回归测试:验证中发现 burning_box_solid_brick.json(导致砖块燃烧室顶部误指 burning_box_solid)及 distillation_tower_main、fusion_reactor_main、implosion_compressor_main 遗留了 7 个静态 blockstates/models/item JSON 遮蔽低优先级虚拟包,已全部删除,并在 MachineModelCoverageTests.everyTableBlockStateNamesATableRow 加入“表内机器零静态 blockstates/models/item 遮蔽”与砖块燃烧室断言。

4. [P2] 材料共享模型跳过资源包且与索引口径不一致 — 已通过外部包枚举修复

  • 改动:SharedInventoryModelPack.buildResources() 改为在 collectExternalMaterialIcons 中校验本包已挂载进当前 ResourceManager 后,遍历 manager.listPacks() 排除自身并仅对 "textures/item/material_icons" 与 "textures/block/material_icons" 枚举路径(不打开流、保留 ThreadLocal BUILD_DEPTH 防重入),合并 classpath 后同时传给 MaterialSharedModelIndex.items(Predicate) / blocks(Predicate) 与 sharedModelJson。启动与 F3+T 重载均能识别外部资源包新增的子级基础图与 _overlay,且打包与模型索引对可用贴图集合保持一致。
  • 同时补全校验:MaterialIconIntegrityTest 新增 everyModeledSetResolvesEveryBlockIcon,覆盖 BlockPrefixRegistry.all() 全量非 addon 方块前缀以及 ore/oresmall。

5. 附带确认:OreClientModels.resolveOverlayTexture(DIAMOND / EMERALD 矿石覆盖层)

  • 经逐 blob 核对:origin/master 去重前 35 个材质集合均各自自带 ore.png 与 oresmall.png,因此旧 {primary, DULL, METALLIC} 回退从未落到过 DULL;同时原版及 origin/master 中的 diamond/ore.png、emerald/ore.png 与 ruby/ore.png 本就是逐字节完全相同的晶簇贴图(dull/ore.png 为散点)。改用父链回退(EMERALD -> DIAMOND -> RUBY)恰恰保证了像素外观与 origin/master 完全一致;资源包若单独新增 diamond/ore.png,MaterialIcons.resourceExists 也会继续优先命中该子级文件。已在 PR 正文说明上述语义与资源包覆盖规则。

复测情况(298e55aed)

  • route.py check、check_comment_refs.py --diff origin/master(0 failure)、:api:check :core:check :buildtools:check(MaterialIconIntegrityTest 11/11、MachineModelIntegrityTest 6/6)、全模块 spotlessCheck --rerun-tasks、assembleBothPlatforms、check_compact_model_json.py 与 check_png_metadata.py --strict 均通过。
  • 双平台 GameTest:1.20.1-forge 114/114 通过、1.21.1-neoforge 119/119 通过。
  • 1.21.1 NeoForge 客户端实机复测:砖块燃烧室顶面/点火、多方块控制器、熔融流体专用贴图(molten.cheese 等)与 F3+T 重载通过(外部自定义资源包客户端实机覆写未测,由上述包构建与烘焙流程逻辑覆盖)。

@lombinaxmasson

Copy link
Copy Markdown
Collaborator

沿资源枚举链路复核了 head 298e55aed,发现两处资源包兼容问题,另补充几处同源问题。

1. [P3] 材料贴图索引忽略 pack.mcmeta 的 filter

SharedInventoryModelPack.collectExternalMaterialIcons(SharedInventoryModelPack.java:345-363)逐个 PackResources 调用 listResources,不经过 FallbackResourceManager 的 PackEntry.isFiltered 检查;1.20.1 与 1.21.1 的过滤都只在 getResource / getResourceStack / listResources 内部执行。结果是高优先级包通过 filter 屏蔽的低优先级贴图仍会进入 externalIcons,生成模型引用它,而图集(minecraft:directory source 走的正是过滤后的 listResources)不会拼入该精灵。

影响不止缺图:注册索引 MaterialSharedModelIndex.items() 使用走 ResourceManager 的 MaterialIcons::resourceExists(过滤生效),会判定该组合不存在而不注册共享模型;pack 却仍生成并引用它,MaterialSharedModelIndex 注释里“注册与 pack 必然一致”的假设在过滤场景下失效。

复现:低优先级包提供 magnetic/ingot.png,高优先级包 filter 掉该路径 → 磁化金属锭引用缺失的 magnetic/ingot.png,而不是回退到仍可用的 metallic/ingot.png。

2. [P3] 钢制瓶箱首次启动忽略资源包覆盖

BottleCrateBlock.frameTexture()(BottleCrateBlock.java:97-106)固定使用 classpathResourceExists,调用点在 SharedInventoryModelPack.java:153。这不是“启动期拿不到 manager”:ReloadableResourceManager.createReload 会先替换 resources,再创建并执行 reload listeners(1.20.1 Minecraft.java:559-561,1.21.1 同构),模型烘焙属于 listener,所以首次启动时 manager 已挂载所有启用的资源包。当前实现是“从未查询”,不是“无法查询”,PR 描述中的热重载豁免覆盖不了启动时已启用的旧包。

复现:已启用资源包提供 metallic/casingmachine.png → 瓶箱仍选择 dull/casingmachine。

3. [P3] classpath 兜底同样绕过过滤

仅修 collectExternalMaterialIcons 不够:MaterialIcons.resourceExists(MaterialIcons.java:29-41)在 manager 查不到时仍 OR classpathResourceExists,SharedInventoryModelPack.java:140-141 的 materialExists 也一样。pack 用 filter 屏蔽内置 metallic/ingot.png 时仍会被判定存在;OreClientModels、PanelCoverRenderer 等运行期解析同样受影响。建议 manager 挂载 gt6ce 时只信 manager,仅在 manager 不可用(首次 reload 前)时回退 classpath。

注意构建期自递归:构建线程查询 manager 时,缺失资源会落到本包 getResource → data()。需要给 SharedInventoryModelPack.getResource / listResources 加 isBuilding() 短路(现有 ThreadLocal 正好按线程区分),之后 MaterialIcons.resourceExists 在构建期也能安全走 manager,materialExists 可直接改为 externalIcons::contains。

4. [P4] 模型存在性判断未感知过滤

SharedInventoryModelPack.java:169、:215 与 hasTemplate(:365-374)以及 JsonResourceAliases.contains(JsonResourceAliases.java:21-23)用 classpath/构建期别名索引判断静态模型是否存在。高优先级包用 filter 隐藏某个 alias 且不提供替代时,pack 会跳过生成,最终该物品/方块没有模型。场景较少见,但属同一类不一致,建议一并改为 manager 探测或在 PR 中记录限制。

5. [P4] 实例身份启发式可删除

SharedInventoryModelPack.java:352 的 packs.stream().noneMatch(pack -> pack == this) 依赖 manager 持有同一实例,否则静默返回空集并缓存到 close()。改为 manager 列表后该判断不再需要;实际风险有限(pack 实例按 reload 重建),但注释与行为容易误导。

建议的统一修法

  1. collectExternalMaterialIcons 改用 manager.listResources(dir, id -> id.getNamespace().equals("gt6ce")),自动继承 filter 与优先级;manager 不可用或未挂载 gt6ce 时返回 null,materialExists 回退 classpath。
  2. MaterialIcons.resourceExists 在 manager 可用时以 manager 为准;配合上面的 isBuilding() 短路。
  3. frameTexture 改为 frameTexture(Predicate<String> resourceExists),由 pack 传入 materialExists,并删除 PR 描述中的瓶箱豁免说明。
  4. 可选:hasTemplate / JsonResourceAliases.contains 增加 manager 探测。

验证建议:这几处依赖真实资源栈,单测可把“过滤后的路径集合 + 父链选择”抽成纯函数覆盖;手动用一个带 filter 的测试包验证首启与 F3+T 两条路径。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

3 participants