Lua接口/服务端/TAddNumText

首页 · 服务端接口 · 任务配置查询 · 调用约定

向扩展任务缓冲写入编号、状态、索引、发布脚本和文本。

Lua 调用

TAddNumText(sceneId, id, msg, state, index, issueScript)

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

实现位于 LuaFnTbl_MissionTable.h。

参数

序号	参数 / 类型	说明
1	sceneId number	当前调用所在的场景 ID。 脚本中的实参：sceneId（34 处）
2	id number	条目或业务编号。 脚本中的实参：missionIndex（16 处）、x600026_g_ScriptId（2 处）、x229000_g_ScriptId
3	msg string	文字内容（字符串）。 脚本中的实参：missionName（16 处）、"大劫大难"、"进入市集"
4	state number	状态数值。 脚本中的实参：4（15 处）、2（8 处）、1（6 处）
5	index number	条目索引。 脚本中的实参：-1（30 处）、1（2 处）、2
6	issueScript number	关联脚本编号。 脚本中的实参：x600026_g_ScriptId（2 处）、x229000_g_ScriptId、x229001_g_ScriptId

返回值

无返回值。赋值接收时得到 nil；这与返回数字 0 不同。

调用示例

以下取自随包服务端脚本的真实调用，可对照上方参数表确认参数顺序：

-- event/city/ecity_0503savefamily.lua
TAddNumText(sceneId, x600026_g_ScriptId, "大劫大难", 10, 1, x600026_g_ScriptId)
-- event/city/ecity_0503savefamily.lua
TAddNumText(sceneId, x600026_g_ScriptId, "请随在下杀出重围", 10, 2, x600026_g_ScriptId)
-- event/city/ecity_0602military.lua
TAddNumText(sceneId, x600032_g_ScriptId, x600032_g_MissionName, 2, -1, x600032_g_ScriptId)

注意事项

• 接口会根据实参数量处理部分分支；省略参数前需确认对应调用场景。
• 脚本中有只传 5 个实参的调用，少于实现体读取的 6 个位置；缺省位置按引擎对缺失值的转换处理（通常为 0），不能直接当作有效数据。