Search Results for

    Show / Hide Table of Contents

    坦克火炮、开火与装填

    中文 | English

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

    python Docs/Manual/manual/tools/tutorials.py run tank-fire-settings --capture
    
    点击展开 MCP 操作点击收起 MCP 操作

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

    {
      "variables": {
        "text": "${fixture}/Tutorial_FireVehicleText.asset",
        "shared": "${fixture}/Tutorial_FireSharedGun.asset",
        "bullet": "${fixture}/Tutorial_FireAP.asset"
      },
      "calls": [
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateFolder",
            "args": [
              "${fixtureParent}",
              "${folder}"
            ]
          },
          "expect": {
            "contains": "(String)"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CopyAsset",
            "args": [
              "Packages/com.shanghaiwindy.coreresources/Editor/DocumentationSamples/vehicle-basics/Tutorial_NativeText.asset",
              "${text}"
            ]
          },
          "expect": {
            "contains": "True"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CopyAsset",
            "args": [
              "Packages/com.shanghaiwindy.coreresources/BuiltInVehicles/PatriotRadar/BuiltIn-Patriot-Radar-SharedGun.asset",
              "${shared}"
            ]
          },
          "expect": {
            "contains": "True"
          }
        },
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CopyAsset",
            "args": [
              "Packages/com.shanghaiwindy.coreresources/Editor/DocumentationSamples/vehicle-basics/Tutorial-76mm-AP.asset",
              "${bullet}"
            ]
          },
          "expect": {
            "contains": "True"
          }
        }
      ]
    }
    

    从基础载具做出一辆可试驾的坦克后,用本篇配置主炮和开火表现。炮弹的弹道、穿深和命中特效见炮弹与特效。

    1. 找到主炮实际使用的数据

    1. 在 Project 选中这辆车的 VehicleTextData,打开 开火 页签。
    2. 查看 共享主炮数据(sharedGunData)。引用为空时,编辑当前页签下的主炮参数(TFParameter)。如果已引用 SharedGunData,点该对象槽打开资产,展开它的 tankFireParameter。游戏会优先读取这份共享数据。只调一辆车时,复制共享资产后给这辆车重新绑定。
    3. 在 弹药数组(bulletData)点 +,把第一发试验弹拖到列表第 0 项。将 开火音效(fmodBulletSound)绑定到已有音效资产,将 开火效果(muzzleFire)选为 中 (Muzzle Middle)。
    4. 在主模型里检查 FFPoint 与 EffectStart。将它们放在实际炮口附近,局部 +Z 指向射击方向。先看基础载具的主模型配置,再对照副炮塔各自的发射点。

    主炮的弹种与炮口特效引用

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${text}/sharedGunData",
          "value": "null"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${text}/TFParameter/bulletData/0",
          "value": "@asset:${bullet}"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${text}/TFParameter/bulletData/0/name"
        },
        "expect": {
          "contains": "Tutorial_FireAP"
        }
      }
    ]
    

    2. 设置装填方式和散布

    在火炮参数里先把 开火类型(fireState)设为 标准 (Standard),装弹时间(ReloadTime)填 6 秒,载弹量(AmmoCount)填 30 发。载弹量是该武器的备弹配置。切换模式后,按新模式填装填参数。

    开火类型 需要配置的参数
    标准 (Standard) ReloadTime 为每次标准装填的秒数。hasSlot 会显示 Slot Count 和 Slot Duration,用于需要连发窗口的武器。
    弹夹炮 (Advance) SmallReloadTime、LargeReloadTime、MaxSmallAmmo 分别是夹内装填秒数、长装填秒数和每夹弹数。可用 2 秒、33 秒、4 发练习。
    弹鼓炮 (Drum) drumFire.fireDuration 控制射击间隔,drumFire.reloadTime 是按弹鼓装填阶段填写的秒数列表。先用相同时间验证能逐发补弹,再调各阶段。
    能量武器 (Energy) energyFire 中填写单发消耗(perShotEnergy)、总能量(totalEnergy)、发射间隔(perShotInterval)和特效持续时间(vfxDuration)。

    简单装填模式的时长和总弹量

    在 百米精度 所在的散布区域可见两组参数。最外层 dispersion 用于固定散布,百米统计散布由该数值乘以 100 得到。展开 Spread(fireSpread)配置缩圈模式。教学样例的 aimTime 填 2 秒,dispersion 填 0.35。缩圈逐渐收敛,aimTime 越大,收敛越慢。正的 aimTime 也用来判断这组参数是否已配置。

    moveSpreadCoff、traverseSpreadCoff、gunSpreadCoff、afterFiredCoff 和 damagedCoff 分别控制移动、车体转向、炮管动作、开火和受损的散布影响。先保留已知可用样例的系数,再逐项调整。需要装填时让炮管回到指定角度时,另看定角装填配置。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${text}/TFParameter/fireState",
          "value": "Simple"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${text}/TFParameter/ReloadTime",
          "value": "6"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${text}/TFParameter/ReloadTime"
        },
        "expect": {
          "contains": "6"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${text}/TFParameter/AmmoCount",
          "value": "30"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${text}/TFParameter/AmmoCount"
        },
        "expect": {
          "contains": "30"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${text}/TFParameter/fireSpread/aimTime",
          "value": "2"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${text}/TFParameter/fireSpread/aimTime"
        },
        "expect": {
          "contains": "2"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${text}/TFParameter/fireSpread/dispersion",
          "value": "0.35"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${text}/TFParameter/fireSpread/dispersion"
        },
        "expect": {
          "contains": "0.35"
        }
      }
    ]
    

    3. 在试验场验收

    保存资产,重打包试驾。在平地停稳后,用第 0 项弹药发射一发。检查炮弹从炮口飞出、声音和火焰位置对齐、弹数减一,约 6 秒后可以再次发射。再分别行驶、转动炮塔、停稳开火,用多发比较散布和收敛。切到弹夹模式时,对比夹内短装填和打空后的长装填。

    • 改完没生效时,检查 Shared Gun Data 是否覆盖本地配置,并确认试驾载入的是新包。
    • 能对准但发不出时,检查弹药列表、剩余弹量、装填状态及武器所在的火控组。
    • 炮弹方向正确但火焰位置异常时,先检查 EffectStart。炮口效果用自定义条目时,确认对象池包含 overrideMuzzleFires 中对应的键。

    MCP 配方已在编辑器回读这些参数。下方的试验场调用可以验证弹种和弹道,玩家输入、装填计时和效果观感需要进入游戏验证。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${text}/TFParameter/ReloadTime"
        },
        "expect": {
          "contains": "6"
        }
      }
    ]
    
    点击展开 MCP 操作点击收起 MCP 操作

    运行时未执行。绑定靶场的射手和目标实体 ID。扣弹、装填和特效外观按正文另行检查。

    [
      {
        "tool": "runtime_status",
        "arguments": {}
      },
      {
        "tool": "range_ammo",
        "arguments": {
          "id": "${tankEntityId}"
        }
      },
      {
        "tool": "range_fire",
        "arguments": {
          "shooter": "${tankEntityId}",
          "target": "${targetEntityId}",
          "gun": 0,
          "ammo": "0",
          "mode": "shell"
        }
      }
    ]
    
    In this article
    Back to top Panzer War Document