Search Results for

    Show / Hide Table of Contents

    定角装填配置

    中文 | English

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

    python Docs/Manual/manual/tools/tutorials.py run fixed-angle-reload --capture
    
    点击展开 MCP 操作点击收起 MCP 操作

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

    {
      "variables": {
        "sharedGun": "${fixture}/Tutorial_FixedAngleReload_SharedGunData.asset",
        "vehicle": "${fixture}/Tutorial_FixedAngleReload_VehicleTextData.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-SharedGun.asset",
              "${sharedGun}"
            ]
          },
          "expect": {
            "contains": "True"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CopyAsset",
            "args": [
              "Packages/com.shanghaiwindy.coreresources/BuiltInVehicles/PatriotRadar/BuiltIn-Patriot-Radar_VehicleTextData.asset",
              "${vehicle}"
            ]
          },
          "expect": {
            "contains": "True"
          }
        }
      ]
    }
    

    定角装填使用火控增益 TankFireSpecificAngleReloadBuff。开火或切换弹种后,它可按设定延迟约束炮塔角度、调整转速,并在装填完成后解除约束。

    1. 准备共享火炮参数

    在 Project 窗口选择 Create > A Panzer War - 装甲纷争 > G Ground Vehicle - 地面载具 > Shared Data - 共享数据 > Gun - 炮管,创建 SharedGunData。展开 tankFireParameter,找到增益引用列表 buffRefs。

    本配方复制一个现有火炮配置作为教学样例,保留必要的初始化数据。共享火炮的修改会影响所有引用它的载具;只调整一辆载具时,先创建独立的共享数据副本,或清除该载具的 sharedGunData 后编辑自己的 TFParameter。

    共享火炮中的定角装填 SafeRef 配置

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "static:UnityEditor.Selection/activeObject",
          "value": "@asset:${sharedGun}"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${sharedGun}/tankFireParameter"
        },
        "expect": {
          "contains": "TankFireParameter"
        }
      }
    ]
    

    2. 添加定角装填增益

    在主炮的 Tank Fire Params → Misc Settings → Buffs(buffRefs)点 + 新增一条。打开条目的 Value 类型下拉菜单,选 TankFireSpecificAngleReloadBuff。展开配置并设置下表的教学值:

    字段 教学值与含义
    hasDelay / delay 勾选启用延迟,填写 0.5 秒
    isTraverseLocked 勾选锁定水平旋转
    hasSpecificTraverseAngle / specificTraverseAngle 启用特定水平角度,填写 0 度
    hasSpecificElevationAngle / specificElevationAngle 启用特定垂直角度,填写 5 度
    isOverrideTraverseSpeed / overrideTraverseSpeedCoff 覆盖水平旋转速度,系数填 -0.5,表示降低 50%
    isOverrideElevationSpeed 本例关闭,保持原垂直旋转速度

    各开关决定对应字段是否生效。锁定水平旋转后,炮塔保持指定水平角,或在未指定时保持进入装填状态的水平角。保持水平旋转解锁时,炮塔继续跟随瞄点。俯仰独立使用指定角度或进入状态时的俯仰角。填写后点击该引用项内的 Save,再保存火炮资产。

    当前列表是 AbstractTankFireBuffCasterSafeRef[],旧的 buffs 字段已弃用。MCP 配方会同时写入真实类型和配置 JSON,创建安全引用元素。

    定角装填的水平角度、垂直角度和速度系数

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

    数组 JSON 赋值创建真实 SafeRef,类型名与序列化配置一起写入。本配方验证保存内容;不修改弃用的 buffs。

    [
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${sharedGun}/tankFireParameter/buffRefs",
          "value": "[{\"fullName\":\"ShanghaiWindy.Core.TankFireSpecificAngleReloadBuff\",\"className\":\"ShanghaiWindy.Core.TankFireSpecificAngleReloadBuff, Core\",\"json\":\"{\\\"hasDelay\\\":true,\\\"delay\\\":0.5,\\\"isTraverseLocked\\\":true,\\\"hasSpecificTraverseAngle\\\":true,\\\"specificTraverseAngle\\\":0,\\\"hasSpecificElevationAngle\\\":true,\\\"specificElevationAngle\\\":5,\\\"isOverrideTraverseSpeed\\\":true,\\\"overrideTraverseSpeedCoff\\\":-0.5,\\\"isOverrideElevationSpeed\\\":false}\",\"safeRefAssetProvider\":{\"assets\":[]}}]"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${sharedGun}/tankFireParameter/buffRefs/0/fullName"
        },
        "expect": {
          "contains": "TankFireSpecificAngleReloadBuff"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${sharedGun}/tankFireParameter/buffRefs/0/json"
        },
        "expect": {
          "contains": "\"specificElevationAngle\":5"
        }
      }
    ]
    

    3. 绑定载具

    把共享火炮资产赋给目标 VehicleTextData.sharedGunData。非空时,GetTankFireParam() 读取共享资产的 tankFireParameter;为空时才读取该载具的 TFParameter。

    保存后读回增益配置,确认载具使用了预期资产。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${vehicle}/sharedGunData",
          "value": "@asset:${sharedGun}"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${vehicle}/GetTankFireParam()/buffRefs/0/json"
        },
        "expect": {
          "contains": "\"overrideTraverseSpeedCoff\":-0.5"
        }
      }
    ]
    

    4. 检查

    核对类型、延迟、角度、速度系数和共享引用。运行时代码在装填完成后通过周期检查解除约束;本教程没有进入游戏验证定角过程或恢复效果。

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

    这里验证编辑器配置、共享引用及保存结果。定角、转速和装填完成后的恢复行为仍需游戏内检查。

    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/SaveAssets",
          "args": []
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${sharedGun}/tankFireParameter/buffRefs/0/json"
        },
        "expect": {
          "contains": "\"delay\":0.5"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${vehicle}/sharedGunData/name"
        },
        "expect": {
          "contains": "Tutorial_FixedAngleReload_SharedGunData"
        }
      }
    ]
    
    In this article
    Back to top Panzer War Document