Stop
约 2908 字
前言
Stop 阶段的任务是让车辆避开球周围的停止区域,同时完成站位、后卫布防和盯防,为恢复比赛做好准备。车辆在这一阶段仍然可以执行移动任务。
本文分析 ZBin/lua_scripts/play/Ref/GameStop/ 下的 Stop 脚本,以 opponent/lkh.lua 实际配置的三个 _lkh 版本为主,并介绍同目录中 _new 的老版本战术的区别。
入口与版本
收到 GameStop 裁判消息后,SelectPlay.lua 执行 play/Ref/GameStop.lua,入口脚本只有一句:
gCurrentPlay = gOppoConfig.GameStop具体选哪个 Play,由战术包根据 PLAYER_NUM 决定:
| 车数 | lkh.lua 配置的脚本 | 初始状态 | 非守门员角色顺序 |
|---|---|---|---|
| 6 | Ref_Stop_6vs6_lkh.lua | run | L、A、M、D、S |
| 8 | Ref_Stop_8vs8_lkh.lua | run | L、A、M、D、S、B、R |
| 11 | Ref_Stop_11vs11_lkh.lua | stop | L、A、M、D、S、B、R、C、F、K |
三个版本的守门员都单独执行 task.goalieV3(),不放进 stopTasks。
整体结构:每帧生成任务
Stop 脚本沿用任务表的写法。generateStopTasks() 每帧清空并重建 stopTasks,同时生成 matchStr;状态表中的各个角色通过 stopTask(index) 读取任务。
以 6vs6 的运行状态为例:
["run"] = {
Leader = stopTask(1),
Assister = stopTask(2),
Middle = stopTask(3),
Defender = stopTask(4),
Special = stopTask(5),
Goalie = task.goalieV3(),
match = stopMatch
},任务按以下优先级插入:Leader 站位、Assister 边线站位、两辆后卫、自动下车(仅 11vs11)、盯防、剩余车辆站位。因此,角色名称不一定代表固定任务,例如 11vs11 的 Special 可能执行下车,也可能执行盯防或普通站位。
这里有两套索引:Lua 任务表从 1 开始,Leader 取 stopTasks[1];传给 C++ 模块的站位和威胁序列索引则从 0 开始。
移动参数与站位来源
local STOP_FLAG = bit:_or(flag.slowly, flag.dodge_ball)
local STOP_DSS = bit:_or(
bit:_or(STOP_FLAG, flag.allow_dss),
flag.avoid_stop_ball_circle
)
local ACC = 2000
local STOP_MODE = 1
local getStopPos = function(index)
return function()
return posmoduleV2:getPos(index, STOP_MODE)
end
end普通站位通过 posmoduleV2 的模式 1 获取,Lua 负责指定站位索引,具体坐标由 C++ 模块提供。STOP_DSS 组合了慢速、避球、DSS 和避让停赛球圈的标志,作为 goCmuRush 的参数。
不同任务使用的标志并不完全相同:例如盯防任务显式传入的是 flag.avoid_stop_ball_circle,后卫则直接调用 task.wback,skill 自行会在 C++ 处理 Stop 状态。
Leader:选车并占据第一个站位
三个 _lkh 版本都通过 getSafeStopLeader() 选择 Leader:
- 优先使用
beckham:kickNum()。 - 候选无效或占用了 Goalie、Middle、Defender 时,尝试
messi:leaderNum()。 - 两个候选都不满足要求,则返回
-1,交由[L]实时匹配。
有可用候选时,脚本写入 gRoleNum["Leader"],并使用 {L} 保持车号。Leader 随后前往 getStopPos(0)。
6vs6、8vs8 的 Leader 朝向为 0,即正对敌方半场,11vs11 使用 player.toBallDir 朝向球。三个版本的 Leader 到位后并不旋转,因为要准备好拿球,旋转会影响拿球。
Assister:前往边线站位
Assister 的基础任务是前往 pos.rollpolingPos:
function rollpolingPos()
local side = IS_YELLOW and -1 or 1
return CGeoPoint:new_local(-100, (param.pitchWidth/2-200)*side*-1)
end这个位置的 x 坐标为 -100 mm,y 坐标位于距离一侧边线 200 mm 的位置,所在侧由队伍颜色决定。原文中的“靠近中线 20 cm”并不准确,200 mm 对应的是距边线的距离。
6vs6、8vs8 使用 [A] 实时匹配,也没有为这个任务增加到位旋转。11vs11 则先尝试将 messi:worstNum() 指定为 Assister,即将可能有问题的,如红外故障的车分配给 Assister,让他与敌方的进攻车缠斗:候选通过检查后使用 {A},否则清空车号并使用 [A];其移动任务套用了 wrapWithSpin。
源码中的条件细节
11vs11 的 getSafeStopAssister() 当前包含以下判断:
candidate == leaderNum or candidate == gRoleNum["Leader"] or
candidate == gRoleNum["Goalie"] and
candidate == gRoleNum["Middle"] and
candidate == gRoleNum["Defender"]Lua 中 and 的优先级高于 or。后半段要求候选同时等于三个角色,因此不能把它解释成“分别排除了守门员和两辆后卫”。这是阅读当前脚本时需要留意的角色冲突风险。
后卫:固定保留两辆
不管国赛省赛,我们均使用两辆后卫:
for i = 1, backNum do
local _i = i
table.insert(stopTasks, wrapWithSpin(function()
return task.wback(backNum, _i)
end))
-- 随后追加匹配字符并推进 curindex
end任务对应 Middle、Defender,匹配组为 {MD}。
local _i = i 为每次循环创建局部副本,让延迟执行的任务函数保留各自的后卫序号。盯防车号、剩余站位索引和下车站位索引也采用了类似写法。
自动下车(国赛)
11vs11 在分配后卫后检查是否超过允许上场数量:
if ourMaxRobot ~= -1 and ourMaxRobot ~= 0
and validNum + 1 > ourMaxRobot and ourMaxRobot ~= 11 then
leftFieldNum = validNum - ourMaxRobot + 1
-- 从 messi:LeftFieldCar(i) 读取下车候选
end这里 validNum 来自 vision:getValidNum(),脚本按 validNum + 1 计算包含守门员的数量。符合条件时,从 Messi 的下车序列取候选,并将其绑定到下一个可用角色,前往 pos.leftFieldPos(i)。该移动任务额外使用 flag.need_out_of_field,并套用到位旋转包装。
Leader、Assister、Middle、Defender 会被跳过,以优先保留关键角色。跳过时置 run_once = true,但当前循环不会为这个名额继续搜索一个替代候选,因此算出的 leftFieldNum 不等于本帧一定安排成功的下车数量。
盯防:只在球位于我方半场时分配
盯防数量和目标分别来自:
local enemyNum = defenceSquence:attackerAmount()
-- getAttackerNum(i) 内部调用 defenceSquence:getFreeDefNum(i)实际分配还需要同时满足以下条件:球的 x 坐标小于 0,目标没有离球太近,并且还有可分配的角色。
if not enemy.IsTooClose2Ball(getAttackerNum(i)) then
if ball.posX() < 0 then
local _attackerNum = getAttackerNum(i)
table.insert(stopTasks, wrapWithSpin(function()
return task.wmarking(
"Zero", flag.avoid_stop_ball_circle, _attackerNum
)
end))
-- 随后检查角色上限、追加匹配字符
end
endenemy.IsTooClose2Ball() 在 worldmodel/enemy.lua 中以 2000 mm 为阈值。脚本跳过这类靠近球的对手,把可用盯防名额留给其他潜在接球目标。
这里已经通过第三个参数显式传入目标车号,不能把所有盯防任务都解释成盯住 "Zero" 对应的同一辆车。
三个版本都保留了 ball.posX() > 1000 的分支,但两个分支均设置 defendNum = enemyNum,所以它目前没有改变盯防数量。最终分配量仍受半场条件、目标过滤和角色上限限制。
剩余车辆:补齐普通站位
完成前面的分配后,剩余角色依次前往 getStopPos(1)、getStopPos(2) 等位置。这些任务也套用了 wrapWithSpin。
posNum 在三个版本中分别为 6、8、11,是循环上限,不代表一定分配这么多辆普通站位车。curindex 用于控制剩余角色,最大值分别为 4、6、9;它不包含单独处理的 Leader 和 Goalie。
任务表边界
当前后卫、盯防和普通站位循环,部分上限检查放在 table.insert 之后,因此任务表可能比实际匹配角色多出一项。阅读时要同时看状态表中的 stopTask(index) 和 matchStr,不能仅根据 #stopTasks 判断实际派出了多少辆车。
到位旋转与近球保护
wrapWithSpin() 接受基础任务或生成任务的函数,返回一个根据执行车辆实时判断的任务函数。它先取得基础任务表 t,再从 t[2] 读取目标位置;目标位置是函数时,也会先求值。
旋转条件为:
local arrived = (rpos - mpos):mod() < ARRIVE_DIST
local shouldSpin = arrived and (not ballNearRobot) and (not ballNearTarget)
if shouldSpin then
return task.speed(0, 0, 2.0)
else
return t
endARRIVE_DIST = 150 mm。只有到达目标附近,且球与机器人、球与目标位置的距离都不小于 STOP_BALL_SAFE_DIST = 650 mm 时,才执行零平移速度、角速度为 2.0 的旋转任务。球靠近后会恢复基础任务,让原有避球逻辑继续工作。
因此,Stop 阶段看到车辆原地旋转,是脚本主动安排的行为;球靠近后,也不是直接改为 task.stop()。
6vs6、8vs8 的包装对象是后卫、盯防和剩余站位任务。11vs11 还包装了 Assister 和下车任务。Leader 与守门员没有使用这个包装。
stopTask(index) 需要兼容两种任务形式:
local stopTask = function(index)
return function(runner)
local t = stopTasks[index]
if type(t) == "function" then
return t(runner)
end
return t
end
end传入 runner 后,包装函数才能取得当前执行车辆的位置。任务表每帧重建,与这里每帧判断是否到位,是两个相互配合的过程。
匹配与状态切换
匹配字符串决定角色如何分配车号,任务表决定该角色执行什么任务:
| 括号 | 匹配行为 | Stop 脚本中的用途 |
|---|---|---|
{} | 保持已有匹配,切换 Play 时重新分配 | 指定 Leader、保持两辆后卫;11vs11 还用于指定 Assister 和下车角色 |
() | 状态切换时重新匹配 | 盯防组、剩余站位组 |
[] | 实时匹配 | 没有指定车号的 Leader、Assister |
例如,没有下车任务、没有盯防任务且 Leader 已指定时,11vs11 可以生成 {L}{A}{MD}{}()(SBRCFK)。其中空组来自固定的字符串拼接流程。
6vs6 与 8vs8
两个版本只有 run 状态。全局 switch 先检查 cond.isGameOn(),成立则返回 exit;否则每帧生成任务。遇到 gHaveNoRole 时清除该标志并返回 run,触发一次同名状态切换,使需要在状态切换时匹配的角色重新分配。
每帧更新任务表,并不等于每帧让所有角色重新匹配。
11vs11
11vs11 先进入 stop 状态:非守门员执行 task.stop(),守门员仍执行 goalieV3()。全局 switch 每帧生成任务,并在以下任一条件成立时返回 run:
beckham:KickNumChanged() or run_once or
gRoleNum["Assister"] == gRoleNum["Leader"] or
gRoleNum["Leader"] == -1这些条件分别对应开球车变化、需要重新进入运行状态、角色冲突、Leader 尚未确定。注意最后一个条件是 == -1,旧文档中的 ~= -1 已不符合当前源码。
如果没有先触发上述分支,但出现 gHaveNoRole,则清除标志并返回 stop,重新处理角色匹配。比赛恢复时同样由 cond.isGameOn() 触发 exit,后续通常由脚本选择器切回 NormalPlay。
源码还通过 vision:getCycle() - last_cycle > 5 设置 run_once。但 last_cycle 只在函数末尾更新,提前返回时不会更新,所以不能把它解释为“固定每五帧刷新一次”。
_new 版本的区别
两个 _new 版本也采用任务表,但与当前启用的 _lkh 版本存在以下差异:
| 项目 | _lkh 版本 | 老版本 |
|---|---|---|
| 后卫数 | 固定两辆 | 根据球位、双方车数和威胁数,在一至两辆间调整 |
| 数量稳定机制 | 无动态后卫数量切换 | 候选值持续 120 帧后生效,部分低车数情况立即生效 |
| 后卫与盯防匹配 | 后卫使用 {},盯防使用 () | 使用 [] 实时匹配 |
| Leader 选择 | 安全候选检查,Beckham 不可用时尝试 Messi | 直接检查 Beckham 候选是否有效 |
| 旋转保护 | 检查机器人和目标是否靠近球 | 只检查是否到位,没有 650 mm 近球保护 |
| 守门员 | task.goalieV3() | task.goalie() |
6vs6 的老版本在我方总车数不超过 4 时立即将稳定后卫数设为 1;8vs8 的阈值是不超过 5。其后还有基于剩余车数的数量限制。120 帧对应的实际时间取决于运行帧率。
分析或调整比赛行为前,应先从 gOppoConfig.GameStop 确认正在使用的版本,再检查对应的任务生成、角色匹配和状态跳转。