Search Results for

    Show / Hide Table of Contents

    配置 Lua 实例属性

    中文 | English

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

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

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

    {
      "variables": {
        "script": "${fixture}/Example.lua",
        "prefab": "${fixture}/Tutorial_LuaProperties.prefab"
      },
      "calls": [
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateFolder",
            "args": [
              "${fixtureParent}",
              "${folder}"
            ]
          },
          "expect": {
            "regex": "\\(String\\) [a-f0-9]{32}"
          }
        }
      ]
    }
    

    用脚本的 Property 表声明默认值,再在 prefab 的 LuaBehaviorMono 上设置实例值。以下示例将 multiplier 的脚本默认值保持为 2,只调整 prefab 的值。

    1. 声明数值属性

    保存 Example.lua,让导入器生成行为资产及数值定义。

    Behavior()
    Property = { multiplier = { type = "number", value = 2 } }
    
    local Example = class("Example")
    
    return Example
    
    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.File/WriteAllText",
          "args": [
            "${script}",
            "Behavior()\nProperty = { multiplier = { type = \"number\", value = 2 } }\n\nlocal Example = class(\"Example\")\n\nreturn Example\n"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/ImportAsset",
          "args": [
            "${script}",
            "ForceSynchronousImport"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      }
    ]
    

    2. 同步定义

    将行为资产赋给 LuaBehaviorMono 的「行为脚本」。点「同步变量属性定义」为当前实例补上 multiplier。新条目从脚本读取 2。同步时会保留同名条目的现有值。

    点击展开 MCP 操作点击收起 MCP 操作

    清空列表的步骤仅用于重置教学样例。同步现有 prefab 时保留自己的实例值。

    [
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${prefab}",
            "mode": "create",
            "component": "ShanghaiWindy.Core.Lua.LuaBehaviorMono",
            "references": [
              {
                "property": "luaBehavior",
                "asset": "${script}",
                "type": "ShanghaiWindy.Core.Lua.LuaBehaviorScript"
              }
            ]
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      },
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${prefab}",
            "mode": "update",
            "component": "ShanghaiWindy.Core.Lua.LuaBehaviorMono",
            "values": {
              "instanceLuaProperty": {
                "numberProperties": []
              }
            }
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "asset:${prefab}/LuaBehaviorMono/instanceLuaProperty/OverrideNilPropertyFrom",
          "args": [
            "@asset:${script}/luaProperty"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.PrefabUtility/SavePrefabAsset",
          "args": [
            "@asset:${prefab}"
          ]
        },
        "expect": {
          "contains": "--- GameObject ---"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${prefab}/LuaBehaviorMono/instanceLuaProperty/numberProperties/0/value"
        },
        "expect": {
          "contains": "(Single) 2"
        }
      }
    ]
    

    3. 改实例值

    在「实例属性」下展开数值列表,找到 multiplier,将它的值改为 3.5 并保存 prefab。序列化路径为 instanceLuaProperty.numberProperties。

    脚本引用与实例数值 3.5

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${prefab}",
            "mode": "update",
            "component": "ShanghaiWindy.Core.Lua.LuaBehaviorMono",
            "values": {
              "instanceLuaProperty": {
                "numberProperties": [
                  {
                    "variableName": "multiplier",
                    "value": 3.5
                  }
                ]
              }
            }
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      }
    ]
    

    4. 核对同步结果

    再次同步。确认脚本资产的默认值为 2,当前 prefab 的实例值仍为 3.5。行为初始化时会将实例属性赋给 Lua 类实例。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "asset:${prefab}/LuaBehaviorMono/instanceLuaProperty/OverrideNilPropertyFrom",
          "args": [
            "@asset:${script}/luaProperty"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.PrefabUtility/SavePrefabAsset",
          "args": [
            "@asset:${prefab}"
          ]
        },
        "expect": {
          "contains": "--- GameObject ---"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${prefab}/LuaBehaviorMono/instanceLuaProperty/numberProperties/0/variableName"
        },
        "expect": {
          "contains": "(String) multiplier"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${prefab}/LuaBehaviorMono/instanceLuaProperty/numberProperties/0/value"
        },
        "expect": {
          "contains": "(Single) 3.5"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${script}/luaProperty/numberProperties/0/value"
        },
        "expect": {
          "contains": "(Single) 2"
        }
      }
    ]
    
    In this article
    Back to top Panzer War Document