Search Results for

    Show / Hide Table of Contents

    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.

    1. Give the secondary weapon three nested model nodes. The example places TutorialSubTurret under Turret, followed by TutorialSubGun and TutorialSubDym.
    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"
        }
      }
    ]
    
    1. Add a MultiFireSystemData entry. Resolve turretPath from the model root, gunPath from the secondary turret, and dymPath from the secondary gun. The example uses Turret/TutorialSubTurret, TutorialSubGun, and TutorialSubDym in that order.
    2. Set ffPointOffSet and effectStartOffSet to 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 under Turret and align its local forward direction with the launch direction.

    The three relative node paths in the legacy turret entry

    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"
        }
      }
    ]
    
    1. 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"
      }
    ]
    
    In this article
    Back to top Panzer War Document