Lua接口/服务端/CallScriptFunction

来自天龙知识库
雪舞留言 | 贡献2026年9月7日 (一) 19:00的版本 (整理当前服务端 Lua 接口:注册名称、参数、返回值与调用说明)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航跳到搜索

首页 · 服务端接口 · 通用与活动 · 调用约定

调用可变参数的任意脚本函数

Lua 调用

CallScriptFunction(scriptId, funcname, sceneId, ...)

参数

序号 参数 / 类型 说明
1 scriptId
number
脚本配置编号。
2 funcname
string
脚本入口函数名称(字符串)。
3 sceneId
number
当前调用所在的场景 ID。

返回值

转交目标函数的返回值,数量由目标函数决定;场景、脚本加载或入口查找失败等路径返回 -1。

注意事项

  • funcname 传不带 x000000_ 前缀的入口名称,脚本编号必须已配置。
  • 第 4 个及后续参数传给目标函数;sceneId 同时作为目标函数的第一个实参。数值转交时按整数转换;不要传 table 或 userdata。
核对依据:LuaFnTbl_Misc.h 第 733 行,服务端注册表第 206 行。调用格式与返回数量依据当前实现整理;游戏内效果、边界行为及未注明的业务枚举仍需实测。