FreeKick
约 1789 字
前言
FreeKick 是我方任意球脚本。Beckham 提供开球车、接球车、传球点和踢球参数;Lua 根据这些信息生成开球前后两套任务,负责站位、后卫和后续进攻。
本文分析 ZBin/lua_scripts/play/Ref/FreeKick/ 下、opponent/lkh.lua 实际选择的三个 _lkh 版本。敌方任意球见 FreeKickDef。
入口与版本
DIRECT KICK 与 INDIRECT KICK
在21年以前的 RobocupSSL 国际赛,规则里面是有直接任意球和间接任意球这一区分的,我们需要根据不同的指令编写不同的任意球。但是很多学校,包括我们,为了简化代码,将直接任意球也作为间接任意球处理,这样就不用思考区分任意球的问题了。
但是21年的时候,RobocupSSL 的组委会为了吸引更多学校参与,尝试简化流程,因此将间接任意球删去,此后所有犯规后的任意球、界外球、球门球、角球,统一都是 Direct FreeKick,可以一脚直接得分,不再要求“第二下触碰”。
不过国内这方面响应比较晚,一直到去年(2025),Mark 才提出修改规则,顺应 RobocupSSL 国际赛的规则,我们国内这才取消间接任意球相关的判罚。
在 Mark 2025 年修改规则后,今年(2026)国赛那边,朱笑笑和上交也同步修改了规则,使用国际赛的规则。
规则虽然改了,但是我们的代码倒是没改,毕竟也没什么影响,大家只需要明白这里的 Indirect ,其实就是 FreeKick ,且为 Direct Free Kick 。
当前 OurIndirectKick.lua 直接执行:
gCurrentPlay = gOppoConfig.FreeKick
gOurIndirectTable.lastRefCycle = vision:getCycle()因此,这篇分析按当前任意球入口和配置展开。
| 车数 | 脚本 | 常规后卫数 | 开球前 Leader 任务 | 后续射门任务 |
|---|---|---|---|---|
| 6 | Ref_FreeKick_6vs6_lkh.lua | 2,少车时可减为 1 | touchKickV3 | zAttackv2 |
| 8 | Ref_FreeKick_8vs8_lkh.lua | 2 | touchKickV2 | CrosseroverV2 |
| 11 | Ref_FreeKick_11vs11_lkh.lua | 2 | touchKickV2 | CrosseroverV2 |
三个版本的守门员均执行 task.goalieV3()。同目录中的无 _lkh 版本没有被当前战术包选择。
状态
脚本包含 stop 和 run 两个状态,初始状态为 stop。全局 switch 在正常执行时每帧生成两套任务,然后返回 run:
generatePreAttackTasks() -- 开球前的 attackPreTasks、prematchStr
generateAttackTasks() -- 开球后的 attackTasks、matchStr
messi:setuseFreeRec(true)
return "run"真正决定使用哪一套任务的是 beckham:leaderKicked():
local attackTask = function(index)
return function()
if beckham:leaderKicked() then
return attackTasks[index]
else
return attackPreTasks[index]
end
end
endattackMatch() 同样选择对应的匹配字符串。所以“开球前”和“开球后”并不是两个 Lua 状态,而是 run 状态内两套任务表的切换。
全局 switch 每帧返回 run,会触发同名状态切换;状态只要返回就会触发match的()重新计算,不管名字有没有改。
Beckham 提供什么
| 接口 | Lua 中的用途 |
|---|---|
kickNum() | 确定开球 Leader |
get_passPos() | 传球目标 |
flatPassVel()、chipPassVel() | 平传、挑传参数 |
isChip() | 选择传球方式 |
get_kickBall() | 6vs6 传给 touchKickV3 的踢球控制参数 |
firstrecvNum()、secondrecvNum() | 两辆接球车候选 |
get_waitPos(index) | 接球及等待位置 |
nextKicker() | 决定后续哪辆车执行进攻任务 |
leaderKicked() | 选择开球前后任务表 |
judgeExitState() | 任意球战术的主要退出判断 |
Lua 中 getPassPos() 等函数返回闭包,使任务在执行时继续读取 Beckham 的信息,而非固定值。
开球前:Leader、后卫、接球车和剩余站位
Leader 与踢球参数
Beckham 的候选有效,且不等于 Middle、Defender、Assister、Goalie 时,脚本写入 Leader 车号并使用 {L};否则触发保底,使用 [L] 实时匹配一辆车过来。
6vs6 的实际任务为:
task.touchKickV3(
getPassPos(), true, needKick(), isChip(),
getFlatPassVel(), getChipPassVel(), 0.018, iflag
)国赛调用的是 touchKickV2,V2 是老的开球,因为先打的国赛后打的省赛,国赛的 TouchKickV2 就没换。
TouchKickV2 是我们从 rocos_nbt 迁移过来的 skill ,但是迁移过来后发现存在二次触球等问题,所以省赛时候开了个 V3 修一下,虽然没修好但是凑合能用。
后卫数量
默认插入两辆 wback 后卫,并通过 {} 保持对应角色。6vs6 额外执行:
if ball.posX() > -1000 and cond.validNum() < 4 then
backNum = 1
end
if cond.validNum() < 3 then
backNum = 1
end这里 cond.validNum()是除了守门员之外场上我方有几辆车。
指定接球车
当接球候选有效,且 ball.posX() >= -param.pitchLength/8 时,第一、第二接球车分别绑定为 Assister、Special,并前往等待位置 0、1。任务使用 DSS_FLAG + flag.free_kick。
球在更深的后场时,不进入这两个显式接球车分支,其余角色仍由后面的普通站位循环分配。两辆候选也分别检查,不能假设它们一定同时有效。
剩余站位和匹配
其余车辆通过 getFreeKickPos(i) 前往等待点。play_cycle < 3 时使用 [] 实时匹配,之后改用 {} 保持匹配。若相邻执行帧的间隔超过 6,脚本会把 play_cycle 归零,重新进行早期匹配过程。
6vs6 的 DSS_FLAG 是 dodge_ball + allow_dss;8、11 车版则是 dodge_ball + min_dss。
等待点的合法性与回退
三个版本都对 beckham:get_waitPos(index) 做了保护:
- 索引先取整,负数归零,其他值按 6 取模,映射到 0 至 5。
- 检查位置及坐标存在,并排除绝对值超过 90000 或超过所设场地长宽范围的坐标。
- 当前点不合法时尝试等待点 0,再不合法则返回
(-param.pitchLength/4, 0)。
这能避开明显的无效坐标,但这里使用的是 param.pitchLength、param.pitchWidth,并非场地半长、半宽,不能据此声称所有返回点都经过严格的场内检查。多个索引归一化或回退后,也可能得到同一个位置。
开球后:选择下一辆进攻车
generateAttackTasks() 根据 nextKicker() 分配后续任务:如果第一或第二接球车等于下一踢球车,则执行射向 pos.theirGoal 的进攻任务;否则继续在等待位置站位。剩余车辆循环也会比较 getPlayerNum(i) 与 nextKicker()。
6vs6 使用 zAttackv2,8、11 车版使用 CrosseroverV2,传入的射门力度常量均为 6000。
退出条件与当前实现的限制
三个版本首先检查 beckham:judgeExitState(),成立则清零 play_cycle 并返回 exit。6vs6 还在此后检查 player.kickBall("Leader"),成立也立即退出。
任务索引需要按源码核对
以下是当前脚本中的实际不一致,并非预期战术设计:
- 6vs6 的
generateAttackTasks()从后卫任务开始插入,没有为 Leader 预留第 1 项,但状态表仍由 Leader 读取attackTask(1)。选择开球后任务表时,角色与任务可能错位。 - 11vs11 的状态表中,Special 与 Breaker 都读取
attackTask(5),Receiver 读取第 6 项,第 7 项没有直接对应的角色。 - 11vs11 开球后
subStr在 S 后又包含 L,而matchStr前面已经添加 Leader,可能产生重复的 L 匹配字符。 - 接球车是否有效、后卫数和球位都会改变插入数量;固定的
attackTask(index)、getPlayerNum(i)与动态匹配字符需要一起检查,不能只看其中一张表判断谁在执行射门。