【进阶实战】渡口摆渡：跨河渡船的班次设计封装

业务场景

两岸资源点隔河相望：绕路要大半张地图，摆渡全靠临时铺路。渡口摆渡封装：渡口 NPC 按固定班次开船（每 15 分钟一班、航程 90 秒），玩家登船后自动渡往白日门对岸；载客上限 20 人，满员即开不等人——班次制让摆渡成为可预期的公共运力。

核心实现

登船登记。示例代码如下：

local CAP = 20
local function boardFerry(actor, waiting)
    if #waiting >= CAP then
        sendmsg(actor, 1, "本班已满，15 分钟后下一班。")
        return
    end
    waiting[#waiting + 1] = actor
    sendmsg(actor, 1, "已登船，当前 " .. #waiting .. "/" .. CAP .. " 人。")
end

开航结算。示例代码如下：

local function sailFerry(waiting)
    for _, actor in ipairs(waiting) do
        beginteleport(actor, 120, 88)
    end
    for i = #waiting, 1, -1 do
        table.remove(waiting)
    end
end

接口拆解

班次由定时器驱动（每 900 秒一班、航程 90 秒），boardFerry 查名单人数（上限 20）登记登船；sailFerry 开航时对名单逐个 beginteleport 到对岸坐标（120,88），随后倒序清空名单等待下一班——满员即开与到点即开双规则并行；登船名单是场景状态，内存表即可（重启清空重新排队）。

踩坑记录

渡口摆渡踩过三个坑：一是登船后玩家下线，开航 teleport 对失效对象报错，开航前逐个校验对象有效性、失效者跳过；二是船上玩家被 PK 拉扯出名单但人还在船上，登船后进入航程保护（不可攻击、不可被攻击）；三是班次时刻与攻城战重叠，摆渡沦为攻城运兵车，攻城期间渡口停航、提前 30 分钟发布公告。