【后端接口】walk 与 run：移动触发的轨迹校验与区域感知

实战应用：用在哪里

走路 walk 与跑步 run 触发是玩家移动的行为流：踩点机关、区域感知、速度校验都从这里过。移动触发是全服频率最高的触发，它的每一行代码都以全服的移动总量为成本基数，性能纪律在这里最严。

踩点机关

---跑步触发 actor:玩家 x/y:坐标
function run(actor, x, y)
    -- 踩点检测：活动的地面机关
    local trap = groundTraps[x .. ":" .. y]
    if trap then
        trap:trigger(actor)
    end
    -- 区域进入感知
    local zone = zoneMap:query(x, y)
    if zone and zone ~= actor.lastZone then
        actor.lastZone = zone
        onZoneEnter(actor, zone)
    end
end

踩点检测用坐标键直接查机关字典，O(1) 的查询撑住移动触发的频率。区域感知记录玩家的上一区域，区域变更才触发进入逻辑，同一区域内的重复移动不重复计算。坐标参数是触发自带的位置信息，业务不再额外查询位置。

速度校验

function run(actor, x, y)
    local last = actor.moveRecord
    if last then
        local dist = math.sqrt((x - last.x) ^ 2 + (y - last.y) ^ 2)
        local dt = os.time() - last.t
        if dt > 0 and dist / dt > SPEED_LIMIT then
            QF_AlarmSpeed(actor, dist / dt)
        end
    end
    actor.moveRecord = { x = x, y = y, t = os.time() }
end

速度校验用相邻两次触发的坐标差与时间差算瞬时速度，超限即告警进风控样本。校验的阈值给足容差：合法的坐骑加速与网络抖动的坐标跳跃都要放过，误报率控制在风控可消化的范围。走路与跑步的触发分别注册，跑的频率约是走的两倍，机关的触发设计要明确挂哪个频率。

验证与监控

移动触发的单次耗时以微秒计，任何一次触发的耗时超过 1 毫秒都是性能事故。

踩坑记录

区域感知的查询结构早期用遍历，全服的移动频率乘以遍历成本直接把触发线程打满，空间索引（网格哈希）改造后恢复。速度校验的时间戳曾经用毫秒与秒混用，算出的速度虚高一个量级，全服玩家被误标加速，时间单位的统一是这类触发的第一个检查项。

上线要点

移动触发体禁止数据库操作与网络调用，一切重计算走批量缓冲，触发的轻量纪律是它存在的底线。机关字典与区域索引的构建在启动期完成，运行期只读。坐标的合法性校验（负数、越界）在触发入口做一次，脏数据不进业务逻辑。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。