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

来自天龙知识库
跳到导航跳到搜索
下一编辑→

雪舞​（留言 | 贡献）

7,476次编辑
雪舞​（留言 | 贡献）
7,476次编辑
整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明
 
雪舞​（留言 | 贡献）
7,476次编辑
维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例
第4行： 第4行：


<div style="padding:14px 0;border-top:3px solid #287568;border-bottom:1px solid #dbe3e6;">调用可变参数的任意脚本函数</div>
<div style="padding:14px 0;border-top:3px solid #287568;border-bottom:1px solid #dbe3e6;">调用可变参数的任意脚本函数</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 调用 ==
== 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 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 处）。


== 参数 ==
== 参数 ==
第16行： 第20行：
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 1
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 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>
| 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>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 脚本配置编号。
| 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>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 2
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 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>
| 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>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 脚本入口函数名称（字符串）。
| 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>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 3
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 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>
| 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>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 当前调用所在的场景 ID。
| 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>
|}
|}


== 返回值 ==
== 返回值 ==
转交目标函数的返回值，数量由目标函数决定；场景、脚本加载或入口查找失败等路径返回 -1。
转交目标函数的返回值，数量由目标函数决定；场景、脚本加载或入口查找失败等路径返回 -1。
== 脚本中的调用 ==
以下是服务端脚本里的真实调用点，按实参形态去重后列出 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
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 style="white-space:normal;overflow-wrap:anywhere;">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 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>
</div>

2026年9月19日 (六) 12:49的版本

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

调用可变参数的任意脚本函数
本页由服务端绑定源码与随包脚本自动整理：用途、参数位置与返回数量取实现体，未在游戏内执行验证。调用点取自 4244 个服务端脚本中的 7361 处真实调用。

Lua 调用

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

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

参数

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

返回值

转交目标函数的返回值，数量由目标函数决定；场景、脚本加载或入口查找失败等路径返回 -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」。
核对依据：LuaFnTbl_Misc.h 第 731 行，服务端注册表第 210 行。调用格式与返回数量依据当前实现整理；脚本调用点取自 4244 个随包脚本（共 535888 行、命中 85384 处调用），未经运行验证。游戏内效果、边界行为及未注明的业务枚举仍需实测。
检索自“https://www.waylee.net/index.php?title=Lua接口/服务端/CallScriptFunction&oldid=3739”