Search Results for

    Show / Hide Table of Contents

    VehicleTextData 使用说明

    中文 | English

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

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

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

    {
      "variables": {
        "asset": "${fixture}/Tutorial_VehicleTextData.asset",
        "sharedGun": "${fixture}/Tutorial_SharedGunData.asset",
        "vehicleData": "${fixture}/Tutorial_VehicleData.asset"
      },
      "calls": [
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateFolder",
            "args": [
              "${fixtureParent}",
              "${folder}"
            ]
          },
          "expect": {
            "regex": "\\(String\\) [a-f0-9]{32}"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CopyAsset",
            "args": [
              "Packages/com.shanghaiwindy.coreresources/BuiltInVehicles/PatriotRadar/BuiltIn-Patriot-Radar_VehicleTextData.asset",
              "${asset}"
            ]
          },
          "expect": {
            "contains": "True"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CopyAsset",
            "args": [
              "Packages/com.shanghaiwindy.coreresources/BuiltInVehicles/PatriotRadar/BuiltIn-Patriot-Radar-SharedGun.asset",
              "${sharedGun}"
            ]
          },
          "expect": {
            "contains": "True"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/AssetPathToGUID",
            "args": [
              "${asset}"
            ]
          },
          "capture": {
            "editorGuid": {
              "regex": "\\(String\\) ([a-f0-9]{32})"
            }
          }
        },
        {
          "tool": "inspect_set",
          "arguments": {
            "path": "asset:${asset}/AssetName",
            "value": "TutorialTank"
          },
          "expect": {
            "contains": "OK:"
          }
        },
        {
          "tool": "inspect_set",
          "arguments": {
            "path": "asset:${asset}/editorAssetGuid",
            "value": "${editorGuid}"
          },
          "expect": {
            "contains": "OK:"
          }
        },
        {
          "tool": "inspect_set",
          "arguments": {
            "path": "asset:${asset}/sharedGunData",
            "value": "@asset:${sharedGun}"
          },
          "expect": {
            "contains": "OK:"
          }
        },
        {
          "tool": "inspect_set",
          "arguments": {
            "path": "asset:${sharedGun}/tankFireParameter/fireSpread/aimTime",
            "value": "2"
          },
          "expect": {
            "contains": "OK:"
          }
        },
        {
          "tool": "inspect_set",
          "arguments": {
            "path": "asset:${sharedGun}/tankFireParameter/fireSpread/dispersion",
            "value": "0.35"
          },
          "expect": {
            "contains": "OK:"
          }
        }
      ]
    }
    

    VehicleTextData 是载具配置的 ScriptableObject。本页只讲在 Unity Inspector 中选中资产、找到字段、填写值并核对结果。

    1. 选择资产

    1. 在 Project 窗口选中主类型为 VehicleTextData 的 .asset。创建菜单位置为 A Panzer War - 装甲纷争/G Ground Vehicle - 地面载具/Base - 载具配置/Vehicle Configuration - 载具配置参数。如果新建资产,将它赋给目标 VehicleData 的 vehicleTextData 引用。下文图片使用独立教学样例 Tutorial_VehicleTextData;在你的工程里请选择实际要制作的载具资产。
    2. 确认 AssetName 和 editorAssetGuid 属于目标载具;两者都是只读的资产标识字段,不能在此编辑。
    3. editorAssetGuid 是 Unity 制作资产的 GUID,不是队列使用的 vehicleGuid。队列载具 ID 由 VehicleInfo.GetLoadGUID() 返回,两者含义不同,不要互相代填。

    选中教学资产,核对默认名称和资产唯一 ID

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

    CreateAsset 对应新建资产;inspect_set 的对象引用赋值对应拖放到引用槽。以下把新建的配置赋给独立的 VehicleData;只读字段仅查询。

    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/CreateAsset",
          "args": [
            "@static:UnityEngine.ScriptableObject/CreateInstance(ShanghaiWindy.Core.VehicleTextData)",
            "${fixture}/Tutorial_NewVehicleTextData.asset"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/CreateAsset",
          "args": [
            "@static:UnityEngine.ScriptableObject/CreateInstance(ShanghaiWindy.Core.VehicleData)",
            "${vehicleData}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${vehicleData}/vehicleTextData",
          "value": "@asset:${asset}"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "static:UnityEditor.Selection/activeObject",
          "value": "@asset:${asset}"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/AssetName"
        },
        "expect": {
          "contains": "TutorialTank"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/editorAssetGuid"
        },
        "expect": {
          "contains": "${editorGuid}"
        }
      }
    ]
    

    2. 设置生命值与视野

    1. 在 基础 分组下展开 基础数据(字段 PSParameter)。
    2. 在 摄像机控制 分组中找到 血量(PSParameter.Health,图中标记 1)。代码默认值为 1200,本例教学值也填 1200。
    3. 在 视野 分组中找到 观察范围(PSParameter.viewRange,图中标记 2)。允许范围是 220–5000,代码默认值为 220,本例教学值填 600。
    4. 保存资产,再重新选中该资产,确认 PSParameter.Health 与 PSParameter.viewRange 已写入目标资产,而不是其他资产。

    PSParameter.Health=1200 和 PSParameter.viewRange=600 只是教学取值,不是官方平衡建议。

    展开基础数据,填写血量 1200 和观察范围 600

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

    路径使用真实代码字段名,不受编辑器语言影响。资产字段写入会保存;随后重新选择并读回断言。

    [
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${asset}/PSParameter/Health",
          "value": "1200"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${asset}/PSParameter/viewRange",
          "value": "600"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/SaveAssets",
          "args": []
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "static:UnityEditor.Selection/activeObject",
          "value": "null"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "static:UnityEditor.Selection/activeObject",
          "value": "@asset:${asset}"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/PSParameter/Health"
        },
        "expect": {
          "contains": "1200"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/PSParameter/viewRange"
        },
        "expect": {
          "contains": "600"
        }
      }
    ]
    

    3. 高级参数

    点击对应的 移动、开火、炮塔 或 多炮塔 标签页,再按下表寻找字段;杂项 位于标签页下方。

    字段 Inspector 分组与含义 显示条件与读取行为
    sharedGunData 共享主炮数据(开火) 始终显示;非空时 GetTankFireParam() 返回其中的 tankFireParameter。
    TFParameter 主炮参数(开火) 仅当没有 sharedGunData 时显示;此时 GetTankFireParam() 返回它。
    sharedTurretData 共享炮塔数据(炮塔) 始终显示;非空时 GetTurretParam() 返回其中的 turretParameter。
    MTParameter 炮塔参数(炮塔) 仅当没有 sharedTurretData 时显示;此时 GetTurretParam() 返回它。
    PTCParameter 履带参数(移动) 仅在 GetGroundType() 返回 TrackController(IsTrackController() 为真)时显示。
    MechParameter 机甲参数(移动) 勾选 isMech 选择机甲控制器,可设置达到最大转向所需时间、步行特效和飞行参数。
    CarControllerParameter 汽车参数(移动) 旧数据字段仍可见,当前的 GetGroundType() 不读取它。轮式载具使用车轮设置指南的现行路径。
    MultiFireSystemData 旧版多炮塔系统(弃用) 旧版多炮塔列表,新载具不要新增。
    simpleVehicleFireSystemParameters 新版多炮塔系统 当前多炮塔配置列表,元素类型为 SimpleVehicleFireSystemParameter。
    vehicleSelfExplosionParams 自爆数据(杂项) 元素类型为 VehicleSelfExplosionTextParameter 的数组,按数组元素填写。

    PTCParameter 的显示由 GetGroundType() 的判定顺序决定:isStationary → Stationary,MechParameter.isMech → MechController,LuaVehicleControllerParameter.isLua → Lua,ShipControllerParameter.isShip → Ship,其余情况才返回 TrackController。因此只把模型做成履带车,并不保证该字段出现。

    sharedGunData 和 sharedTurretData 是共享引用:多个载具指向同一资产时,修改会影响所有引用者;没有共享引用时才分别使用 TFParameter 或 MTParameter。教学样例保留了 sharedGunData 引用,所以该样例中 TFParameter 不显示;这对只练习生命值与视野的步骤没有影响。

    配置移动、开火、炮塔与自爆

    • 履带车在 移动中设置动力、前进和倒车速度,绑定 TankWheelCollider 与 Track Data,再配置悬挂。车轮 · 履带悬挂
    • 在 开火中选择炮弹、弹药容量、装填时间和开火音效。初速在所选炮弹资产中设置,主炮参数另有后坐比例与散布。当多辆车使用同一门炮时,可把这组参数放在共享主炮资产。
    • 在 炮塔中设置回转范围、炮管升降速度、最大仰角和俯角。新副武器在 多炮塔页通过 simpleVehicleFireSystemParameters 设置节点和独立开火参数。维护旧载具时,参阅旧版多炮塔的模型路径和偏移。
    • 配置游戏内自爆时,在 杂项的 vehicleSelfExplosionParams 增加一项,选择模型中的 explosionPath,再绑定 explosionParam.explosionData 对应的 SelfExplodeBullet。范围与伤害由该资源提供,触发方式由脚本决定。
    点击展开 MCP 操作点击收起 MCP 操作

    MCP 可按路径查询高级参数和显示条件,等价于定位数据。截图窗口目前不能自动选择 Odin 标签页;若新增教程需要标签页截图,应由 Codex 补该能力后再重拍。这里不改高级参数。

    [
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/sharedGunData"
        },
        "expect": {
          "contains": "SharedGunData"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/noSharedGunData"
        },
        "expect": {
          "contains": "False"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/noSharedTurretData"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "asset:${asset}/GetTankFireParam",
          "args": []
        },
        "expect": {
          "contains": "TankFireParameter"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "asset:${asset}/GetTurretParam",
          "args": []
        },
        "expect": {
          "contains": "TurretParameter"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "asset:${asset}/GetGroundType",
          "args": []
        },
        "expect": {
          "contains": "TrackController"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/PTCParameter"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/MultiFireSystemData"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/simpleVehicleFireSystemParameters"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/vehicleSelfExplosionParams"
        }
      },
      {
        "expect": {
          "contains": "(Single)"
        },
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/MechParameter/timeToFullyTurn"
        }
      },
      {
        "expect": {
          "contains": "(Boolean)"
        },
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/CarControllerParameter/isCar"
        }
      },
      {
        "expect": {
          "regex": "Count=|\\(VehicleSelfExplosionTextParameter"
        },
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/vehicleSelfExplosionParams"
        }
      }
    ]
    

    4. 检查

    1. 确认 AssetName 和 editorAssetGuid 未变,PSParameter.Health 与 PSParameter.viewRange 已写入目标资产。
    2. Inspector 截图只能证明字段位置与分组,不能证明运行时效果;要确认实际表现,需要在游戏内做一次检查。
    3. 如果后续需要调整高级参数,先确认上表的显示条件,再去对应分组里寻找字段。
    点击展开 MCP 操作点击收起 MCP 操作

    本配方验收资产绑定、标识和保存后的字段。教学样例没有完整可驾驶模型,未进行游戏内效果验证;截图成功不会记为运行时通过。

    [
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${vehicleData}/vehicleTextData/name"
        },
        "expect": {
          "contains": "Tutorial_VehicleTextData"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/AssetName"
        },
        "expect": {
          "contains": "TutorialTank"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/editorAssetGuid"
        },
        "expect": {
          "contains": "${editorGuid}"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/PSParameter/Health"
        },
        "expect": {
          "contains": "1200"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${asset}/PSParameter/viewRange"
        },
        "expect": {
          "contains": "600"
        }
      }
    ]
    
    In this article
    Back to top Panzer War Document