Waylee：维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

2026-10-24T04:24:53Z

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

新页面

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/动作与技能|动作与技能]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">按当前字典编码格式化文本（与客户端共用同一套编码）。</div>

== Lua 调用 ==
<pre>ScriptGlobal_Format(key, param1, ...)</pre>

服务端脚本中共出现 22 处调用，实参个数出现过：2 个（16 处）、3 个（3 处）、5 个（1 处）、6 个（2 处）。

实现位于 <code>LuaFnTbl_DoAction.h</code>。

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>key</code><br /><span class="lua-muted"><code>string</code></span>
| 字典键（字符串）。<br /><span class="lua-muted">脚本中的实参：<code>"#{SZBH_231103_03}"</code>（2 处）、<code>"#{SZBH_231103_26}"</code>（2 处）、<code>"#{SZBH_231103_32}"</code>（2 处）</span>
|-
| 2
| <code>param1</code><br /><span class="lua-muted"><code>string</code></span>
| 第一个参数，按字符串读取。<br /><span class="lua-muted">脚本中的实参：<code>GetName(sceneId, selfId)</code>（3 处）、<code>GetName(sceneId,selfId)</code>（2 处）、<code>name</code>（2 处）</span>
|}

== 返回值 ==
返回 1 个 string：格式化结果。参数个数或载荷不合法时抛 Lua 错误并终止本次调用，不会返回空串。

== 脚本中的调用 ==
以下是服务端脚本里的真实调用点，按实参形态去重后列出 8 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。
<pre>-- event/dress/DressActionSkill.lua
ScriptGlobal_Format("#{SZBH_231103_02}", LuaFnGetItemName(nDressBegin))

-- event/dress/DressActionSkill.lua
ScriptGlobal_Format("#{SZBH_231103_03}", tostring(floor(nLeftTime / 3600)))

-- event/dress/DressActionSkill.lua
ScriptGlobal_Format("#{SZBH_231103_32}", tostring(floor(nLeftTime / 60)))

-- event/dress/DressActionSkill.lua
ScriptGlobal_Format("#{SZBH_231103_33}", tostring(nLeftTime))

-- event/dress/DressActionSkill.lua
ScriptGlobal_Format("#{SZBH_231103_26}", GetName(sceneId,selfId))

-- event/dress/DressActionSkill.lua
ScriptGlobal_Format("#{SZBH_231103_29}", GetName(sceneId, selfId))

-- event/Exterior/ExteriorWeapon_Levelup.lua
ScriptGlobal_Format("#{HSWQ_20220607_46}", GetName(sceneId, selfId), name)

-- event/Exterior/RideEquip.lua
ScriptGlobal_Format("#{WGTJ_200617_69}", name)</pre>

== 注意事项 ==
* 参数按字节传递，不按字符数统计；错误会终止本次调用，不会得到部分结果。
* 这是可变参接口：第 2 个实参起最多 15 个参数，全部按字符串读取；个数超出或编码失败会抛错终止本次 Lua 调用。

</div>

Lua接口/服务端/ScriptGlobal Format - 版本历史

Waylee：​维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

Waylee：维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例