【进阶实战】石墓阵巡检：配表驱动的精英补位刷新器

业务场景

石墓阵里 6 个精英点位驻着白野猪王，被清掉后要按周期补位。散装写法把地图、坐标、怪物名硬编码在脚本里，开新区要复制一份改一遍，坐标错一个全服找不到怪。工程化做法：点位收敛成一条配置串，巡检器只认表——新增点位改配置不动代码，接 genmon 完成补位。

核心实现

配置串格式"地图|X|Y|怪物|范围|数量"，分号分隔点位，启动时一次解析成巡检表。示例代码如下：

local PATROL_CFG = "D2117|82|170|白野猪王|5|2;D2117|120|95|白野猪王|5|2;D2118|40|40|沃玛卫士|4|3"
local PatrolTbl = {}
local function loadPatrol()
    PatrolTbl = {}
    for map, x, y, mon, range, num in
        string.gmatch(PATROL_CFG, "([%w]+)|(%d+)|(%d+)|([^|;]+)|(%d+)|(%d+)") do
        PatrolTbl[#PatrolTbl + 1] = {
            map = map, x = tonumber(x), y = tonumber(y),
            mon = mon, range = tonumber(range), num = tonumber(num),
        }
    end
    if #PatrolTbl == 0 then
        sendmsg(nil, 1, "巡检配表解析为空，请检查配置串。")
    end
end

巡检执行挂在全局定时器上：setontimerex(77, 300) 每 300 秒触发一次，QF 侧按 ontimerex77() 命名响应。示例代码如下：

local function patrolTick()
    for _, p in ipairs(PatrolTbl) do
        genmon(p.map, p.x, p.y, p.mon, p.range, p.num, 0)
    end
end
local function ontimerex77()
    patrolTick()
end

本篇的新技术点是解析后必校验空表：配置串错一个分隔符，表解析为空，巡检器静默空转三个月没人发现——空表告警写在解析函数里，不写在信任里。

接口拆解

genmon(mapid, X, Y, monname, range, count, color)：按地图坐标与范围刷怪，count 是数量，color 传 0 为普通外观。setontimerex(id, tick)：全局定时器，tick 是间隔秒数；setofftimerex(id) 移除。string.gmatch 按模式迭代子串，[%w]+ 匹配地图编号，[^|;]+ 匹配怪物名（含汉字）。送配上线前用 hasenvirtimer 可判全局定时器是否在跑，防止重复挂载。

踩坑记录

巡检器踩过三个坑：一是模式里怪物名用了 %w+，汉字全部匹配失败，表解析为空，含中文的字段必须用 [^分隔符]+ 这类取反式匹配；二是巡检没设存量上限，补位与玩家击杀赛跑，卡在怪刷新的瞬间服务重启，同一点位叠出 40 只白野猪王，点位表要配 count 上限并在补位前核对；三是全局定时器 ID 撞车，活动脚本也用了 77 号，两个巡检互相覆盖，定时器 ID 要全服统一登记分配。