Search Results for

    Show / Hide Table of Contents

    配置载具材质组件

    中文 | English

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

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

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

    {
      "variables": {
        "material": "${fixture}/Tutorial_Prop.mat",
        "settings": "${fixture}/Tutorial_MaterialSettings.asset",
        "model": "${fixture}/Tutorial_Material.prefab"
      },
      "calls": [
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateFolder",
            "args": [
              "${fixtureParent}",
              "${folder}"
            ]
          },
          "expect": {
            "regex": "\\(String\\) [a-f0-9]{32}"
          }
        }
      ]
    }
    

    下面在客户端 DE 工程中配置透明材质。使用公开 SDK 时,按工程初始化选择 SDK 声明的 Unity 版本。CoreRPMatData 保存材质参数,CoreRPMatComponent 把配置带入载具的资源加载流程。

    1. 准备原材质

    在模型 prefab 中找到目标 Mesh Renderer,确认要覆盖的材质槽。教学配方复制现有桨叶材质为 Tutorial_Prop.mat,把它放入 Tutorial_Material.prefab 的第一个材质槽。实际制作时沿用模型自己的贴图和网格。

    点击展开 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": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${model}",
            "mode": "create",
            "component": "UnityEngine.MeshRenderer",
            "values": {
              "m_Materials": [
                {}
              ]
            },
            "references": [
              {
                "property": "m_Materials.Array.data[0]",
                "asset": "${material}",
                "type": "UnityEngine.Material"
              }
            ]
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      }
    ]
    

    2. 创建材质配置

    在 Project 窗口选择 Create > A Panzer War - 装甲纷争 > C Config - 配置 > SRP Material Config - SRP 材质配置,创建 CoreRPMatData。展开 coreRPMatParams,添加一项并设置:

    1. coreRPShaderType 选 Transparency。
    2. 展开 transparencyMatParam,把颜色的 Alpha 设为 0.35,smoothness 设为 0.4。
    3. 将 linkedMaterial 指向 Mesh Renderer 材质槽实际使用的同一个资产。

    若配置载具涂装,选 VehicleCamouflage。遮罩通过 vehicleCamoflageMatParam 的 hasMask 和 maskTex 传给对应着色器,通道用途以所选着色器为准。

    先在原材质核对基础色贴图 _BaseMap、法线贴图 _BumpMap 和遮罩 _MaskMap。载具涂装默认可沿用原材质的 _MaskMap。要为此配置换遮罩时,再开启 hasMask 并指定 maskTex。可用遮罩预览工具逐通道检查。

    透明材质的类型、颜色、光滑度和材质引用,带编号高亮

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/CreateAsset",
          "args": [
            "@static:UnityEngine.ScriptableObject/CreateInstance(ShanghaiWindy.Core.Data.CoreRPMatData)",
            "${settings}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${settings}/coreRPMatParams",
          "value": "[{\"coreRPShaderType\": 1, \"transparencyMatParam\": {\"color\": {\"r\": 1, \"g\": 1, \"b\": 1, \"a\": 0.35}, \"smoothness\": 0.4}}]"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${settings}/coreRPMatParams/0/linkedMaterial",
          "value": "@asset:${material}"
        },
        "expect": {
          "contains": "OK:"
        }
      }
    ]
    

    3. 挂载组件

    在目标物体上添加 CoreRPMatComponent。保持 isComponentBased 关闭,将 matData 设为刚才创建的 Tutorial_MaterialSettings。这条流程允许多个渲染器复用同一份配置。

    另一种模式是开启 isComponentBased,用 indexCoreRPMatParams 的 index 读取同一物体的 Mesh Renderer 材质槽,从 0 开始计数。更换材质槽顺序时需要同步检查索引。

    索引最终解析成槽位引用的 Material 资产。同次转换里的其他渲染器若共用这份材质,也可能套用配置。只调整一个槽时,先复制材质并把副本分配给该槽,再设置索引。

    组件的共享材质配置,带编号高亮

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${model}",
            "mode": "update",
            "component": "ShanghaiWindy.Core.CoreRPMatComponent",
            "values": {
              "isComponentBased": false
            },
            "references": [
              {
                "property": "matData",
                "asset": "${settings}",
                "type": "ShanghaiWindy.Core.Data.CoreRPMatData"
              }
            ]
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      }
    ]
    

    4. 保存并核对

    保存 prefab,读回 Mesh Renderer 的材质、linkedMaterial 和组件的 matData 引用。资源加载时按源 Material 对象匹配配置,再把参数应用到材质实例。透明度和光滑度的视觉效果需要在载具加载后查看。本例验收了编辑器资产与参数。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/MeshRenderer/sharedMaterials/0/name"
        },
        "expect": {
          "contains": "Tutorial_Prop"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${settings}/coreRPMatParams/0/linkedMaterial/name"
        },
        "expect": {
          "contains": "Tutorial_Prop"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/CoreRPMatComponent/matData/name"
        },
        "expect": {
          "contains": "Tutorial_MaterialSettings"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${settings}/coreRPMatParams/0/transparencyMatParam/color/a"
        },
        "expect": {
          "contains": "0.35"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${settings}/coreRPMatParams/0/transparencyMatParam/smoothness"
        },
        "expect": {
          "contains": "0.4"
        }
      }
    ]
    
    In this article
    Back to top Panzer War Document