Search Results for

    Show / Hide Table of Contents

    模型不显示

    中文 | English

    在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。 命令也会重拍两种语言的配图。

    python Docs/Manual/manual/tools/tutorials.py run model-not-displaying --capture
    
    点击展开 MCP 操作点击收起 MCP 操作

    准备教学样例。${变量} 由配方提供。

    {
      "variables": {
        "asset": "${fixture}/Tutorial_RenderCheck.prefab",
        "material": "${fixture}/Tutorial_RenderCheck.mat"
      },
      "calls": [
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateFolder",
            "args": [
              "${fixtureParent}",
              "${folder}"
            ]
          },
          "expect": {
            "contains": "(String)"
          }
        }
      ]
    }
    

    1. 检查材质 Shader

    在 Project 窗口选中模型使用的材质。在 Inspector 的 Shader 字段检查它是否支持当前渲染管线。模组 SDK 使用 URP。可在模型副本上换用工程里已能显示的 URP 材质,确认是材质问题后,再把贴图和颜色迁到兼容的 Shader。示例读回项目载具材质的 Shader 和本机支持情况。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/CopyAsset",
          "args": [
            "Packages/com.shanghaiwindy.coreresources/BuiltInVehicles/Altius-U/Art/Default-FastProp.mat",
            "${material}"
          ]
        },
        "expect": {
          "contains": "(Boolean) True"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${material}/shader/name"
        },
        "expect": {
          "contains": "WindyVerse/Vehicle/FullPBR"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${material}/shader/isSupported"
        },
        "expect": {
          "contains": "(Boolean) True"
        }
      }
    ]
    

    2. 检查 Renderer 和材质槽

    选中实际负责绘制的子物体,确认 Mesh Renderer 或 Skinned Mesh Renderer 标题上的启用复选框已选中。展开 Materials,检查各槽引用的材质。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${asset}",
            "mode": "create",
            "component": "UnityEngine.MeshRenderer",
            "child": "Hull",
            "children": [
              "Hull"
            ],
            "values": {
              "m_Enabled": true
            },
            "references": [
              {
                "property": "m_Materials.Array.data[0]",
                "asset": "${material}",
                "type": "UnityEngine.Material"
              }
            ]
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/Hull/GetComponent(MeshRenderer)/enabled"
        },
        "expect": {
          "contains": "(Boolean) True"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/Hull/GetComponent(MeshRenderer)/sharedMaterial/shader/name"
        },
        "expect": {
          "contains": "WindyVerse/Vehicle/FullPBR"
        }
      }
    ]
    

    3. 检查相机的 Culling Mask

    记下模型物体顶部的 Layer。选中实际渲染当前视图的 Camera,在 Culling Mask 里确保勾选了该层。示例先排除 Default 层,再把它加回。

    在 Camera 的 Rendering 分组中找到 Culling Mask

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${asset}",
            "mode": "update",
            "component": "UnityEngine.Camera",
            "values": {
              "m_CullingMask": {
                "serializedVersion": 2,
                "m_Bits": 0
              }
            }
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/GetComponent(Camera)/cullingMask"
        },
        "expect": {
          "contains": "(Int32) 0"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/Hull/layer"
        },
        "expect": {
          "contains": "(Int32) 0"
        }
      },
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${asset}",
            "mode": "update",
            "component": "UnityEngine.Camera",
            "values": {
              "m_CullingMask": {
                "serializedVersion": 2,
                "m_Bits": 1
              }
            }
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/GetComponent(Camera)/cullingMask"
        },
        "expect": {
          "contains": "(Int32) 1"
        }
      }
    ]
    

    旧工程的 ShanghaiWindy → Set Rendering LayerMask 是早期工具入口。排查当前工程时,可以从物体的 Layer、实际渲染相机和材质依次缩小范围。若 Scene 视图能看到、游戏相机看不到,优先检查相机遮罩。

    In this article
    Back to top Panzer War Document