Lua接口/服务端/SetMissionCacheData

来自雪舞天龙知识库
Waylee​(留言 | 贡献)2026年10月27日 (二) 12:31的版本 (维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航跳到搜索

首页 · 服务端接口 · 任务与对话 · 调用约定

设置当前玩家任务临时缓存中的一个整数。

Lua 调用

SetMissionCacheData(sceneId, selfId, nIndex, nData)

服务端脚本中共出现 7 处调用,实参个数出现过:4 个(7 处)。

实现位于 LuaFnTbl_Mission.h。

参数

序号 参数 / 类型 说明
1 sceneId
number
当前调用所在的场景 ID。
脚本中的实参:sceneId(7 处)
2 selfId
number
当前场景内的对象 ID。玩家接口需传入有效玩家对象;不是角色 GUID。
脚本中的实参:selfId(7 处)
3 nIndex
number
条目索引。
脚本中的实参:0(3 处)、1(2 处)、2
4 nData
number
数据值。
脚本中的实参:BonusExp、BonusMoney、moneyBonus

返回值

根据执行分支,返回数量可能为 0、1 个(0 个表示无返回值)。返回类型包括 number。明确的固定返回组合包括 0。

调用示例

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

-- event/luoyang/eluoyang_fasongtongzhi.lua
SetMissionCacheData(sceneId, selfId, 0, BonusMoney)
-- event/luoyang/eluoyang_fasongtongzhi.lua
SetMissionCacheData(sceneId, selfId, 1, BonusExp)
-- event/xunhuan/event_chengxiongdatu.lua
SetMissionCacheData(sceneId, selfId, 0, scene)

注意事项

  • 调用对象必须是当前场景中的有效玩家。
  • 调用前要求玩家处于可执行逻辑的状态(实现体断言 pHuman->IsCanLogic());不满足时会记录断言,应先确认玩家当前状态。