Lua接口/服务端函数索引

首页 · 服务端接口 · 调用约定

服务端 Lua 接口

面向服务端脚本的函数调用参考：用途、参数顺序、返回值与调用注意事项。

1149 个接口 · 1188 个调用名称 · 22 个分类 · 910 个在脚本中有调用

常用入口

GetName · GetLevel · GetHp · GetItemCount · GetWorldPos · BeginEvent · AddText · BeginAddItem · EndAddItem · CallScriptFunction

参数与返回值约定 · 常用调用示例 · 按页面名浏览

按功能分类

分类	接口数	调用名称数
角色属性与物品	220	240
任务与对话	92	98
任务配置查询	32	32
通用与活动	109	114
生活技能与装备	118	121
珍兽	65	65
怪物与掉落	58	58
怪物行为	6	6
动作与技能	36	37
场景与副本	44	44
队伍	29	33
PK与声望	20	20
战场	35	35
商店与交易	36	36
珍兽繁殖公告	4	4
好友与师徒	43	43
帮会	23	23
帮会同盟	2	2
帮会城市	38	38
载具与乘客	16	16
暗器	21	21
日志与审计	102	102

接口约定

• 收录当前 GameServer 实际注册给 Lua 的游戏接口，包含原有别名和拼写；Lua 标准库、纯 Lua 自定义函数不计入。
• 函数名区分大小写。只有注册名称带 LuaFn 前缀时，调用才带该前缀。
• sceneId 通常表示当前场景；selfId 通常表示场景内对象 ID，不是角色 GUID。参数顺序以函数页面为准。
• 数字 0 和 -1 在 Lua 条件判断中都是真值。成功条件需使用明确比较，不能统一写成 if result then。
• 空实现和已废弃入口仍收录，页面明确标注，避免将可调用误认为有实际效果。
• 本批覆盖全部注册入口的基础说明，并用随包脚本交叉核对：4245 个服务端脚本（共 536099 行）中命中 85422 处调用，其中 910 个接口能在脚本里找到真实调用点。脚本只作参数顺序与实参形态的旁证，未在游戏内执行；复杂返回项、可选参数与业务枚举未注明的部分仍需按具体接口核对。

特殊入口

• Msg2Team：当前为空实现，调用不会向队伍成员发送消息。
• TDispatchEventList：当前为空实现，调用不会派发扩展任务对话。
• CreateMonsterOnScene：已废弃的怪物创建入口。请使用 LuaFnCreateMonster。