Lua接口/服务端与客户端调用范围
来自天龙知识库
函数在哪一端注册，就在相应的脚本运行环境中调用。服务端、客户端和独立 Lua 解释器不共享同一张函数表。
三类调用环境
| 环境 | 通常处理的工作 | 本知识库的适用范围 |
|---|---|---|
| 服务端游戏脚本 | NPC 对话、任务、玩家属性、背包、场景等游戏逻辑。 | 服务端函数索引覆盖当前 GameServer 注册名称；还要满足对应场景、玩家或怪物等对象条件。 |
| 客户端界面脚本 | 窗口、界面事件、显示及已实现的客户端请求。 | 客户端有独立注册入口与参数约定；不能直接照搬服务端函数的名称、参数或返回值。 |
| 独立 Lua 环境 | 语法检查及不依赖游戏的 Lua 代码。 | 不会自动拥有游戏引擎注册函数。语法通过不代表游戏内可调用或有效。 |
同名函数也可能来自不同端或脚本封装。看到某个名称可调用，只能说明当前作用域有这个函数，不能单凭名称判断它的来源或业务能力。
服务端示例的前提
-- 放在已有的服务端玩家回调中
-- sceneId、selfId 由该回调提供
if type(GetLevel) ~= "function" then
return
end
if type(sceneId) ~= "number" or type(selfId) ~= "number" then
return
end
local level = GetLevel(sceneId, selfId)
if type(level) == "number" and level >= 0 then
-- 处理当前玩家等级
end
上面的检查不能创建场景或玩家对象。在客户端文件中声明两个同名变量，或复制这个函数调用，不会得到有效的服务端上下文。
显示在客户端不等于由客户端调用
BeginEvent、AddText、DispatchEventList 由服务端脚本调用，对话最终显示在客户端；AddItemListToHuman 也是服务端发放物品。判断运行端应看脚本入口和注册位置，不应只看最终效果出现在哪里。
两端配合的边界
客户端操作需要通过项目已经实现的请求、事件或协议到达服务端，再由服务端在合法上下文中调用游戏接口。服务器需重新核对当前玩家、物品、数量及业务条件；客户端显示的数据不等于服务端已确认的结果。
CallScriptFunction 用于服务端脚本入口之间的调用，不能执行客户端界面函数，也不是把任意 Lua 函数名发给另一端运行的通用通道。具体客户端入口、协议字段及调用链须按现有实现核对，未核对的部分需要实测。
排查调用范围
- 确认执行文件由哪个进程加载：服务端任务或场景脚本、客户端 UI 资源，还是独立解释器。
- 在对应端核对完整注册名称和参数；服务端索引中存在不等于客户端也存在，客户端存在也不等于服务端已注册。
- 确认当前回调真正提供的场景编号、对象 ID 或界面对象，不从另一端直接挪用同名变量。
- 函数为 nil 时转到 函数不存在或提示 nil；函数存在但结果异常时核对 参数 和 返回值。
- 独立 Lua 工具可以检查语法。模拟返回值只能测试脚本分支，无法验证真实场景查找、物品扣除、网络消息或持久化效果；这些仍需要实测。
客户端接口尚未在这批服务端索引中逐项整理。本页说明调用边界，不把未核对的客户端函数名列为可用接口。
相关问题
示例依据当前服务端注册名称和参数读取顺序核对；sceneId、selfId 等上下文及业务编号由实际回调提供。Lua 语法检查不能代替游戏内实测。
