依据等级一手文件实机
一手文件(编辑器单位字段声明 + 4,856 份官方任务的 props 用量统计);文内单独标出实机结论。
适用:战争雷霆 CDK 任务编辑器(2026-09 新版)。
一句话
在单位操作与创建面板里点开一个单位,看到的那些格子(军队、数量、编队、攻击类型、隐蔽……)就是这里说的面板字段。它们分两层:引擎字段写在单位块根上(名字、位置矩阵、unit_class、weapons、modification…),面板字段统一包在 props{} 子块里(军队、数量、编队、攻击类型、隐蔽…)。面板上能看到哪些格子,由单位类别决定:有一套公共字段(23 个),飞机/直升机/步兵/对象组/编组各自再追加。
两层别写错
| 层 | 写在哪 | 典型字段 |
|---|---|---|
| 引擎字段 | 单位块根上 | name/tm/unit_class/objLayer/weapons/bullets0–3/crewSkillK/applyAllMods/modification/way{} |
| 面板字段 | props{} 子块里 | army/count/attack_type/formation_*/setStealth… |
- 官方 10 万+ 个单位实例全部带
props{},面板字段写在根上的实例一个都没有。 - 写错层=设置不生效(统计+声明面的结论)。「写错层是静默忽略还是报错」没有实测过。
公共字段(每类单位都有,共 23 个;括号=面板默认)
- 阵营/数量:
army(2)、count(1) - 编队四件套:
formation_type(rows)、formation_div(3)、formation_step(2.5,2.0)、formation_noise(0.1,0.1) - 识别:
uniqueName(空)、skin(空)、unitReplacementType(空) - 交战:
attack_type(fire_at_will)、target(空)、targetAir/targetGnd(false)、accuracy(0.9)、effShootingRate(1)、avoidObstacles(true)、targetableByAi(true)、use_search_radar(false) - 隐蔽/延迟:
isDelayed(true)、setStealth(true)、stealthRadius(−1)、calmDetection(false) - 其他:
groupAsOne(false)
官方用得最多的三个:squad_members(149,868 次)、army(87,575)、count(63,765)。
各类别另外追加什么
| 类别 | 追加字段 |
|---|---|
| 飞机 | player、plane{}、numInWing、free_distance、floating_distance、minimum_distance_to_earth、altLimit、canLeaveRouteForAtack、allowAntimissile、fuel、ikPilotModel、ikGunnerModel、aiEnabled、skill、speed |
| 直升机 | free_distance、floating_distance、minimum_distance_to_earth、canLeaveRouteForAtack、allowAntimissile、fuel |
| 步兵 | move_type、usePosAsCover、dontUseCovers、alwaysRun、sensorTimer、distributionRadius |
| 对象组 | active |
| 编组 squad | squad_members、object_type、object_marking(area_squad 只有 squad_members) |
⇒ 「有的字段看不到」多数是类别不对:选了坦克不会有 fuel/skill,步兵才那几个掩体开关;编组类单位连 unit_class 都没有,成员都写在 squad_members 里。
三个坑
- 隐蔽别写
isStealth:界面上有它,官方 4,856 份任务里出现 0 次;写setStealth(4,556 次)。 - 五个旧字段别写:
move_type/zzPeriod/zzAmp/timeOffset/holdFire在字段声明里是被注释掉的,官方语料 0 次,写了行为未验证。 - 面板默认 ≠ 运行时缺省:
isDelayed、setStealth的面板默认是 true——照面板理解"不填就是开"会错;布尔键不写也不等于关。
实机侧两条(2026-10-08)
use_search_radar:开=有雷达的防空单位一直开搜索雷达;关=只有敌机进射程才开机。calmDetection/groupAsOne:两轮实机都看不出任何差别,不建议手写(groupAsOne官方语料本来就是 0 次)。
不确定的部分
- 每个类别的完整字段清单没有逐项整理(只核了公共集与追加集的名字)。要确认某个格子存不存在:在编辑器里选一个该类别单位看面板实际出现哪些栏;或翻该类别字段声明那几行有没有被注释。
- 面板默认值≠运行时真实缺省这件事,只在触发器键上做过机械对差,单位 props 没做。查法:写一份带该键、一份不带的单位,实机对比。
unitReplacementType(3,294 次) 的取值集合与生效条件、groupAsOne(0 次) 的语义,均未核。isStealth未见官方使用,但"写了会怎样"没有实测。
本文同步自知识库「84」· 校验码 1eebea601173 · 同步于 2026-10-10 · 请勿在站内修改,改动请到知识库