模型查看器

交流与 Bug 报告 Discord：@swakoza

ModelViewer 是一款适用于 Minecraft Java 版的客户端 Fabric 模组，可帮助你了解游戏中实际使用的物品模型。

模组会显示模型路径、活跃资源包、最终 model JSON、父级链、绑定纹理、缺失资源，以及 Minecraft 为找到所选模型所经过的完整路径。

它对于处理资源包、自定义物品、custom_model_data 和 Blockbench 模型的用户特别有用。

这个模组有什么用？

通常，当物品模型显示不正确或根本不显示时，你必须手动在资源包中搜索正确的文件，检查覆盖、路径、纹理、父级和其他 JSON 文件。

ModelViewer 直接在游戏中完成这些工作。

你选择一个物品，模组就会显示其模型来自何处、哪个资源包胜出、找到了哪些文件、哪些文件缺失，以及 Minecraft 具体尝试渲染什么。

ModelViewer 能做什么？

• 检查主手中的物品。
• 检查副手中的物品。
• 检查物品栏中光标下的物品。
• 检查附近的物品：物品实体、物品展示框和物品展示实体。
• 显示活跃的 minecraft:item_model。
• 从活跃资源包中查找物品定义。
• 显示实际胜出的资源包。
• 显示来自其他资源包的覆盖变体。
• 递归分析物品模型树。
• 显示最终模型 JSON（如果存在）。
• 显示模型父级链。
• 显示纹理绑定。
• 查找缺失的物品定义、模型和纹理。
• 在资源重新加载后更新，例如按下 F3 + T 后。

对现代物品模型的支持

ModelViewer 可以分析现代物品模型结构，包括：

• model
• condition
• select
• range_dispatch
• composite
• empty
• bundle_selected_item
• special

它还支持现代的 minecraft:custom_model_data 格式：

• floats
• flags
• strings
• colors

当资源包使用复杂条件、不同模型变体或自定义物品数据时，这非常有用。

在 Blockbench 中打开模型

ModelViewer 可以直接在 Blockbench 中打开找到的模型。

如果模型位于常规资源包文件夹中，模组会打开原始的 JSON 文件。

如果模型位于压缩资源包内，模组会创建一个本地工作文件夹，并将所需的模型文件、父级模型和链接纹理复制到其中，以便 Blockbench 能正确打开模型。

这消除了手动在资源包内部搜索文件的需要。

检查器屏幕

在详细的检查器窗口中，你可以看到：

• 物品预览；
• 活跃的 item_model；
• 物品定义路径；
• 胜出的资源包；
• 模型追踪树；
• 最终模型路径；
• 父级链；
• 绑定的纹理；
• 警告和缺失资源。

可用的操作：

• 切换检查目标；
• 复制物品 ID；
• 复制物品路径；
• 复制模型路径；
• 复制元数据；
• 刷新数据；
• 查找模型；
• 在 Blockbench 中打开模型；
• 打开包含该文件的文件夹；
• 解压资源包；
• 检查附近实体；
• 复制可见玩家的 PNG 皮肤。

检查附近实体

模组可以显示附近可被检查的实体和物品。

菜单包含搜索和排序功能：

• 按字母顺序；
• 按距离；
• 按类别。

你还可以打开所选实体或玩家的装备屏幕，检查他们手持或穿戴在护甲槽中的物品。

快捷键

按键	操作
F6	切换检查目标：自动 / 主手 / 副手
F7	打开详细检查器屏幕
F8	切换 HUD 叠加显示的开关
F9	切换自动检查的开关
F10	将简短结果复制到剪贴板

这个模组适合谁？

ModelViewer 对以下人员很有用：

• 资源包制作者；
• 模型作者；
• Blockbench 用户；
• 整合包开发者；
• 使用自定义物品的服务器管理员；
• 修复损坏模型的任何人；
• 任何处理 custom_model_data 的人。

如果你需要了解为什么物品显示错误的模型、哪个资源包覆盖了它，或者所需的 JSON 文件位于何处，这个模组可以大大加快你的工作速度。