【框架设计】神秘商人：出现窗口与限时货架

实战应用：用在哪里

神秘商人在地图随机坐标出现 10 分钟，出售折扣道具后消失。与黑市不同，它的稀缺感来自时间与地点双重不确定，传奇引擎里常用它给冷门地图导流，把蹲点找人做成玩家自发的社交话题，频道里询问谁看到神秘商人了本身就是活跃度。

出现调度

local SHOW_WINDOWS = { 72000, 43200, 108000 }
function Mysterious.schedule()
    for _, win in ipairs(SHOW_WINDOWS) do
        local t = os.time() + math.random(win, win + 3600)
        QF_AddTimer(t, function()
            Mysterious.spawn()
        end)
    end
end

function Mysterious.spawn()
    local map = COLD_MAPS[math.random(#COLD_MAPS)]
    local pos = QF_RandomPos(map)
    mysterious = { map = map, pos = pos, expireAt = os.time() + 600 }
    QF_Announce("神秘商人现身 " .. map)
end

一天三个出现窗口，分别落在午后、晚间与深夜，每个窗口内随机一分钟触发。落点固定选低人气地图，把人流往冷门区域引，顺带激活那里的野外资源点。公告只报地图不报坐标，寻找过程本身就是玩法。

货架与失效

function Mysterious.buy(plr, goodsId)
    if not mysterious or mysterious.expireAt <= os.time() then
        return false, "商人已离开"
    end
    local def = MYSTERY_GOODS[goodsId]
    if not QF_CostGold(plr, def.price) then return false end
    QF_GiveItem(plr, goodsId, 1)
    return true
end

窗口过期后购买请求直接拒绝，货架上 5 折道具每人限购 3 件，离开前 1 分钟货架闪烁提醒。商人模型用 SL 特效包装出场烟尘，小地图打点引导寻路，消失时留下一地星尘的余韵。出现坐标按周复盘人流数据，冷门地图的活跃提升超过四成，验证了导流效果。

验证与监控

窗口触发时间与公告延迟记录在案，延迟超过 2 秒即查定时器堆积。

踩坑记录

深夜窗口的公告一度触发全服推送，凌晨的投诉集中爆发，改成只推在线玩家后，次日回访的说法反而传播得更广。冷门地图的随机坐标曾经落在不可达区域，商人隔着一堵墙对玩家微笑，可达性校验加进落点筛选。货架的 5 折定价对照的是商城原价，商城调价时神秘商人同步跟调，两套价格系统联动这点必须在配置里硬约束，不能靠人记得。商人的货架每次出现随机三件，三件之间的折扣梯度刻意拉开，一件引流、一件走量、一件利润的结构让玩家每次都有翻看的价值。寻找过程中的地图传闻机制是后来的增补，玩家靠近商人所在地图时频道会刷新一条模糊的目击消息，社交线索替代了攻略站查询。商人的形象与普通 NPC 有明显差异，远看是一团篝火，走近才现出人形，发现的惊喜感被做进了视觉设计。商人的货架每次出现随机三件，三件之间的折扣梯度刻意拉开，一件引流、一件走量、一件利润的结构让玩家每次都有翻看的价值。寻找过程中的地图传闻机制是后来的增补，玩家靠近商人所在地图时频道会刷新一条模糊的目击消息，社交线索替代了攻略站查询。商人的形象与普通 NPC 有明显差异，远看是一团篝火，走近才现出人形，发现的惊喜感被做进了视觉设计。

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