【引擎触发】beginteleport：传送拦截与区域门禁

实战应用：用在哪里

传送是玩家移动的捷径，也是区域规则的突破口：没有资格的人一张回城卷直飞沙巴克皇宫，副本的门票制度形同虚设。beginteleport 触发在传送起跳前拦截，门禁的裁决在起跳的瞬间完成。

门禁的校验

---beginteleport: 传送前触发 actor:玩家 X,Y:目标坐标
function beginteleport(actor, X, Y)
    local target = Gate.mapOf(X, Y)
    -- 沙巴克皇宫：仅攻城名单内的行会成员可传送进入
    if target == "shabake_palace" then
        local g = getplayvar(actor, 2, "GuildName")
        if not Siege.onRoster(g) then
            sendmsg(actor, 1, "沙巴克皇宫仅限参战行会传送进入")
            mapmove(actor, "shabake", 30, 30, 0)
            return
        end
    end
end

触发带玩家对象与目标坐标，Gate 的映射表把坐标换算成目标地图，皇宫的传送检查攻城名单——不在名单的行会被拦下并拉回沙巴克城门口，起跳前的拦截让越界从未发生。门禁的规则集中在一处：皇宫看攻城资格、副本看门票、血域看令牌，各区域的守门数据各归其位。

副本的票检

---经验副本：门票校验与次数扣减
function Gate.checkTicket(actor, mapId)
    if mapId ~= "exp_dungeon" then return true end
    if not checkitemw(actor, "副本门票", 1) then
        sendmsg(actor, 1, "需要副本门票")
        mapmove(actor, "bingching", 330, 330, 0)
        return false
    end
    takeitem(actor, "副本门票", 1, 0, "进入副本")
    return true
end

副本的传送扣一张门票，票检不过拉回比奇省的安全区。传送的拦截与回拉让门禁的执行不依赖客户端的自觉——改包伪造的传送请求同样过不了这道闸。拦截的次数统计是门禁健康度的直接读数：正常玩家偶尔被拦（忘带门票），高频被拦的账号通常是探测脚本。回拉的目标点按区域配置，皇宫的落点是城门而副本的落点是省份安全区，回拉的体验与门禁的说明一致。

验证与监控

拦截次数按区域分档统计，皇宫的拦截集中在攻城时段为正常；门票的扣减与副本的进入人数对账，差额即为漏票。

踩坑记录

门禁的坐标映射曾经只配了地图入口点，玩家用随机卷轴落在皇宫内部绕过闸口，映射覆盖全区域坐标后无死角。门票的扣减曾经在回拉之后执行，玩家被拉回去了票还被扣，扣票挪到确认放行之后。回拉的落点曾经设在怪物堆里，被拦的玩家一下地就挨围攻，落点统一挪到安全区。

上线要点

区域的门禁规则表集中维护，新区域的准入条件一次登记。拦截的提示文案说明原因与解法（带好门票再来），拒绝要有出路。门禁的日志进风控的样本库，探测型的高频拦截自动进观察名单。

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