依据等级一手文件实机
一手文件(编辑器单位字段声明 + 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
编组 squadsquad_members、object_type、object_marking(area_squad 只有 squad_members)

⇒ 「有的字段看不到」多数是类别不对:选了坦克不会有 fuel/skill,步兵才那几个掩体开关;编组类单位连 unit_class 都没有,成员都写在 squad_members 里。

三个坑

  1. 隐蔽别写 isStealth:界面上有它,官方 4,856 份任务里出现 0 次;写 setStealth(4,556 次)。
  2. 五个旧字段别写:move_type/zzPeriod/zzAmp/timeOffset/holdFire 在字段声明里是被注释掉的,官方语料 0 次,写了行为未验证。
  3. 面板默认 ≠ 运行时缺省: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 · 请勿在站内修改,改动请到知识库