Lua接口/服务端/WithDrawFreeDoubleExpTime:修订间差异

来自天龙知识库
跳到导航跳到搜索
Waylee​(留言 | 贡献)
维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例
Waylee​(留言 | 贡献)
维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例
第12行: 第12行:
服务端脚本中共出现 2 处调用,实参个数出现过:5 个(2 处)。
服务端脚本中共出现 2 处调用,实参个数出现过:5 个(2 处)。


实现位于 <code>LuaFnTbl_Attr.h</code> 第 6260 行,注册表第 1254、1255 行。
实现位于 <code>LuaFnTbl_Attr.h</code> 第 6376 行,注册表第 1260、1261 行。


== 参数 ==
== 参数 ==

2026年9月19日 (六) 23:59的版本

首页 · 服务端接口 · 角色属性与物品 · 调用约定

消耗三类免费领取次数,并将对应小时数加入免费双倍经验时间。

同一接口的其他调用名称:LuaFnWithDrawFreeDoubleExpTime。

Lua 调用

WithDrawFreeDoubleExpTime(sceneId, selfId, value, valueCity, valueOther)

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

实现位于 LuaFnTbl_Attr.h 第 6376 行,注册表第 1260、1261 行。

参数

序号 参数 / 类型 说明
1 sceneId
number
当前调用所在的场景 ID。
脚本中的实参:sceneId(2 处)
2 selfId
number
当前场景内的对象 ID。玩家接口需传入有效玩家对象;不是角色 GUID。
脚本中的实参:selfId(2 处)
3 value
number
要写入的数值。
脚本中的实参:0、nPoint
4 valueCity
number
城市相关数值。
脚本中的实参:0、nPoint
5 valueOther
number
其他相关数值。
脚本中的实参:0(2 处)

返回值

返回 1 个值。返回类型包括 number。明确的固定返回组合包括 1;0。

脚本中的调用

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

-- obj/city/pc_militaryofficer.lua
WithDrawFreeDoubleExpTime(sceneId, selfId, 0, nPoint, 0)

-- obj/luoyang/oluoyang_liujianming.lua
WithDrawFreeDoubleExpTime(sceneId, selfId, nPoint, 0, 0)

注意事项

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