Lua接口/服务端/CallScriptFunction：修订间差异

2026年9月20日 (日) 00:11的最新版本

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

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」。

@@ 第1行： / 第1行： @@
 __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;">
+<div class="lua-reference">
 [[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/通用与活动|通用与活动]] · [[Lua接口/服务端调用约定|调用约定]]
-<div style="padding:14px 0;border-top:3px solid #287568;border-bottom:1px solid #dbe3e6;">调用可变参数的任意脚本函数</div>
+<div class="lua-lead lua-rule">调用可变参数的任意脚本函数</div>
-<div style="margin:10px 0;padding:10px 12px;border-left:3px solid #9a7940;background:#faf7f0;font-size:13px;color:#5f5136;">本页由服务端绑定源码与随包脚本自动整理：用途、参数位置与返回数量取实现体，<b>未在游戏内执行验证</b>。调用点取自 4244 个服务端脚本中的 7361 处真实调用。</div>
+== Lua 调用 ==
+<pre>CallScriptFunction(scriptId, funcname, sceneId, ...)</pre>
-== Lua 调用 ==
+服务端脚本中共出现 7362 处调用，实参个数出现过：3 个（36 处）、4 个（1710 处）、5 个（3203 处）、6 个（1401 处）、7 个（624 处）、8 个（356 处）、9 个（4 处）、10 个（15 处）、11 个（13 处）。
-<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">CallScriptFunction(scriptId, funcname, sceneId, ...)</pre>
-服务端脚本中共出现 7361 处调用，实参个数出现过：3 个（36 处）、4 个（1710 处）、5 个（3202 处）、6 个（1401 处）、7 个（624 处）、8 个（356 处）、9 个（4 处）、10 个（15 处）、11 个（13 处）。
+实现位于 <code>LuaFnTbl_Misc.h</code>。
 == 参数 ==
-{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
+{| class="wikitable"
-! scope="col" style="text-align:left;background:#edf3f2;padding:8px;width:11%;" | 序号
+! scope="col" class="lua-w11" | 序号
-! scope="col" style="text-align:left;background:#edf3f2;padding:8px;width:36%;" | 参数 / 类型
+! scope="col" class="lua-w36" | 参数 / 类型
-! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 说明
+! scope="col" | 说明
 |-
-| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 1
+| 1
-| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">scriptId</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>
+| <code>scriptId</code><br /><span class="lua-muted"><code>number</code></span>
-| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 脚本配置编号。<br /><span style="color:#657078;">脚本中的实参：<code style="white-space:normal;overflow-wrap:anywhere;">missionScriptId</code>（2083 处）、<code style="white-space:normal;overflow-wrap:anywhere;">eventId</code>（951 处）、<code style="white-space:normal;overflow-wrap:anywhere;">scriptId</code>（556 处）</span>
+| 脚本配置编号。<br /><span class="lua-muted">脚本中的实参：<code>missionScriptId</code>（2083 处）、<code>eventId</code>（951 处）、<code>scriptId</code>（556 处）</span>
 |-
-| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 2
+| 2
-| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">funcname</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">string</code></span>
+| <code>funcname</code><br /><span class="lua-muted"><code>string</code></span>
-| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 脚本入口函数名称（字符串）。<br /><span style="color:#657078;">脚本中的实参：<code style="white-space:normal;overflow-wrap:anywhere;">"OnDefaultEvent"</code>（946 处）、<code style="white-space:normal;overflow-wrap:anywhere;">"OnAccept"</code>（737 处）、<code style="white-space:normal;overflow-wrap:anywhere;">"CheckAccept"</code>（714 处）</span>
+| 脚本入口函数名称（字符串）。<br /><span class="lua-muted">脚本中的实参：<code>"OnDefaultEvent"</code>（946 处）、<code>"OnAccept"</code>（737 处）、<code>"CheckAccept"</code>（714 处）</span>
 |-
-| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 3
+| 3
-| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>
+| <code>sceneId</code><br /><span class="lua-muted"><code>number</code></span>
-| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 当前调用所在的场景 ID。<br /><span style="color:#657078;">脚本中的实参：<code style="white-space:normal;overflow-wrap:anywhere;">sceneId</code>（7361 处）</span>
+| 当前调用所在的场景 ID。<br /><span class="lua-muted">脚本中的实参：<code>sceneId</code>（7362 处）</span>
 |}
@@ 第36行： / 第36行： @@
 == 脚本中的调用 ==
 以下是服务端脚本里的真实调用点，按实参形态去重后列出 8 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。
-<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">-- city0_building11.lua
+<pre>-- city0_building11.lua
 CallScriptFunction(CITY_BUILDING_ABILITY_SCRIPT, "AddCityLifeAbilityOpt", sceneId, selfId, x805018_g_scriptId, x805018_g_BuildingID13, 8)
@@ 第63行： / 第63行： @@
 * funcname 传不带 x000000_ 前缀的入口名称，脚本编号必须已配置。
 * 第 4 个及后续参数传给目标函数；sceneId 同时作为目标函数的第一个实参。数值转交时按整数转换；不要传 table 或 userdata。
-* 实现体检查 <code style="white-space:normal;overflow-wrap:anywhere;">argc &gt;= 3</code>，不满足时记录断言「Amount of Params is less than 3」。
+* 实现体检查 <code>argc &gt;= 3</code>，不满足时记录断言「Amount of Params is less than 3」。
-<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Misc.h</code> 第 731 行，服务端注册表第 210 行。调用格式与返回数量依据当前实现整理；脚本调用点取自 4244 个随包脚本（共 535888 行、命中 85384 处调用），未经运行验证。游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>
 </div>

Lua接口/服务端/CallScriptFunction：修订间差异

Waylee（留言 | 贡献）

2026年9月20日 (日) 00:11的最新版本

Lua 调用

参数

返回值

脚本中的调用

注意事项

导航菜单

页面操作

页面操作

个人工具

导航

搜索

工具

Lua接口/服务端/CallScriptFunction：修订间差异

Waylee​（留言 | 贡献）

2026年9月20日 (日) 00:11的最新版本

Lua 调用

参数

返回值

脚本中的调用

注意事项

导航菜单

搜索

Waylee（留言 | 贡献）