伤害模型命名规则
中文 | English
在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。 命令也会重拍两种语言的配图。
python Docs/Manual/manual/tools/tutorials.py run hitbox-naming-conventions --capture
点击展开 MCP 操作点击收起 MCP 操作
准备教学样例。${变量} 由配方提供。
{
"variables": {
"external": "${fixture}/Tutorial_ExternalSource.prefab",
"internal": "${fixture}/Tutorial_InternalSource.prefab",
"armor": "${fixture}/Tutorial_ImportedArmor.prefab",
"module": "${fixture}/Tutorial_ImportedModule.prefab"
},
"calls": [
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CreateFolder",
"args": [
"${fixtureParent}",
"${folder}"
]
},
"expect": {
"regex": "\\(String\\) [a-f0-9]{32}"
}
}
]
}
伤害模型编辑器会从网格节点名读取装甲和内构参数。以下示例适用于载具的 VehicleHitBox 资源。
1. 准备源模型
把外部装甲和内部模块分别导入 Unity。重命名带网格的节点,再把两个模型分别指定给 ExternalArmorModel 和 InternalModuleModel。生成器只处理带 MeshFilter 的节点。教学配方创建了两个独立源模型。
点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "prefab_edit",
"arguments": {
"json": {
"path": "${external}",
"mode": "create",
"component": "UnityEngine.Transform",
"children": [
"Plate_100",
"Plate_100_Inter",
"Plate_100_React"
]
}
},
"expect": {
"equals": {
"ok": true
}
}
},
{
"tool": "prefab_edit",
"arguments": {
"json": {
"path": "${external}",
"mode": "update",
"component": "UnityEngine.MeshFilter",
"child": "Plate_100",
"references": [
{
"property": "m_Mesh",
"asset": "Packages/com.shanghaiwindy.coreresources/Light/AuthoringSamples/Square.obj",
"type": "UnityEngine.Mesh"
}
]
}
},
"expect": {
"equals": {
"ok": true
}
}
},
{
"tool": "prefab_edit",
"arguments": {
"json": {
"path": "${external}",
"mode": "update",
"component": "UnityEngine.MeshFilter",
"child": "Plate_100_Inter",
"references": [
{
"property": "m_Mesh",
"asset": "Packages/com.shanghaiwindy.coreresources/Light/AuthoringSamples/Square.obj",
"type": "UnityEngine.Mesh"
}
]
}
},
"expect": {
"equals": {
"ok": true
}
}
},
{
"tool": "prefab_edit",
"arguments": {
"json": {
"path": "${external}",
"mode": "update",
"component": "UnityEngine.MeshFilter",
"child": "Plate_100_React",
"references": [
{
"property": "m_Mesh",
"asset": "Packages/com.shanghaiwindy.coreresources/Light/AuthoringSamples/Square.obj",
"type": "UnityEngine.Mesh"
}
]
}
},
"expect": {
"equals": {
"ok": true
}
}
},
{
"tool": "prefab_edit",
"arguments": {
"json": {
"path": "${internal}",
"mode": "create",
"component": "UnityEngine.Transform",
"children": [
"Transmission_120_15"
]
}
},
"expect": {
"equals": {
"ok": true
}
}
},
{
"tool": "prefab_edit",
"arguments": {
"json": {
"path": "${internal}",
"mode": "update",
"component": "UnityEngine.MeshFilter",
"child": "Transmission_120_15",
"references": [
{
"property": "m_Mesh",
"asset": "Packages/com.shanghaiwindy.coreresources/Light/AuthoringSamples/Square.obj",
"type": "UnityEngine.Mesh"
}
]
}
},
"expect": {
"equals": {
"ok": true
}
}
}
]
2. 生成外部装甲
外部名字的第二段必须是整数厚度。名称中包含 Inter 时导入为间隙装甲,包含 React 时导入为反应装甲。
| 节点名 | 装甲类型 | 厚度 |
|---|---|---|
Plate_100 |
普通 | 100 |
Plate_100_Inter |
间隙 | 100 |
Plate_100_React |
反应 | 100 |
在伤害模型编辑器中点「外部装甲模型」。生成后将装甲移动到对应的父节点。需要单独配置反应区块时,见反应装甲。

