查看“︁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接口/服务端调用约定|调用约定]]

以下代码放入已有服务端回调中。sceneId、selfId 来自回调；NPC 对话还需要有效 targetId。物品、任务和脚本编号由本服配置提供。

== 读取角色信息 ==
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">local name = GetName(sceneId, selfId)
local level = GetLevel(sceneId, selfId)
local hp = GetHp(sceneId, selfId)
local x, z = GetWorldPos(sceneId, selfId)</pre>

== NPC对话 ==
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">BeginEvent(sceneId)
AddText(sceneId, "当前等级：" .. GetLevel(sceneId, selfId))
EndEvent(sceneId)
DispatchEventList(sceneId, selfId, targetId)</pre>
BeginEvent 开始并清空对话，AddText 添加内容，DispatchEventList 将内容发送给玩家。EndEvent 不会自动显示对话。

== 查询物品数量 ==
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">-- itemTypeSn 为当前业务使用的物品配置编号
local count = GetItemCount(sceneId, selfId, itemTypeSn)
if count &gt;= 5 then
    -- 满足数量要求后的处理
end</pre>
这里统计已装备与背包物品之和，未验证锁定状态，不能直接等同于可扣除数量。

== 发放物品 ==
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">-- itemTypeSn 为已确认有效的物品配置编号
BeginAddItem(sceneId)
AddItem(sceneId, itemTypeSn, 1)
if EndAddItem(sceneId, selfId) == 1 then
    AddItemListToHuman(sceneId, selfId)
end</pre>
AddItem 加入待发列表，EndAddItem 只检查能否接收，AddItemListToHuman 执行发放。最后一步无返回值，本示例不提供事务或重复领取保护。

== 函数名称 ==
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">local level1 = GetLevel(sceneId, selfId)
local level2 = LuaFnGetLevel(sceneId, selfId)</pre>
这两个名称都在注册表中，指向同一接口。其他函数不能据此自行增删 LuaFn 前缀。

以上示例已对照当前接口实现，尚未在游戏内执行。

</div>