详细讲解以下如何在官方在线文档中查找和使用服务端Lua接口

热血江湖引擎的官方在线文档提供了完整的服务端Lua接口查询和使用指南。以下是详细的操作步骤和说明： ## 1. 访问官方在线文档 * 服务端接口的完整文档地址为：`http://engine-doc.hzzaien.com/web/#/128/65159`。 * 该文档是“热血江湖-服务端”的在线版本，包含了所有引擎接口的详细说明。 ## 2. 文档结构与查找方法 * 文档左侧为导航目录，按功能模块（如玩家、物品、邮件、引擎变量等）对接口进行分类。 * 你可以通过展开目录树，快速定位到特定功能的接口。例如，查找设置玩家转职等级的接口，可以在“玩家”分类下找到“设置转职等级”。 * 每个接口页面通常包含以下部分： * **接口名称与语法**：明确展示函数名和调用格式。 * **参数说明**：以表格形式列出每个参数的必选性、类型和具体含义。 * **返回值**：说明函数返回的数据类型和内容。 * **注意事项**：部分接口会包含重要的使用提示或限制。 * **示例代码**：提供可直接参考或使用的Lua代码片段。 ## 3. 接口使用核心要点 * **调用时机**：服务端脚本主要在 `QFunction.lua` 及其加载的脚本中执行。引擎会在特定时刻（如M2启动、玩家登录、点击NPC等）触发对应的函数（如 `startup()`, `login(actor)`），你可以在这些函数中或由它们调用的自定义函数里使用服务端接口。 * **对象参数 (actor)**：绝大多数操作玩家的接口（如 `settargetinfo`, `changeappear`）第一个参数都是 `actor`，这代表玩家对象ID，由引擎在触发事件（如 `login(actor)`）时传入。 * **配合使用**：许多接口需要组合使用。例如，设置玩家自定义数据后，客户端需要通过特定事件和元变量来获取。 * **数据格式**：注意接口要求的数据格式，例如设置自定义玩家数据支持JSON格式 (`setplayercustjosndata`) 和字符串格式 (`setplayercustdata`)。 * **排序操作**：对自定义变量进行排序时，需先使用 `savehumvar` 保存变量，再调用 `sorthumvar` 或异步接口 `sorthumvarex`（排序完成后会回调 `sortvarover` 触发函数）。 ## 4. 辅助资源与更新 * **文档互通**：在线文档与本地知识库（如提供的服务端接口文件）内容对应，方便离线查阅。 * **更新日志**：服务端和客户端均有独立的更新日志（如服务端日志位于文档末尾），其中说明了新增、优化或修复的接口与功能，是了解接口变化的重要依据。 * **引擎工具**：引擎文件的下载、更新及工具服配置，需使用专用的 `RJHub` 工具。 通过以上方法，你可以在官方文档中系统地查找、理解并正确地在服务端脚本中应用各种Lua接口。