Lua接口/服务端/CallScriptFunction

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

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

Lua 调用

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

服务端脚本中共出现 7362 处调用，实参个数出现过：3 个（36 处）、4 个（1710 处）、5 个（3203 处）、6 个（1401 处）、7 个（624 处）、8 个（356 处）、9 个（4 处）、10 个（15 处）、11 个（13 处）。

实现位于 LuaFnTbl_Misc.h。

参数

序号	参数 / 类型	说明
1	scriptId number	脚本配置编号。 脚本中的实参：missionScriptId（2083 处）、eventId（951 处）、scriptId（556 处）
2	funcname string	脚本入口函数名称（字符串）。 脚本中的实参："OnDefaultEvent"（946 处）、"OnAccept"（737 处）、"CheckAccept"（714 处）
3	sceneId number	当前调用所在的场景 ID。 脚本中的实参：sceneId（7362 处）

返回值

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

脚本中的调用

以下是服务端脚本里的真实调用点，按实参形态去重后列出 8 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。

-- city0_building11.lua
CallScriptFunction(CITY_BUILDING_ABILITY_SCRIPT, "AddCityLifeAbilityOpt", sceneId, selfId, x805018_g_scriptId, x805018_g_BuildingID13, 8)

-- city0_building11.lua
CallScriptFunction(CITY_BUILDING_ABILITY_SCRIPT, "OnDefaultEvent", sceneId, selfId, targetId, eventId, x805018_g_scriptId, x805018_g_BuildingID13)

-- city0_building11.lua
CallScriptFunction(CITY_BUILDING_ABILITY_SCRIPT, "OnEnumerate", sceneId, selfId, targetId, x805018_g_BuildingID13)

-- city0_building3.lua
CallScriptFunction(CITY_BUILDING_ABILITY_SCRIPT, "AddCityLifeAbilityOpt", sceneId, selfId, x805010_g_scriptId, x805010_g_BuildingID4, 7)

-- city0_building3.lua
CallScriptFunction(CITY_BUILDING_ABILITY_SCRIPT, "OnDefaultEvent", sceneId, selfId, targetId, eventId, x805010_g_scriptId, x805010_g_BuildingID4)

-- city0_building3.lua
CallScriptFunction(CITY_BUILDING_ABILITY_SCRIPT, "OnEnumerate", sceneId, selfId, targetId, x805010_g_BuildingID4)

-- city0_building5.lua
CallScriptFunction(CITY_BUILDING_ABILITY_SCRIPT, "AddCityLifeAbilityOpt", sceneId, selfId, x805012_g_scriptId, x805012_g_BuildingID6, 888)

-- city0_building5.lua
CallScriptFunction(CITY_BUILDING_ABILITY_SCRIPT, "OnDefaultEvent", sceneId, selfId, targetId, eventId, x805012_g_scriptId, x805012_g_BuildingID6)

注意事项

• funcname 传不带 x000000_ 前缀的入口名称，脚本编号必须已配置。
• 第 4 个及后续参数传给目标函数；sceneId 同时作为目标函数的第一个实参。数值转交时按整数转换；不要传 table 或 userdata。
• 实现体检查 argc >= 3，不满足时记录断言「Amount of Params is less than 3」。