坦克炮塔、俯仰和稳定器
中文 | English
在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。 命令也会重拍两种语言的配图。
python Docs/Manual/manual/tools/tutorials.py run tank-turret-settings --capture
点击展开 MCP 操作点击收起 MCP 操作
准备教学样例。${变量} 由配方提供。
{
"variables": {
"text": "${fixture}/Tutorial_TurretVehicleText.asset",
"model": "${fixture}/Tutorial_TurretModel.prefab"
},
"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/Editor/DocumentationSamples/vehicle-basics/Tutorial_NativePackModel.prefab",
"${model}"
]
},
"expect": {
"contains": "True"
}
}
]
}
本篇从基础载具的主炮模型出发。先把炮塔和炮管的支点摆对,再在参数页配置回转、俯仰和稳定器。
1. 整理主炮模型层级
- 在显示模型根节点下建立
Turret → Gun → Dym。把炮塔网格放到Turret下,炮管网格放到Dym下。Turret的支点在座圈旋转中心,Gun的支点在炮管俯仰轴,Dym随炮管执行后坐。 - 检查模型本地 +Z 朝前、+Y 朝上。按主模型绑定放置
FFPoint、EffectStart和炮手相机参考点。手动旋转炮塔、俯仰炮管,确认炮口和参考点都跟随正确部件。 - 生成载具预制体后检查对应部件。生成的载具会把主炮节点命名为
TurretTransform、GunTransform、GunDym。源模型保持Turret/Gun/Dym路径,便于下一次生成。额外炮塔通过多炮塔数据分别绑定。
点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "inspect",
"arguments": {
"path": "asset:${model}/Turret/name"
},
"expect": {
"contains": "Turret"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${model}/Turret/Gun/name"
},
"expect": {
"contains": "Gun"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${model}/Turret/Gun/Dym/name"
},
"expect": {
"contains": "Dym"
}
}
]
2. 设置回转、稳定器和限位
打开 VehicleTextData → 炮塔 页签。未绑定 共享炮塔数据(sharedTurretData)时,编辑 炮塔参数(MTParameter)。绑定共享资产时,点对象槽打开并编辑其 turretParameter。对单车调校可复制一份共享数据。
| 字段 | 教学值和作用 |
|---|---|
maxTurretAngle |
180° 表示左右各 180°。有限位炮塔可以填 45°,得到左右各 45°。 |
isNonSymmetricTurret |
启用后分别设置 maxTurretNegativeAngle 和 maxTurretPositiveAngle,例如 −30° 和 +45°。 |
UpMaxDegree、DownMaxDegree |
教学车填 20°、6°。正常配置中俯角填正数大小,表示向下 6°。 |
turretDegreesPerSecond、gunDegreesPerSecond |
教学车填 18°/s、12°/s,分别对应水平回转和炮管俯仰。 |
offset |
炮塔的水平偏移,正前方定位正确时保持 0°。 |
ffPointAlignType |
配置瞄准对齐参照为炮管根(Gun)或运动炮管(Dym)。首次调校沿用现有配置,再用炮口方向核对。 |

需要避开发动机舱或附件时,展开 特殊的俯角、仰角设置。对称设置为左右镜像的方位范围。需要左右分别处理时,打开非对称范围,再填写相对车身的起止方位和该区间的仰角、俯角。沿方位边界来回瞄准,确认俯仰限制切换符合预期。
垂直稳定器有独立的跟随速度、仰角和俯角,水平稳定器有自己的跟随速度与角度。先验证基础限位,再打开稳定器并在行驶时比较。模块模式下可以用 moduleData.hasOverride 单独覆盖水平和垂直转速。无炮塔战斗室、车体辅助转向及液压悬挂见固定炮架与悬挂专题。
点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${text}/MTParameter/maxTurretAngle",
"value": "180"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${text}/MTParameter/maxTurretAngle"
},
"expect": {
"contains": "180"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${text}/MTParameter/UpMaxDegree",
"value": "20"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${text}/MTParameter/UpMaxDegree"
},
"expect": {
"contains": "20"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${text}/MTParameter/DownMaxDegree",
"value": "6"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${text}/MTParameter/DownMaxDegree"
},
"expect": {
"contains": "6"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${text}/MTParameter/turretDegreesPerSecond",
"value": "18"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${text}/MTParameter/turretDegreesPerSecond"
},
"expect": {
"contains": "18"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${text}/MTParameter/gunDegreesPerSecond",
"value": "12"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${text}/MTParameter/gunDegreesPerSecond"
},
"expect": {
"contains": "12"
}
}
]
3. 试驾并检查炮口
保存并重打包。在平地停稳,将准星移到左右边界,检查短弧炮塔是否在限制处停止。再对比水平和垂直速度,用高低目标检查炮口方向与俯仰极限。打开稳定器后,在颠簸和转弯时重复。最后射击一发,观察炮管后坐、装甲板件和炮口效果跟随。
- 完全不动时,检查主炮层级、有效限位、速度和共享参数。
- 模型旋转但视线偏离时,检查支点轴向、水平偏移和
FFPoint。 - 出现穿模时,核对角度区间并检查伤害模型对应组。调整显示层级后重新生成预制体。
点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "inspect",
"arguments": {
"path": "asset:${text}/MTParameter/maxTurretAngle"
},
"expect": {
"contains": "180"
}
}
]
点击展开 MCP 操作点击收起 MCP 操作
运行时未执行。先用实体 ID 查询组件列表,再填写 VehicleInitSystem 的索引。读回有效参数后,按正文观察旋转和炮口。
[
{
"tool": "runtime_status",
"arguments": {}
},
{
"tool": "inspect",
"arguments": {
"path": "entity/${tankEntityId}"
}
},
{
"tool": "inspect",
"arguments": {
"path": "entity/${tankEntityId}/${vehicleComponentIndex}/CurMainTurretParam"
}
}
]