【引擎触发】传送戒指：定向传送与冷却消耗设计

实战应用：用在哪里

传送戒指让玩家免跑图：右键点击指定坐标直接传送，是打金与跑任务的神器。996 引擎里传送走地图跳转触发，传送戒指在其上加了目标校验、冷却与耐久消耗三层限制，防止破坏地图封闭性设计。

传送触发

-- QFunction 右键使用特戒触发
function QF.RingTeleport(plr, mapId, x, y)
    if plr:InBattle() then return false, "战斗中不可传送" end
    if not plr:CooldownReady("ring_tp") then
        return false, "冷却剩余 " .. plr:CooldownLeft("ring_tp") .. " 秒"
    end
    if not plr:TakeGold(2000) then return false, "需要 2000 金币" end
    plr:SetCooldown("ring_tp", 30)
    plr:MapMove(mapId, x, y)
    release_print("ring_tp " .. plr.name .. " -> " .. mapId)
    return true
end

plr:InBattle 拦截战斗态传送，冷却 30 秒挂独立键位管理，单次消耗 2000 金币作为经济回收口。plr:MapMove 是引擎的地图跳转接口，带目标坐标直达落点，传送日志用 release_print 打到 M2 控制台便于排查玩家反馈的坐标异常。

目的地校验

local FORBIDDEN = { shabake = true, palace = true }
function QF.CheckTeleportTarget(plr, mapId)
    if FORBIDDEN[mapId] then return false, "该地图禁止传送进入" end
    local needLevel = MAP_ENTER_LEVEL[mapId] or 0
    if plr.level < needLevel then return false, "等级不足" end
    return true
end

沙巴克战场与皇宫禁传，等级门槛地图校验准入等级，校验函数放在跳转之前执行。传送戒指的耐久每次扣 1 点，修理铺修理恢复，耐久归零戒指失效，特戒的维护成本也是经济设计的一部分。客户端传送确认框列出目的地与消耗，确认按钮用 GUI:addOnClickEvent 绑定发送指令。

验证与监控

传送日志按地图聚合，禁传地图出现传送记录即为越权跳转，立刻告警排查。

踩坑记录

曾经有玩家卡进未开放地图，根因是客户端伪造地图参数，服务器当时只信客户端传参没做白名单校验，补上 FORBIDDEN 与开放开关双重校验后堵住。冷却的实现早期放在客户端，重登即清零，服务端冷却键位才是唯一可信的计时器。

上线要点

传送落点的安全校验会避开怪群中心：目标坐标两格内有 hostile 单位时自动偏移到最近的安全格，防止玩家花钱传送进怪堆送死。冷却键位独立于药品与技能的冷却体系，互不挤占。传送戒指的价格定位在轻奢档：买得起是门槛，用得起是消耗，两千金币一次的定价让便捷始终有成本。

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