课时 17 · 新三端引擎全景与文档导航

本课目标

理解服务端/客户端双体系，学会查文档。

知识讲解

996 新三端引擎的 Lua 脚本分两大体系。服务端：全局函数式，由引擎在特定时机调用全局函数（触发），脚本内调用全局函数完成操作（接口）。客户端：SL:/GUI: 命名空间，SL: 处理事件注册、元变量等全局能力，GUI: 处理窗口控件创建与操作。

本地文档结构（showdoc 导出，260831 版本）：服务端目录下分「触发」与「接口」两大类，触发 295 个 md 分 17 目录（玩家 112、英雄-宠物 84、行会组队 22、系统 13、怪物、PVP 等），接口 701 个 md 分 25 目录（人物相关 172、物品操作 91、系统 50、地图相关 41 等）；客户端目录下分「游戏」「界面相关」「窗口」「元变量」等，窗口再分创建/动作/容器/操作/获取/设置，元变量约 20 类。

查文档三步：先按功能找目录（人物、物品、系统……），再按动作找文件名（拿物品、删除物品……），最后读「函数签名 + 参数表 + 示例代码」。每个接口文档都给出函数名、参数类型与说明、返回值、可直接复制的示例。

表 4-1 服务端文档目录速览

大类	子目录示例	数量（md）
触发	玩家、英雄-宠物、行会组队、系统、怪物、PVP	295（17 目录）
接口	人物相关、物品操作、系统、定时器、地图相关	701（25 目录）
客户端-游戏	常用函数、请求类、基础函数	20+ 子类
客户端-窗口	创建、动作、容器、操作、获取、设置	600+
客户端-元变量	角色相关、背包、技能、宠物、当前地图等	20 类

练习任务

在本地文档中定位 5 个触发与 5 个接口，记录每个的函数签名与所在路径；再各挑 1 个运行其示例。

参考：验收要点

触发示例：玩家\登录触发（login）、NPC点击触发（clicknpc）、
杀怪获取经验触发（getexpbykillmon）等；
接口示例：人物相关\查询人物货币（querymoney）、
物品操作\给物品（giveitem）、系统\发送聊天框消息（sendmsg）等；
每个签名都能在文档「复制」代码框中找到原样文本。

知识讲解

文档结构数据来源：本地 showdoc 服务端/客户端 260831 目录盘点。