【后端接口】openmerchantbigdlg：商人对话框的引擎接口

实战应用：用在哪里

openmerchantbigdlg 是商人对话的大窗口接口：支持自定义尺寸、按钮布局与窗口拖动，比基础的 say 对话强了一个量级。商店、任务交付、活动入口的复杂 NPC 界面全走这个接口。

接口签名与打开

---打开商人大窗 path:脚本路径 pos:位置 x/y:坐标 height/width:尺寸 isShowBtn:按钮 closeX/Y:关闭坐标 isMove:可拖动
function openmerchantbigdlg(path, pos, x, y, height, width, isShowBtn, closeX, closeY, isMove) end

-- 打开军需官的大窗商店
function openQuartermaster(actor)
    openmerchantbigdlg("QuestVendor", 1, 300, 200, 400, 600, 1, 450, 60, 1)
end

窗口的尺寸与位置参数化：高度 400 宽度 600 的布局适配大多数对话内容，isShowBtn 控制底部按钮组，isMove 允许拖动避免遮挡战斗视野。窗口的内容按脚本路径加载，商人NPC的货单与对话在脚本里组织。

与导航的联动

---窗口内按钮的导航跳转
function navigation(actor, NPCIdx, BtnIdx, sMsg)
    sendmsg(actor, 1, sMsg)
    callscript(actor, "QuestVendor", "page" .. BtnIdx)
end

窗口内按钮的点击经 navigation 跳转到脚本的对应段落，多页的商品与任务在同一个窗口内翻页。窗口的关闭回调释放 NPC 的引用，防止关闭后的残留交互。大窗的贴图与配色按 NPC 的身份定制，军需官的军绿与药师的暖棕，NPC 的辨识度靠视觉的差异化。

验证与监控

大窗的打开次数与停留时长埋点，窗口的交互频次反映 NPC 功能的使用率。

踩坑记录

窗口的尺寸曾经在小分辨率下溢出屏幕，尺寸的自适应缩放按分辨率计算。关闭坐标的误配曾让关闭按钮落在窗口外，关闭点的坐标与窗口边界绑定校验。

上线要点

大窗的布局模板固化为可复用的参数组，新 NPC 的窗口配置从模板复制。窗口内的按钮数量上限 8 个，超出的功能进二级页。NPC 界面的打开与关闭日志进交互统计，使用率的数据决定界面的迭代优先级。窗口的拖动记忆位置的功能是商人类 NPC 的增值体验，重复打开时恢复上次的坐标。

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