Lua接口/服务端函数索引

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

服务端 Lua 接口

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

1273 个接口 · 1312 个调用名称 · 33 个分类 · 1010 个在脚本中有调用

常用入口

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

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

按功能分类

分类	接口数	调用名称数
角色属性与物品	221	241
任务与对话	93	99
任务配置查询	32	32
通用与活动	114	119
生活技能与装备	141	144
珍兽	68	68
珍兽繁殖公告	4	4
珍兽繁殖	5	5
珍兽幻化与灵性	7	7
珍兽魂	9	9
怪物与掉落	59	59
怪物行为	6	6
动作与技能	38	39
场景与副本	45	45
队伍	29	33
PK与声望	20	20
战场	35	35
商店与交易	36	36
好友与师徒	43	43
帮会	23	23
帮会同盟	2	2
帮会城市	38	38
载具与乘客	16	16
暗器	22	22
修炼与功能开关	9	9
外观与时装	20	20
纹饰	6	6
武魂与幻魂	10	10
龙纹	7	7
雕纹	6	6
重楼	1	1
自动战斗	6	6
日志与审计	102	102

接口约定

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

特殊入口

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