旧版多炮塔配置
中文 | English
在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。 命令也会重拍两种语言的配图。
python Docs/Manual/manual/tools/tutorials.py run multi-turret-legacy --capture
点击展开 MCP 操作点击收起 MCP 操作
准备教学样例。${变量} 由配方提供。
{
"variables": {
"source": "Packages/com.shanghaiwindy.coreresources/BuiltInVehicles/PatriotRadar/BuiltIn-Patriot-Radar",
"vehicleData": "${fixture}/Tutorial_NativeVehicleData.asset",
"vehicleText": "${fixture}/Tutorial_NativeText.asset",
"vehicleInfo": "${fixture}/Tutorial_NativeVehicleInfo.asset",
"packModel": "${fixture}/Tutorial_NativePackModel.prefab",
"vehicleName": "Docs-Legacy-Turret-${runId}",
"vehicleGuid": "205563420ee989807e2${runId}",
"cooked": "${fixture}/205563420ee989807e2${runId}_pre.prefab"
},
"calls": [
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CreateFolder",
"args": [
"${fixtureParent}",
"${folder}"
]
},
"expect": {
"contains": "(String)"
}
}
]
}
现有载具可以继续使用 VehicleTextData → 旧版多炮塔系统。新配置可先查看同一 Inspector 中的新版多炮塔系统。
- 在模型中为副炮准备三层节点。示例中
TutorialSubTurret位于主炮塔Turret下,再依次嵌套TutorialSubGun、TutorialSubDym。
点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CopyAsset",
"args": [
"${source}_Model.prefab",
"${packModel}"
]
},
"expect": {
"contains": "(Boolean) True"
}
},
{
"tool": "prefab_edit",
"arguments": {
"json": {
"path": "${packModel}",
"mode": "update",
"component": "UnityEngine.Transform",
"children": [
"Turret/TutorialSubTurret/TutorialSubGun/TutorialSubDym"
],
"child": "Turret/TutorialSubTurret/TutorialSubGun/TutorialSubDym"
}
},
"expect": {
"equals": {
"ok": true
}
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${packModel}/Turret/TutorialSubTurret/TutorialSubGun/TutorialSubDym/name"
},
"expect": {
"contains": "TutorialSubDym"
}
}
]
- 在
MultiFireSystemData添加一项。turretPath从模型根节点开始,gunPath从副炮塔开始,dymPath从副炮开始。示例依次填Turret/TutorialSubTurret、TutorialSubGun、TutorialSubDym。 - 将
ffPointOffSet和effectStartOffSet设为从炮管原点沿局部 +Z 的距离。教学样例分别填 2.5 和 1.25。为该项配置弹种、装填、射击音效,以及炮塔回转、俯仰速度和角度,也可绑定共享火炮和炮塔参数。以主炮塔上的反坦克导弹为例,发射模型放在Turret下,确保其局部前方与发射方向一致。

点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CopyAsset",
"args": [
"${source}_VehicleData.asset",
"${vehicleData}"
]
},
"expect": {
"contains": "(Boolean) True"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CopyAsset",
"args": [
"${source}_VehicleTextData.asset",
"${vehicleText}"
]
},
"expect": {
"contains": "(Boolean) True"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CopyAsset",
"args": [
"${source}.asset",
"${vehicleInfo}"
]
},
"expect": {
"contains": "(Boolean) True"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${vehicleText}/AssetName",
"value": "${vehicleName}"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${vehicleInfo}/vehicleName",
"value": "${vehicleName}"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${vehicleInfo}/assetGuid",
"value": "${vehicleGuid}"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${vehicleInfo}/cookedDirectory",
"value": "${fixture}"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${vehicleData}/vehicleTextData",
"value": "@asset:${vehicleText}"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${vehicleData}/modelData/MainModel",
"value": "@asset:${packModel}"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${vehicleData}/cookedLocation",
"value": "NextToData"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEngine.JsonUtility/FromJsonOverwrite",
"args": [
"{\"MultiFireSystemData\": [{\"turretPath\": \"Turret/TutorialSubTurret\", \"gunPath\": \"TutorialSubGun\", \"dymPath\": \"TutorialSubDym\", \"isTurretWrapper\": true, \"ffPointOffSet\": 2.5, \"effectStartOffSet\": 1.25}]}",
"@asset:${vehicleText}"
]
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${vehicleText}/MultiFireSystemData/0/sharedGunData",
"value": "@asset:${vehicleText}/sharedGunData"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${vehicleText}/MultiFireSystemData/0/sharedTurretData",
"value": "@asset:${vehicleText}/sharedTurretData"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.EditorUtility/SetDirty",
"args": [
"@asset:${vehicleText}"
]
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/SaveAssets",
"args": []
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${vehicleText}/MultiFireSystemData/0/turretPath"
},
"expect": {
"contains": "Turret/TutorialSubTurret"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${vehicleText}/MultiFireSystemData/0/gunPath"
},
"expect": {
"contains": "TutorialSubGun"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${vehicleText}/MultiFireSystemData/0/dymPath"
},
"expect": {
"contains": "TutorialSubDym"
}
}
]
- 在 VehicleData 重新打包。检查生成预制体的 FFPoint 和 EffectStart,再进游戏试射。
点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "invoke",
"arguments": {
"path": "static:ShanghaiWindy.Core.PackUtil/Pack",
"args": [
"@asset:${vehicleData}"
]
},
"expect": {
"contains": "OK:"
},
"phase": "build"
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${cooked}/VehicleComponentsReferenceManager/mutiTurretTrans/0/ffPoint/name"
},
"expect": {
"contains": "(String) FFPoint"
},
"phase": "build"
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${cooked}/VehicleComponentsReferenceManager/mutiTurretTrans/0/ffPoint/localPosition"
},
"expect": {
"contains": "(Vector3) (0.00, 0.00, 2.50)"
},
"phase": "build"
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${cooked}/VehicleComponentsReferenceManager/mutiTurretTrans/0/fireEffectPoint/localPosition"
},
"expect": {
"contains": "(Vector3) (0.00, 0.00, 1.25)"
},
"phase": "build"
}
]