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

来自天龙知识库
跳到导航跳到搜索

Waylee​（留言 | 贡献）

3个用户组
5,114次编辑
雪舞​（留言 | 贡献）
7,476次编辑
整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明
 
Waylee​（留言 | 贡献）
行政员、​界面管理员、​管理员
5,114次编辑
维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例
 
（未显示2个用户的4个中间版本）
第1行： 第1行：
__NOTOC__
__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接口/服务端调用约定|调用约定]]
[[首页|首页]] · [[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>


== Lua 调用 ==
== Lua 调用 ==
<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>
<pre>CallScriptFunction(scriptId, funcname, sceneId, ...)</pre>
 
服务端脚本中共出现 7362 处调用，实参个数出现过：3 个（36 处）、4 个（1710 处）、5 个（3203 处）、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 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 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。
| 当前调用所在的场景 ID。<br /><span class="lua-muted">脚本中的实参：<code>sceneId</code>（7362 处）</span>
|}
|}


== 返回值 ==
== 返回值 ==
转交目标函数的返回值，数量由目标函数决定；场景、脚本加载或入口查找失败等路径返回 -1。
转交目标函数的返回值，数量由目标函数决定；场景、脚本加载或入口查找失败等路径返回 -1。
== 脚本中的调用 ==
以下是服务端脚本里的真实调用点，按实参形态去重后列出 8 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。
<pre>-- 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)</pre>


== 注意事项 ==
== 注意事项 ==
* funcname 传不带 x000000_ 前缀的入口名称，脚本编号必须已配置。
* funcname 传不带 x000000_ 前缀的入口名称，脚本编号必须已配置。
* 第 4 个及后续参数传给目标函数；sceneId 同时作为目标函数的第一个实参。数值转交时按整数转换；不要传 table 或 userdata。
* 第 4 个及后续参数传给目标函数；sceneId 同时作为目标函数的第一个实参。数值转交时按整数转换；不要传 table 或 userdata。
 
* 实现体检查 <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> 第 733 行，服务端注册表第 206 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>


</div>
</div>

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」。
检索自“https://www.waylee.net/index.php?title=Lua接口/服务端/CallScriptFunction&oldid=11610”