雪舞：维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

2026-09-07T11:53:16Z

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:53的版本
第43行：		第43行：

	[[Lua接口/服务端调用示例\|常用调用示例]]		[[Lua接口/服务端调用示例\|常用调用示例]]

			== 调用问题 ==
			* [[Lua接口/函数不存在\|函数不存在或提示 nil]]
			* [[Lua接口/参数类型与顺序\|参数类型与传入顺序]]
			* [[Lua接口/返回值判断\|返回值为 0、负数或空字符串]]
			* [[Lua接口/对象ID与GUID\|对象 ID 与 GUID 的区别]]
			* [[Lua接口/服务端与客户端调用范围\|服务端与客户端的调用范围]]

	</div>		</div>

雪舞：整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明

2026-09-07T11:16:13Z

整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明

新页面

__NOTOC__
<div class="lua-reference" style="max-width:1200px;margin:0 auto;line-height:1.8;color:#29343a;font-family:Arial,'Microsoft YaHei',sans-serif;letter-spacing:0;overflow-wrap:anywhere;">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]]

== 参数 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数类型
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 约定
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 当前调用所处的场景编号。跨场景逻辑需通过对应接口完成。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">selfId / targetId</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 当前场景内的对象 ID，玩家、NPC 和怪物对象不能随意互换。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GUID</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 角色或珍兽的全局唯一标识；与场景对象 ID 不同。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">itemTypeSn / itemId</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 物品配置编号，与背包格子位置不同。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">number</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 数值参数。布尔型开关若按数值读取，应使用约定的 0 或 1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">string</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 字符串参数。文字编码需与服务端脚本和客户端约定一致。
|}

参数按位置传入，变量名可由脚本自行命名。并不是每个函数都以 sceneId、selfId 开头，例如 AddText 的第二个参数就是文字，AddItem 的第二个参数是物品编号。

== 返回值 ==
* 无返回值与返回数字 0 不同。无返回值的函数被赋给变量时，变量得到 nil。
* Lua 中只有 nil 和 false 在条件判断中为假，数字 0 和 -1 都为真。
* 部分接口用 1 表示成功，部分接口返回对象编号、计数、错误码或多个值，必须查阅该函数的约定。
* 返回多个值时按顺序接收，例如 local x, z = GetWorldPos(sceneId, selfId)。
* 具有可变返回数量的接口，失败时可能只返回一项，其余接收变量为 nil。

== 运行环境 ==
这些函数由游戏服务端注册，需在服务端脚本回调中调用。普通独立 Lua 环境或客户端脚本不保证存在同名函数。对象必须仍在相应场景中，并满足接口所要求的玩家、怪物或珍兽类型。

== 名称 ==
注册名称保留原拼写。例如 <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetLifeTimeAttrRefix_CriticalDefebce</code> 中的 Defebce 是当前可调用名称，不应自行改写为 Defence。

[[Lua接口/服务端调用示例|常用调用示例]]

</div>

Lua接口/服务端调用约定 - 版本历史

雪舞：​维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

雪舞：​整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明

雪舞：维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

雪舞：整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明