Lua接口/服务端/ScriptGlobal Format

首页 · 服务端接口 · 动作与技能 · 调用约定

按当前字典编码格式化文本（与客户端共用同一套编码）。

Lua 调用

ScriptGlobal_Format(key, param1, ...)

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

实现位于 LuaFnTbl_DoAction.h。

参数

序号	参数 / 类型	说明
1	key string	字典键（字符串）。 脚本中的实参："#{SZBH_231103_03}"（2 处）、"#{SZBH_231103_26}"（2 处）、"#{SZBH_231103_32}"（2 处）
2	param1 string	第一个参数，按字符串读取。 脚本中的实参：GetName(sceneId, selfId)（3 处）、GetName(sceneId,selfId)（2 处）、name（2 处）

返回值

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

脚本中的调用

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

-- 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)

注意事项

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