Configure legacy multiple turrets
中文 | English
Run this command at the repository root to replay the examples through the local Unity MCP. The command also captures screenshots in both languages.
python Docs/Manual/manual/tools/tutorials.py run multi-turret-legacy --capture
Click to expand MCP actionsClick to collapse MCP actions
Prepare the teaching sample. The recipe provides ${variables}.
{
"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)"
}
}
]
}
Existing vehicles can keep using VehicleTextData → Old Multi-Turret. For new configurations, see New Multi-Turret in the same Inspector.
- Give the secondary weapon three nested model nodes. The example places
TutorialSubTurretunderTurret, followed byTutorialSubGunandTutorialSubDym.
Click to expand MCP actionsClick to collapse MCP actions
[
{
"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"
}
}
]
- Add a
MultiFireSystemDataentry. ResolveturretPathfrom the model root,gunPathfrom the secondary turret, anddymPathfrom the secondary gun. The example usesTurret/TutorialSubTurret,TutorialSubGun, andTutorialSubDymin that order. - Set
ffPointOffSetandeffectStartOffSetto distances from the barrel origin along local +Z. The sample uses 2.5 and 1.25. Configure ammunition, reload and sound along with traverse and elevation parameters, or assign shared gun and turret assets. For a turret-mounted anti-tank missile, put the launcher underTurretand align its local forward direction with the launch direction.

Click to expand MCP actionsClick to collapse MCP actions
[
{
"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"
}
}
]
- Pack VehicleData again. Check FFPoint and EffectStart in the resulting prefab, then test firing in game.
Click to expand MCP actionsClick to collapse MCP actions
[
{
"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"
}
]