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

点击展开 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. 设置生命值与视野
- 在
基础分组下展开基础数据(字段PSParameter)。 - 在
摄像机控制分组中找到血量(PSParameter.Health,图中标记 1)。代码默认值为 1200,本例教学值也填 1200。 - 在
视野分组中找到观察范围(PSParameter.viewRange,图中标记 2)。允许范围是 220–5000,代码默认值为 220,本例教学值填 600。 - 保存资产,再重新选中该资产,确认
PSParameter.Health与PSParameter.viewRange已写入目标资产,而不是其他资产。
PSParameter.Health=1200 和 PSParameter.viewRange=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. 检查
- 确认
AssetName和editorAssetGuid未变,PSParameter.Health与PSParameter.viewRange已写入目标资产。 - Inspector 截图只能证明字段位置与分组,不能证明运行时效果;要确认实际表现,需要在游戏内做一次检查。
- 如果后续需要调整高级参数,先确认上表的显示条件,再去对应分组里寻找字段。
点击展开 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"
}
}
]