坦克火炮、开火与装填
中文 | 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. 找到主炮实际使用的数据
- 在 Project 选中这辆车的 VehicleTextData,打开 开火 页签。
- 查看 共享主炮数据(
sharedGunData)。引用为空时,编辑当前页签下的主炮参数(TFParameter)。如果已引用 SharedGunData,点该对象槽打开资产,展开它的tankFireParameter。游戏会优先读取这份共享数据。只调一辆车时,复制共享资产后给这辆车重新绑定。 - 在 弹药数组(
bulletData)点 +,把第一发试验弹拖到列表第 0 项。将 开火音效(fmodBulletSound)绑定到已有音效资产,将 开火效果(muzzleFire)选为 中 (Muzzle Middle)。 - 在主模型里检查
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"
}
}
]