【后端接口】messagebox：服务端弹窗与交互确认

实战应用：用在哪里

脚本里的关键提示不该被聊天框刷走：等级不足无法求购、摆摊需要 50 级、删除好友的确认——messagebox 让服务端脚本直接弹出一个需要玩家确认的对话框，重要信息用重要的方式呈现。

弹窗的调用

---messagebox: 服务端弹窗的交互确认
---actor:玩家对象 text:弹窗内容
function Confirm.show(actor, text)
    -- 内容的长度限制：弹窗最多 100 字
    if #text > 100 then
        text = text:sub(1, 100) .. '...'
    end
    messagebox(actor, text)
end

---业务的使用：求购的等级门槛
function QiuGou.gate(actor)
    if getbaseinfo(actor, 6) < 50 then
        Confirm.show(actor, '角色等级小于 50 级，无法发起求购')
        return false
    end
    return true
end

messagebox 的调用带玩家对象与内容：弹窗的文案最长 100 字，超长的截断加省略号——弹窗是提醒不是文章，重要的内容放前半段。弹窗的触发场景挑重要的时刻：规则的门槛拦截、危险的二次确认、关键的流程指引，日常的小提示走聊天框不打扰。弹窗的按钮默认只有确认，需要选择的场景走选项对话框——弹窗与选项对话框的分工按交互的复杂度划分。

使用的纪律

---弹窗的频控：防止弹窗的轰炸
local lastBox = {}
function Confirm.throttled(actor, text)
    local now = os.time()
    if now - (lastBox[actor] or 0) < 5 then
        -- 5 秒内不重复弹窗，改为聊天提示
        sendmsg(actor, 1, text)
        return
    end
    lastBox[actor] = now
    messagebox(actor, text)
end

弹窗的频控防轰炸：同一玩家 5 秒内只弹一次，连续触发的场景降级为聊天提示——弹窗的价值在于稀有，滥用的弹窗让玩家练成无脑点掉的手。弹窗的文案写具体的动作指引：不说「操作失败」，说「需要 50 级并持有求购券」，指路的弹窗比拦截的弹窗更受欢迎。弹窗与聊天的分工：弹窗需要玩家确认知晓，聊天是信息的流水，两者的选择按「是否必须看到」划分。

验证与监控

弹窗的触发量与频控的拦截量监控，弹窗的高频玩家提示其操作流程有问题；弹窗文案的长度分布审计，超长文案的排版在低端机上的表现纳入验收。

踩坑记录

弹窗的文案曾经包含内部术语（错误码、表名），玩家看不懂也截不了图反馈，文案的玩家语言化改造。频控的计数曾经不清理，长在线的玩家收到过期的频控拦截，计数按时间窗滚动。弹窗曾经在全屏加载时触发，加载遮罩盖住弹窗导致无响应的假象，弹窗的时机避开加载期。

上线要点

弹窗的模板集中管理：文案的措辞、按钮的文案、出现的时机三要素统一。弹窗的触发场景清单进设计文档：哪些用弹窗、哪些用聊天、哪些用跑马灯，呈现的分级有章法。弹窗的关闭必须友好：默认按钮是引导下一步的动作，而不是简单的「知道了」。