点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "invoke",
"arguments": {
"path": "static:ShanghaiWindy.Editor.VehicleHitBoxModelImport/ImportPrefab",
"args": [
"${external}",
"${armor}",
"false"
]
},
"expect": {
"regex": "\\(String\\) [a-f0-9]{32}"
}
}
]
3. 生成内部模块
以 Transmission_120_15 为例,三段名称依次对应模块类型、耐久和模块装甲。类型名区分大小写,另外两段按数值读取并向上取整。请填写完整三段。
在伤害模型编辑器中点「内部模块模型」,把生成的内构移到对应父节点。图中的编号对应节点名的三段。

模块类型代码
| 代码 | 说明 |
|---|---|
Transmission |
传动 |
Engine |
引擎 |
HeatSink |
散热器 |
OilTank |
油箱 |
Traversing |
方向机 |
Breech |
炮闩 |
Elevator |
高低机 |
Sighting |
瞄准具 |
AmmoShell |
弹药架 |
Crew |
乘员 |
InternalArmor |
内部装甲 |
Radiator |
雷达(当前 Inspector 标签) |
AutoReloader |
自动装填机 |
OilPipline |
滑油系统 |
SurfaceControlRope |
舵面控制钢索 |
WingSurface |
机翼 |
模块命名示例
示例仅用于说明格式,不代表推荐的数值平衡。
Transmission_120_15:传动部件,生命值 120,装甲 15。AmmoShell_50_15:弹药架部件,生命值 50,装甲 15。若 Blender 因重名自动追加后缀,会得到AmmoShell_50_15.001、AmmoShell_50_15.002这类名称。导入器支持保留这个 Blender 重名后缀。
乘员命名格式
乘员同样以 Crew 作为模块代码,并在末尾写出角色代码;多个角色用下划线分隔:
Crew_{HitPoint}_{ArmorValue}_{RoleCode}
Crew_{HitPoint}_{ArmorValue}_{RoleCode1}_{RoleCode2}
可用的角色代码只有以下五个,必须保持精确拼写与大小写:
Crew_10_0_Commander_Gunner:同时承担指挥官与炮手角色。Crew_10_0_Radioer:通讯员角色。Crew_10_0_Reloader:装填手角色。Blender 重名时会生成Crew_10_0_Reloader.001、Crew_10_0_Reloader.002等后缀名称,后缀不代表角色变化。
乘员角色代码对照表
| 代码 | 说明 |
|---|---|
Commander |
指挥官 |
Driver |
驾驶员 |
Gunner |
炮手 |
Radioer |
通讯员 |
Reloader |
装填手 |
点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "invoke",
"arguments": {
"path": "static:ShanghaiWindy.Editor.VehicleHitBoxModelImport/ImportPrefab",
"args": [
"${internal}",
"${module}",
"true"
]
},
"expect": {
"regex": "\\(String\\) [a-f0-9]{32}"
}
}
]
4. 批量设置内构血量
- 回到 VehicleHitBox,在总体的 HitPoint中设置总基准。原指南和当前 Inspector 使用以下建议值。
- 同类模块需要固定值时,在 Override Module Hit Points 加一项并选择模块类型。未添加覆盖的条目使用下方系数。
- 在伤害模型编辑器中点击自动设置模块血量,选中生成的 InternalModule 核对血量,再按 Ctrl+S 保存。
| 载具等级 | 1–3 | 4–6 | 7–8 | 9–10 | 11–12 | 13–15 |
|---|---|---|---|---|---|---|
| 基准 HP | 50 | 100 | 200 | 300 | 350 | 380 |
旧指南建议基准 HP 不超过 400。下表各列是对应基准 HP 的结果。普通模块按系数乘基准 HP,再按编辑器规则取整,例如 50 × 0.25 在当前 Unity 中得到 12。
| 模块类型 | 系数 | 50 | 100 | 200 | 300 | 350 | 380 |
|---|---|---|---|---|---|---|---|
| Transmission, WheelOrTrack | 0.4 | 20 | 40 | 80 | 120 | 140 | 152 |
| Engine, MainStructure | 0.8 | 40 | 80 | 160 | 240 | 280 | 304 |
| HeatSink, Breech, Barrel, Elevator | 0.25 | 12 | 25 | 50 | 75 | 88 | 95 |
| OilTank, Traversing, AmmoShell, InternalArmor | 0.5 | 25 | 50 | 100 | 150 | 175 | 190 |
| Sighting, Radiator | 0.2 | 10 | 20 | 40 | 60 | 70 | 76 |
| 其他类型(乘员除外) | 1 | 50 | 100 | 200 | 300 | 350 | 380 |
乘员按 Crew Wear Type 取固定值。None 为 10、Vast 为 20、Alien 为 50、Huawei 为 100。
点击展开 MCP 操作点击收起 MCP 操作
验证真实命名解析器、重复后缀和自动血量使用的取整规则。
[
{
"tool": "invoke",
"arguments": {
"path": "static:ShanghaiWindy.Core.AssetBundleManager/LuaEnv/DoString",
"args": [
"local U, C = CS.UnityEngine, CS.ShanghaiWindy.Core\nlocal go = U.GameObject.CreatePrimitive(U.PrimitiveType.Cube)\nlocal ok, failure = pcall(function()\n local sample = go:AddComponent(typeof(C.InternalModule))\n C.VehicleHitBoxImportUtil.SetInternalModuleViaName('AmmoShell_50_15.002', sample)\n assert(sample.moduleType == C.EInternalModuleType.AmmoShell)\n assert(sample.HitPoint == 50 and sample.internalArmor == 15)\n C.VehicleHitBoxImportUtil.SetInternalModuleViaName('Crew_10_0_Commander_Gunner.001', sample)\n assert(sample.moduleType == C.EInternalModuleType.Crew)\n assert(sample.isCommander and sample.isGunner and sample.HitPoint == 10)\n assert(U.Mathf.RoundToInt(50 * 0.25) == 12 and U.Mathf.RoundToInt(350 * 0.25) == 88)\nend)\nU.Object.DestroyImmediate(go)\nassert(ok, failure)\nreturn 'Duplicate names, role flags, and HP rounding verified'\n",
"hitbox-naming-hp",
"null"
]
},
"expect": {
"contains": "Duplicate names, role flags, and HP rounding verified"
}
}
]
5. 保存并核对
保存伤害模型 prefab,检查外部 HitBox 和 InternalModule 的字段。配方在隔离 prefab 中运行相同的导入处理,并核对了表中的三个装甲值,以及传动模块的耐久和装甲。
点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "inspect",
"arguments": {
"path": "asset:${armor}/Plate_100/HitBox/Armor"
},
"expect": {
"contains": "(Int32) 100"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${armor}/Plate_100_Inter/HitBox/Armor"
},
"expect": {
"contains": "(Int32) 100"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${armor}/Plate_100_React/HitBox/Armor"
},
"expect": {
"contains": "(Int32) 100"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${armor}/Plate_100/HitBox/hitBoxType"
},
"expect": {
"contains": "Simple"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${armor}/Plate_100_Inter/HitBox/hitBoxType"
},
"expect": {
"contains": "IntermittentArmor"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${armor}/Plate_100_React/HitBox/hitBoxType"
},
"expect": {
"contains": "ReactiveArmor"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${module}/Transmission_120_15/InternalModule/moduleType"
},
"expect": {
"contains": "Transmission"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${module}/Transmission_120_15/InternalModule/HitPoint"
},
"expect": {
"contains": "(Int32) 120"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${module}/Transmission_120_15/InternalModule/internalArmor"
},
"expect": {
"contains": "(Int32) 15"
}
}
]