依据等级一手文件
一手文件(编辑器自己的任务属性字段定义 + 官方任务模板)+ 已有条目(无限弹药、在线任务与单人任务、Save Project 与 Save Mission、改了配置不生效)。
本篇里凡标注「未实测 / 没结论」的部分,回答时照实说不确定,不要替我们补答案。
适用:2026-09 新版 CDK 任务编辑器。
一句话
任务属性面板里的字段被分成了十来个分组,每个分组都带默认值——新建任务后你只要管三处:任务类型、用哪张地图、A 队玩家单位;多人任务再把 B 队补上。其余分组不碰也能跑。
面板里有哪些分组、各管什么
(分组名照编辑器里的英文写,方便对照;括号里是它在定义文件里的内部名,面板上不一定显示)
顶层分组
| 分组 | 管什么 | 能不能空 |
|---|---|---|
player(面板上显示成 player_teamA) | A 队玩家槽位:wing=玩家要开的单位列表(容量上限 32),army=队伍编号(默认 1) | 单人 / 多人都要填 |
player_teamB | B 队玩家槽位,内容和 A 队一样(列表上限 33,army 默认 2) | 单人任务不用填 |
atmosphere | 大气两项:气压(默认 760)、气温(默认 15) | 可空 |
spectator_points / cover_points | 观战点 / 掩体点,各是一串区域(每项最多 50 个) | 可空 |
briefing | 任务开头的简报 / 过场:地名、日期、目标文字、音乐、分镜(图片、地图箭头、图标、占领区、战区) | 可空,音乐默认 action_01 |
aiParams | AI 效能两项(默认 90、[2500, 7000]) | 可空 |
units_include | 从外部文件引入单位定义 | ⚠️ 别碰,见「常见坑」 |
mission 这一组里面(任务本体,最常用):
| 子分组 | 管什么 |
|---|---|
(mission 直属的几项) | locName / locDesc 任务名与简介、type 任务类型、level 用哪张地图 |
Game type params | 玩法开关:记分、占点、单排、合作、自由混战、竞速、足球、最后生还者、对抗(多数默认关,只有记分 / 占点 / 单排 / 分数 / 对抗默认开) |
Common params | isLimitedFuel 燃油限制、isLimitedAmmo 弹药限制(两个都默认不勾=无限)、openDiffLevels(默认开) |
Versus params | 对抗用:分数上限(默认 5000)、时间上限(默认 20)、死亡扣分、重生次数(默认 -1=不限)、重生时间倍率、allowedUnitTypes 允许参战的载具类别白名单(飞机 / 坦克 / 舰船 / 直升机,四项默认都不勾) |
Singleplayer params | 单人用:战役名(默认 UserMissions)、重试方式 restoreType(默认 attempts)、难度(默认 arcade)、燃油量、是否可选起飞、locationName、unlockGUID、教学对象文件 |
Weather params | 时间与天气:environment(默认 Day,选项含 Evening/Day/Morning/Night/Dusk/Dawn/Noon 以及 7~18)、weather(默认 good,含 clear/good/cloudy/rain/thunder 等 12 项)、stars 组(纬度 48、经度 44、年 1940、月 1、日 15、当地时间 10,可填 0.1~24)、customWeather(手调云与大气散射,几十项)、风向风速三项 |
Race params / Football params | 竞速 / 足球模式专用 |
Other params | forceNoRespawnsByMission、allowWinch(默认开)、物理预测 / 平滑 / 精确碰撞三个开关、tags |
哪些有默认值、不填也能跑
- 每个字段都带默认值,而且分组是折叠的——面板看着空,不等于没这个设置(
Common params就是典型,默认挂着看不见,见《怎么做无限弹药》)。 - 官方那份「只有槽位、没有逻辑」的最小可运行骨架里,任务属性只写了四块:
player、player_teamB、mission(level/type/restoreType/optionalTakeOff/environment/weather)、spectator_points,其余全是空壳。这就是「能跑起来」的最低门槛。 - 想省事,就只填这三处:
type(任务类型)→level(用哪张图)→player → wing(玩家开什么)。
单人任务 vs 多人任务:必填项不一样
| 单人任务 | 多人(在线)任务 | |
|---|---|---|
type | singleMission(这就是默认值) | domination 等多人类型 |
A 队 player → wing | 填具体载具 | 填 dummy_plane 占位,不能填具体载具 |
B 队 player_teamB | 不用填 | 必须填(两队都要有玩家槽位) |
| 重生点 | 可以不要 | 必须有(用 missionMarkAsRespawnPoint 标) |
| 地图 | 自己改过的图也能用 | 只能用原版地图 |
最反直觉的一处:两边的玩家槽位写法是反着的——单人任务里填 dummy_plane 玩家进不去,多人任务里填具体载具玩家也进不去。
顺带一句:「人数」不是面板上一个数字,而是你往 player / player_teamB 的 wing 里塞多少个玩家槽位单位(编辑器给这两栏的容量上限分别是 32 / 33,出自一手文件)。
常见坑
- 改完不生效,先查编辑器读的是哪一份配置。 CDK 用哪份配置不由 exe 放在哪决定,而由工作区文件里的
application_path决定;启动日志会写明using %appDir=。一台电脑装两份 CDK(本体一份、备份一份)时最容易撞上:你改的是新的,生效的是旧的。改完必须重启编辑器。 - 存任务点
Save Mission,不是Save Project。 后者存的是关卡工程,任务文件一个字节都不会变。症状:重开进了一张不是你的图、任务 blk 里搜不到units。 units_include别碰。 它本意是「从外部文件引入单位定义」,但里面的filename为空时,任务在 WT Live 上按 URL 加载会弹「加载的任务包含无效数据:Wrong units include:」并退回房间列表——编辑器里不报错,只有进游戏才炸。官方全量任务里这一块只出现过 1 次,而且也是空的。看到任务 blk 里有它、filename还是空,整段删掉。level不选就是一张水图。 它的默认值是levels/water.bin,不挑地图直接存任务,打开来就是水。- 别去手调
customWeather。 里面是几十项云、大气散射与风的渲染参数(mie2_*、rayleigh_*、clouds_*…),日常只需要environment+weather两个下拉就够。另外allowedUnitTypes的四项默认全是不勾,不勾会怎样素材里没有实测结论,要用之前先自己试一次。 - 给玩家看的栏位可以写中文(
locName、locDesc这类),给引擎读的名字(单位 class、地图名、预设名)必须英文。
依据
- 编辑器自己的任务属性字段定义文件(
missions\mission_settings.scheme.nut,2026-09 新版):上面所有分组名、字段默认值、可选项与容量上限都出自这里; - 官方任务模板里的最小骨架(
base_logic_template_empty_squads):它的任务属性段只有player/player_teamB/mission/spectator_points四块; - 已有条目:《怎么做无限弹药(isLimitedAmmo)》《在线(多人)任务和单人任务有什么区别》《Save Project 与 Save Mission 不是一回事》《改了配置不生效——编辑器读的是「哪一份」》。
相关
- 任务文件与地图文件的关系(任务管「事」、地图管「地」)
- 从零做一张自定义任务的完整流程(目录页)
- 单位 / 物件的 class 名怎么查
本文同步自知识库「68」· 校验码 4f8a9fca457e · 同步于 2026-10-10 · 请勿在站内修改,改动请到知识库