占点模式配置
中文 | English
在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。
python Docs/Manual/manual/tools/tutorials.py run capture-mode-config
占点模式配置描述占点战斗使用的区域、占领点、每个区域的出生点以及区域连通关系。它是一份 CaptureZoneModeConfig JSON,存放在配置根目录下,出包时被打包成二进制配置数据。
1. 准备地图场景
- 先完成 设置 Steam 游戏资源路径,让编辑器能读取游戏侧的
LuaProject资源。 - DIY 地图按 导入 DIY 地图 把 YAML 导入基础场景;官方或其他非 DIY 地图只需在编辑器中打开对应场景。
- 编辑时保持场景打开。点位放置和 刷新位置 (NavMesh) 按钮会采样当前场景的 NavMesh,所以地图必须已经烘焙好寻路数据。
2. 创建配置
- 打开 Framework - 框架 → 2. Config - 配置文件。
- 在创建表单中选择 配置文件(Config Path)。下拉列表来自框架设置中保存的配置路径,这个值同时决定配置会出现在哪个目录树里。
- 配置类型选择 CaptureZoneModeConfig。
- 填写 文件名称 并点击 创建(Create Config)。文件名为空只会弹出错误提示,所以要先填好。文件名不需要扩展名。
- 工具会写入
<配置根目录>/CaptureZone/<名称>.json,并在内部生成一个新的 GUID。不要从其他文件复制 GUID。
创建出的对象包含以下字段,用途各不相同:
| 字段 | 用途 |
|---|---|
captureZoneName |
内部标识。请使用独特且唯一的 ID,不要与其他配置重复。 |
displayName |
面向玩家的本地化显示名称。 |
mapGuid |
地图的运行时标识。普通地图用 MapData 的 GUID,DIY 地图用 Defined Name。 |
backgroundCameraTransformInfo |
可选的地图背景视角相机位置与旋转。 |
编辑器菜单树会把文件显示为 <配置路径目录>/CaptureZone/<文件名>,选中它即可打开该文件的占点编辑器。
3. 设置地图 GUID 与背景相机
- 在区域编辑器中,地图 Guid 一行显示当前值(为空时显示
—)。点击 使用当前场景 可从当前场景可发现的地图数据中填入 GUID。 - 普通地图核对写入值与 MapData 的 GUID 一致。DIY 地图填写导入 YAML 中的 Defined Name(
definedName)原值,保留空格和标点。游戏按这个名称注册 DIY 地图。 - 背景相机是可选的。把 Scene 视图调整到想要的构图后点击 设置背景相机,会保存该相机的位置与旋转。模式不需要背景视角时保持为零即可。
4. 添加占领区域
- 点击编辑面板或场景浮层上的 + 新区域。新区域会添加在当前场景视图指向的位置,
pointName为占位值(Zone_<n>),半径默认为 30。 - 点击区域标签选中它,然后填写:
pointName—— 必须唯一。区域连通关系按这个字符串解析区域,改名后要同步更新连通项。- 位置 与 范围 —— 占领点位置和占领圈半径。
- 初始队伍拥有者 —— 初始归属队伍,中立则选
none。
- 用选中区域的 +Pt / -Pt 构建边界。
zonePoints是定义区域范围的边界多边形,它与占领点的位置、半径是两套独立数据。边界点应放在可行走地面,并用 刷新位置 (NavMesh) 和 合并附近点 吸附、整理。 - 按同样方式添加其余区域。小型地图通常 2-3 个区域就够,不必为了填满数组硬加区域。
5. 添加每个区域的出生点
- 选中区域后点击 显示出生点(旧版本按钮名为 Edit),再点 + 添加出生点标记。
- 会出现带编号的标记。点击标记选中该出生点,用场景手柄移动或旋转它。数值保存在该区域的
spawnTransformInfos中,也可以在序列化字段里直接编辑。 - 请选用清晰可驾驶的位姿:位于地面或其附近、朝向符合设计方向、不要卡进墙体、道具或其他载具。刷新位置 (NavMesh) 会把出生点吸附到寻路网格并清零俯仰与翻滚,但仍需人工确认视角。
- 完成后点击 隐藏出生点,让场景视图更清爽。
6. 添加区域连通关系
- 在
zoneChains中添加条目,A 与 B 填写与区域一致的pointName字符串。 - 只连接地图设计真正允许相连的相邻区域。运行时
CaptureZoneGameMode.Setup.cs会把fromZone作为toZone的前置相邻区域,所以每条记录是有方向的。只有地图设计确实允许双向通行时,才补上反方向条目。 - 检查所有连接:名称必须能解析到已有区域。解析失败的名称在运行时会被直接跳过,编辑器也不会为它绘制连线,所以拼写错误只会让连接静默消失。
7. 保存、打包与测试
- 保存配置。
- 在地图模组的构建管线中,把保存的占点 JSON 加到 Config file。选择目标平台并构建模组包。管线会把 JSON 转换为配置数据并随
.modpack交付。地图场景仍由地图构建流程提供。 - 本地只导出配置时,可用 打包所有配置(Pack All Configs)。它重建
Build/Config,占点配置输出到Build/Config/capturezone/<配置 GUID>.bytes。 - 安装刚构建的模组,在目标地图运行一次占点战斗。核对占领区、出生点与区域推进顺序。
本例给 Tutorial Town 配置 Depot 和 Ridge 两个区域,连通方向为 Depot 到 Ridge。回放生成并核对本地 .bytes 文件。
点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "invoke",
"arguments": {
"path": "static:ShanghaiWindy.Core.AssetBundleManager/LuaEnv/DoString",
"args": [
"return assert(loadfile(\"../../Docs/Manual/tutorials/capture-mode-config/example.lua\"))()",
"docs-capture",
"null"
]
},
"expect": {
"contains": "Capture mode JSON and .bytes export verified"
}
}
]