天龙知识库 - 用户贡献 [zh-cn]

Lua接口/服务端函数索引

2026-09-19T16:16:25Z

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

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

<div class="lua-index-head">
<div role="heading" aria-level="2" class="lua-title">服务端 Lua 接口</div>
<div>面向服务端脚本的函数调用参考：用途、参数顺序、返回值与调用注意事项。</div>
<div class="lua-sub-lg">1149 个接口 · 1188 个调用名称 · 22 个分类 · 910 个在脚本中有调用</div>
</div>

== 常用入口 ==
[[Lua接口/服务端/GetName|GetName]] · [[Lua接口/服务端/GetLevel|GetLevel]] · [[Lua接口/服务端/GetHp|GetHp]] · [[Lua接口/服务端/GetItemCount|GetItemCount]] · [[Lua接口/服务端/GetWorldPos|GetWorldPos]] · [[Lua接口/服务端/BeginEvent|BeginEvent]] · [[Lua接口/服务端/AddText|AddText]] · [[Lua接口/服务端/BeginAddItem|BeginAddItem]] · [[Lua接口/服务端/EndAddItem|EndAddItem]] · [[Lua接口/服务端/CallScriptFunction|CallScriptFunction]]

[[Lua接口/服务端调用约定|参数与返回值约定]] · [[Lua接口/服务端调用示例|常用调用示例]] · [[Special:PrefixIndex/Lua接口/服务端/|按页面名浏览]]

== 按功能分类 ==
{| class="wikitable"
! scope="col" class="lua-w60" | 分类
! scope="col" class="lua-w18" | 接口数
! scope="col" | 调用名称数
|-
| [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]]
| 220
| 240
|-
| [[Lua接口/服务端函数索引/任务与对话|任务与对话]]
| 92
| 98
|-
| [[Lua接口/服务端函数索引/任务配置查询|任务配置查询]]
| 32
| 32
|-
| [[Lua接口/服务端函数索引/通用与活动|通用与活动]]
| 109
| 114
|-
| [[Lua接口/服务端函数索引/生活技能与装备|生活技能与装备]]
| 118
| 121
|-
| [[Lua接口/服务端函数索引/珍兽|珍兽]]
| 65
| 65
|-
| [[Lua接口/服务端函数索引/怪物与掉落|怪物与掉落]]
| 58
| 58
|-
| [[Lua接口/服务端函数索引/怪物行为|怪物行为]]
| 6
| 6
|-
| [[Lua接口/服务端函数索引/动作与技能|动作与技能]]
| 36
| 37
|-
| [[Lua接口/服务端函数索引/场景与副本|场景与副本]]
| 44
| 44
|-
| [[Lua接口/服务端函数索引/队伍|队伍]]
| 29
| 33
|-
| [[Lua接口/服务端函数索引/PK与声望|PK与声望]]
| 20
| 20
|-
| [[Lua接口/服务端函数索引/战场|战场]]
| 35
| 35
|-
| [[Lua接口/服务端函数索引/商店与交易|商店与交易]]
| 36
| 36
|-
| [[Lua接口/服务端函数索引/珍兽繁殖公告|珍兽繁殖公告]]
| 4
| 4
|-
| [[Lua接口/服务端函数索引/好友与师徒|好友与师徒]]
| 43
| 43
|-
| [[Lua接口/服务端函数索引/帮会|帮会]]
| 23
| 23
|-
| [[Lua接口/服务端函数索引/帮会同盟|帮会同盟]]
| 2
| 2
|-
| [[Lua接口/服务端函数索引/帮会城市|帮会城市]]
| 38
| 38
|-
| [[Lua接口/服务端函数索引/载具与乘客|载具与乘客]]
| 16
| 16
|-
| [[Lua接口/服务端函数索引/暗器|暗器]]
| 21
| 21
|-
| [[Lua接口/服务端函数索引/日志与审计|日志与审计]]
| 102
| 102
|}

== 接口约定 ==
* 收录当前 GameServer 实际注册给 Lua 的游戏接口，包含原有别名和拼写；Lua 标准库、纯 Lua 自定义函数不计入。
* 函数名区分大小写。只有注册名称带 LuaFn 前缀时，调用才带该前缀。
* sceneId 通常表示当前场景；selfId 通常表示场景内对象 ID，不是角色 GUID。参数顺序以函数页面为准。
* 数字 0 和 -1 在 Lua 条件判断中都是真值。成功条件需使用明确比较，不能统一写成 if result then。
* 空实现和已废弃入口仍收录，页面明确标注，避免将可调用误认为有实际效果。
* 本批覆盖全部注册入口的基础说明，并用随包脚本交叉核对：4245 个服务端脚本（共 536099 行）中命中 85422 处调用，其中 910 个接口能在脚本里找到真实调用点。脚本只作参数顺序与实参形态的旁证，未在游戏内执行；复杂返回项、可选参数与业务枚举未注明的部分仍需按具体接口核对。

== 特殊入口 ==
* [[Lua接口/服务端/Msg2Team|Msg2Team]]：当前为空实现，调用不会向队伍成员发送消息。
* [[Lua接口/服务端/TDispatchEventList|TDispatchEventList]]：当前为空实现，调用不会派发扩展任务对话。
* [[Lua接口/服务端/CreateMonsterOnScene|CreateMonsterOnScene]]：已废弃的怪物创建入口。请使用 LuaFnCreateMonster。

</div>

Lua接口/服务端函数索引/通用与活动

2026-09-19T16:16:25Z

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

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

<div class="lua-lead">通用与活动：109 个接口，114 个调用名称，其中 99 个在当前脚本中有调用。</div>
{| class="wikitable"
! scope="col" class="lua-w36" | 函数 / 别名
! scope="col" | 调用与用途
|-
| [[Lua接口/服务端/AddDyTitle|AddDyTitle]]
| <code>AddDyTitle(sceneId, selfId, TitleId)</code> 加入新的动态称号，如果满了放在第一个 脚本中未见调用
|-
| [[Lua接口/服务端/AddGlobalCountNews|AddGlobalCountNews]] [[Lua接口/服务端/LuaFnAddGlobalCountNews|LuaFnAddGlobalCountNews]]
| <code>AddGlobalCountNews(sceneId, newstr)</code> 向全组服务器发送新闻公告，公告发送指定次数 脚本中 77 处调用
|-
| [[Lua接口/服务端/AuditBravertChallenge|AuditBravertChallenge]]
| <code>AuditBravertChallenge(sceneId, selfId, sort)</code> 记录勇闯挑战活动日志。 脚本中 5 处调用
|-
| [[Lua接口/服务端/AwardBangpaiTitle|AwardBangpaiTitle]]
| <code>AwardBangpaiTitle(sceneId, selfId, strText)</code> 设置此人的帮派称号 脚本中未见调用
|-
| [[Lua接口/服务端/AwardGuildContriTitle|AwardGuildContriTitle]]
| <code>AwardGuildContriTitle(sceneId, selfId, strText)</code> 设置帮会贡献称号字符串。 脚本中 2 处调用
|-
| [[Lua接口/服务端/AwardJieBaiTitle|AwardJieBaiTitle]]
| <code>AwardJieBaiTitle(sceneId, selfId, strText)</code> 设置结拜称号 脚本中 2 处调用
|-
| [[Lua接口/服务端/AwardMasterTitle|AwardMasterTitle]]
| <code>AwardMasterTitle(sceneId, selfId, strText)</code> 设置师父称号字符串。 脚本中 1 处调用
|-
| [[Lua接口/服务端/AwardNickTitle|AwardNickTitle]]
| <code>AwardNickTitle(sceneId, selfId, strText)</code> 设置此人的签名档性质的昵称 脚本中未见调用
|-
| [[Lua接口/服务端/AwardShangDianTitle|AwardShangDianTitle]]
| <code>AwardShangDianTitle(sceneId, selfId, strText)</code> 设置此人的帮派称号 脚本中未见调用
|-
| [[Lua接口/服务端/AwardShiTuTitle|AwardShiTuTitle]]
| <code>AwardShiTuTitle(sceneId, selfId, strText)</code> 设置此人的帮派称号 脚本中 5 处调用
|-
| [[Lua接口/服务端/AwardSpouseTitle|AwardSpouseTitle]] [[Lua接口/服务端/LuaFnAwardSpouseTitle|LuaFnAwardSpouseTitle]]
| <code>AwardSpouseTitle(sceneId, selfId, strText)</code> 设置配偶名 脚本中 10 处调用
|-
| [[Lua接口/服务端/AwardTitle|AwardTitle]] [[Lua接口/服务端/LuaFnAwardTitle|LuaFnAwardTitle]]
| <code>AwardTitle(sceneId, selfId, TitleIndex, TitleId, uDisabledTime)</code> 为selfId授予一个称号 脚本中 29 处调用
|-
| [[Lua接口/服务端/BaibaoshuxiaItemDropItem|BaibaoshuxiaItemDropItem]]
| <code>BaibaoshuxiaItemDropItem(arg1, arg2, randomBase)</code> 按传入的随机位置查询百宝书匣掉落物品及公告标志。 脚本中 1 处调用
|-
| [[Lua接口/服务端/BankBegin|BankBegin]]
| <code>BankBegin(sceneId, selfId, targetId)</code> 通知客户端开始进行银行交易 脚本中 3 处调用
|-
| [[Lua接口/服务端/BankOpt|BankOpt]]
| <code>BankOpt(sceneId, selfId, targetId, pszOptType)</code> 执行钱庄保险箱操作。 脚本中 1 处调用
|-
| [[Lua接口/服务端/CallScriptFunction|CallScriptFunction]]
| <code>CallScriptFunction(scriptId, funcname, sceneId, ...)</code> 调用可变参数的任意脚本函数 脚本中 7362 处调用
|-
| [[Lua接口/服务端/CheckAccountSafe|CheckAccountSafe]]
| <code>CheckAccountSafe(sceneId, selfId)</code> 返回账号安全标志；未设置时通知客户端显示安全提示。 脚本中 1 处调用
|-
| [[Lua接口/服务端/CheckActiviyValidity|CheckActiviyValidity]]
| <code>CheckActiviyValidity(sceneId, uActivityId)</code> 检查活动是否仍处于配表定义的有效时间。 脚本中 23 处调用
|-
| [[Lua接口/服务端/CheckTimer|CheckTimer]]
| <code>CheckTimer(sceneId, TimeIndex)</code> 判断TimeIndex号计时器是否已经在使用中 脚本中 4 处调用
|-
| [[Lua接口/服务端/DarkBoxItemDropRandom|DarkBoxItemDropRandom]]
| <code>DarkBoxItemDropRandom(arg1, arg2, randomBase)</code> 按传入的随机位置查询暗箱掉落物品编号及公告标志。 脚本中 4 处调用
|-
| [[Lua接口/服务端/DeleteTitle|DeleteTitle]]
| <code>DeleteTitle(sceneId, selfId, TitleIndex)</code> 删除某个称号 脚本中 6 处调用
|-
| [[Lua接口/服务端/DispatchAllTitle|DispatchAllTitle]] [[Lua接口/服务端/LuaFnDispatchAllTitle|LuaFnDispatchAllTitle]]
| <code>DispatchAllTitle(sceneId, selfId)</code> 更新此人的所有称号 脚本中 51 处调用
|-
| [[Lua接口/服务端/EnableBankRentIndex|EnableBankRentIndex]]
| <code>EnableBankRentIndex(sceneId, selfId, RentIndex)</code> 打开此人的租赁箱 脚本中 2 处调用
|-
| [[Lua接口/服务端/GetActivityParam|GetActivityParam]]
| <code>GetActivityParam(sceneId, uActivityId, uIndex)</code> 读取活动的脚本参数槽。 脚本中 61 处调用
|-
| [[Lua接口/服务端/GetActivityState|GetActivityState]]
| <code>GetActivityState(sceneId, uActivityId)</code> 返回活动状态：0 到 4，活动不存在时返回 -1。 脚本中 3 处调用
|-
| [[Lua接口/服务端/GetBaibaoshuxiaItemDropBase|GetBaibaoshuxiaItemDropBase]]
| <code>GetBaibaoshuxiaItemDropBase(arg1, arg2)</code> 读取百宝书匣掉落表的随机基数。 脚本中 1 处调用
|-
| [[Lua接口/服务端/GetBankRentIndex|GetBankRentIndex]]
| <code>GetBankRentIndex(sceneId, selfId)</code> 获得当前租赁箱已打开的索引 脚本中 3 处调用
|-
| [[Lua接口/服务端/GetCoupleID|GetCoupleID]]
| <code>GetCoupleID(sceneId, selfId)</code> 读取当前可用的双人活动搭档对象 ID。 脚本中 4 处调用
|-
| [[Lua接口/服务端/GetCoupleQuestionState|GetCoupleQuestionState]]
| <code>GetCoupleQuestionState(sceneId, selfId)</code> 读取双人答题是否开始、题数、当前进度、默契值等状态。 脚本中 5 处调用
|-
| [[Lua接口/服务端/GetCurCoupleQuestion|GetCurCoupleQuestion]]
| <code>GetCurCoupleQuestion(sceneId, selfId)</code> 读取双人答题的当前题号、选项数和答案。 脚本中 2 处调用
|-
| [[Lua接口/服务端/GetCurTitle|GetCurTitle]]
| <code>GetCurTitle(sceneId, selfId)</code> 返回当前显示称号的原始类型值。 脚本中 1 处调用
|-
| [[Lua接口/服务端/GetDarkBoxItemDropCount|GetDarkBoxItemDropCount]]
| <code>GetDarkBoxItemDropCount(arg1, arg2)</code> 读取暗箱掉落表的随机基数。 脚本中 4 处调用
|-
| [[Lua接口/服务端/GetDayTime|GetDayTime]]
| <code>GetDayTime()</code> 取得当前时间的天数，例如:1140 表示2001年的第140天 脚本中 149 处调用
|-
| [[Lua接口/服务端/GetDist|GetDist]]
| <code>GetDist(sceneId, selfId, targetId, arg4)</code> 得到selfId和targetId之间的距离 脚本中未见调用
|-
| [[Lua接口/服务端/GetDyTitlesNum|GetDyTitlesNum]]
| <code>GetDyTitlesNum(sceneId, selfId)</code> 获得此人的动态称号个数 脚本中未见调用
|-
| [[Lua接口/服务端/GetGameTime|GetGameTime]]
| <code>GetGameTime(sceneId, selfId)</code> 获取当前玩家在线时间，单位为秒 脚本中 3 处调用
|-
| [[Lua接口/服务端/GetGuildContriTitle|GetGuildContriTitle]]
| <code>GetGuildContriTitle(sceneId, selfId)</code> 获取帮会贡献称号字符串。 脚本中 3 处调用
|-
| [[Lua接口/服务端/GetHour|GetHour]]
| <code>GetHour()</code> 返回当前小时，范围为 0 到 23。 脚本中 43 处调用
|-
| [[Lua接口/服务端/GetHourTime|GetHourTime]]
| <code>GetHourTime()</code> 返回旧脚本使用的时间编码：以 2007-01-01（东八区零点）为基准的天数乘以 100，再加当天的刻钟编号。 脚本中 5 处调用
|-
| [[Lua接口/服务端/GetHumanMaxLevelLimit|GetHumanMaxLevelLimit]]
| <code>GetHumanMaxLevelLimit()</code> 返回玩家等级表允许的脚本等级上界。 脚本中 71 处调用
|-
| [[Lua接口/服务端/GetJuBaoContainerItemDropCount|GetJuBaoContainerItemDropCount]]
| <code>GetJuBaoContainerItemDropCount(arg1, arg2)</code> 读取聚宝盆掉落表的随机基数。 脚本中 2 处调用
|-
| [[Lua接口/服务端/GetMinute|GetMinute]]
| <code>GetMinute()</code> 返回当前分钟，范围为 0 到 59。 脚本中 41 处调用
|-
| [[Lua接口/服务端/GetObjCreateTime|GetObjCreateTime]]
| <code>GetObjCreateTime(sceneId, selfId)</code> 取得ObjID 为 selfId的obj的创建时间 脚本中 6 处调用
|-
| [[Lua接口/服务端/GetQHYTitle|GetQHYTitle]]
| <code>GetQHYTitle(sceneId, selfId)</code> 获取群雄逐鹿称号字符串。 脚本中 2 处调用
|-
| [[Lua接口/服务端/GetQuarterTime|GetQuarterTime]]
| <code>GetQuarterTime()</code> 返回 15 分钟时间片编号。 脚本中 46 处调用
|-
| [[Lua接口/服务端/GetShimenTitle|GetShimenTitle]]
| <code>GetShimenTitle(sceneId, selfId)</code> 获取门派称号字符串。 脚本中 1 处调用
|-
| [[Lua接口/服务端/GetTime2Day|GetTime2Day]]
| <code>GetTime2Day()</code> 返回当前日期的 YYYYMMDD 数值。 脚本中 47 处调用
|-
| [[Lua接口/服务端/GetTitle|GetTitle]]
| <code>GetTitle(sceneId, selfId, TitleIndex)</code> 获得此人的某个称号 脚本中 10 处调用
|-
| [[Lua接口/服务端/GetTodayDate|GetTodayDate]]
| <code>GetTodayDate()</code> 返回当前日期在本月中的日号。 脚本中 13 处调用
|-
| [[Lua接口/服务端/GetTodayMonth|GetTodayMonth]]
| <code>GetTodayMonth()</code> 返回当前月份索引，范围为 0 到 11。 脚本中 13 处调用
|-
| [[Lua接口/服务端/GetTodayWeek|GetTodayWeek]]
| <code>GetTodayWeek()</code> 返回当前星期索引，星期日为 0。 脚本中 27 处调用
|-
| [[Lua接口/服务端/GetTodayYear|GetTodayYear]]
| <code>GetTodayYear()</code> 返回当前四位公历年份。 脚本中 2 处调用
|-
| [[Lua接口/服务端/GetWeekTime|GetWeekTime]]
| <code>GetWeekTime()</code> 返回年份和周序号组合值。 脚本中 11 处调用
|-
| [[Lua接口/服务端/GetZhuanDanItemDropCount|GetZhuanDanItemDropCount]]
| <code>GetZhuanDanItemDropCount(arg1, arg2, type)</code> 读取指定类型宝箱掉落表的随机基数。 脚本中 30 处调用
|-
| [[Lua接口/服务端/HitParadeGetPlyInfo|HitParadeGetPlyInfo]]
| <code>HitParadeGetPlyInfo(sceneId, tabId, plyId)</code> 读取排行榜指定条目的角色标识和排序键。 脚本中 2 处调用
|-
| [[Lua接口/服务端/HitParadeGetTabInfo|HitParadeGetTabInfo]]
| <code>HitParadeGetTabInfo(sceneId, tabId)</code> 查询排行榜中的角色数量。 脚本中 1 处调用
|-
| [[Lua接口/服务端/HitParadeGetTabParam|HitParadeGetTabParam]]
| <code>HitParadeGetTabParam(sceneId, tabId, paramId)</code> 读取排行榜的扩展参数。 脚本中 9 处调用
|-
| [[Lua接口/服务端/HitParadePlayerJoin|HitParadePlayerJoin]]
| <code>HitParadePlayerJoin(sceneId, tabId, guid, key)</code> 把指定角色 GUID 和排序键加入排行榜。 脚本中 2 处调用
|-
| [[Lua接口/服务端/HitParadeRegisterTab|HitParadeRegisterTab]]
| <code>HitParadeRegisterTab(sceneId)</code> 为当前场景创建排行榜，返回排行榜编号。 脚本中 1 处调用
|-
| [[Lua接口/服务端/HitParadeReleaseTab|HitParadeReleaseTab]]
| <code>HitParadeReleaseTab(sceneId, tabId)</code> 释放指定排行榜。 脚本中 1 处调用
|-
| [[Lua接口/服务端/HitParadeSetTabParam|HitParadeSetTabParam]]
| <code>HitParadeSetTabParam(sceneId, tabId, paramId, paramValue)</code> 设置排行榜的扩展参数。 脚本中 9 处调用
|-
| [[Lua接口/服务端/HitParadeSort|HitParadeSort]]
| <code>HitParadeSort(sceneId, tabId)</code> 重新排序指定排行榜。 脚本中 1 处调用
|-
| [[Lua接口/服务端/IsInDist|IsInDist]]
| <code>IsInDist(sceneId, selfId, targetId, dist)</code> 判断selfId与targetId之间的距离是否在dist内(包括) 脚本中 5 处调用
|-
| [[Lua接口/服务端/IsPermitAreetAddMenpai|IsPermitAreetAddMenpai]]
| <code>IsPermitAreetAddMenpai()</code> 读取加入帮派公告的配置开关；函数名称保留原有拼写。 脚本中 1 处调用
|-
| [[Lua接口/服务端/IsSameMAC|IsSameMAC]]
| <code>IsSameMAC(sceneId, selfId, otherId)</code> 比较两名玩家记录的 MAC 标识是否相同。 脚本中 1 处调用
|-
| [[Lua接口/服务端/JuBaoContainerItemDropRandom|JuBaoContainerItemDropRandom]]
| <code>JuBaoContainerItemDropRandom(arg1, arg2, randomBase)</code> 按传入的随机位置查询聚宝盆掉落物品编号及公告标志。 脚本中 2 处调用
|-
| [[Lua接口/服务端/LuaFnGetCurrentTime|LuaFnGetCurrentTime]]
| <code>LuaFnGetCurrentTime()</code> 获取当前时间，单位为秒 脚本中 127 处调用
|-
| [[Lua接口/服务端/LuaFnGetCurrentWorldTime|LuaFnGetCurrentWorldTime]]
| <code>LuaFnGetCurrentWorldTime()</code> 返回世界服务器同步的当前十二时辰索引。 脚本中 2 处调用
|-
| [[Lua接口/服务端/LuaFnGetDayOfThisMonth|LuaFnGetDayOfThisMonth]]
| <code>LuaFnGetDayOfThisMonth()</code> 返回当前日期在本月中的日号，范围 1 到 31。 脚本中 41 处调用
|-
| [[Lua接口/服务端/LuaFnGetGemCarveInfo|LuaFnGetGemCarveInfo]]
| <code>LuaFnGetGemCarveInfo(gemId)</code> 返回雕琢产物、所需物品和金钱；无配置时返回 -1。 脚本中 1 处调用
|-
| [[Lua接口/服务端/LuaFnGetGemMeltingInfo|LuaFnGetGemMeltingInfo]]
| <code>LuaFnGetGemMeltingInfo(gemId)</code> 返回熔炼产物、主所需物品、金钱和替代物品；无配置时返回 -1。 脚本中 1 处调用
|-
| [[Lua接口/服务端/LuaFnGetGuildName|LuaFnGetGuildName]]
| <code>LuaFnGetGuildName(sceneId, selfId)</code> 获取玩家当前帮会名称。 脚本中 15 处调用
|-
| [[Lua接口/服务端/LuaFnGetThisMonth|LuaFnGetThisMonth]]
| <code>LuaFnGetThisMonth()</code> 返回当前月份，遵循 tm 结构约定，范围为 0 到 11。 脚本中 23 处调用
|-
| [[Lua接口/服务端/LuaFnGetThisYear|LuaFnGetThisYear]]
| <code>LuaFnGetThisYear()</code> 返回当前公历年份，例如 2026。 脚本中 14 处调用
|-
| [[Lua接口/服务端/LuaFnGetWorldGlobalData|LuaFnGetWorldGlobalData]]
| <code>LuaFnGetWorldGlobalData(index)</code> 读取世界全局数值变量，索引范围为 0 到 53。 脚本中 5 处调用
|-
| [[Lua接口/服务端/LuaFnGetWorldID|LuaFnGetWorldID]]
| <code>LuaFnGetWorldID()</code> 返回当前游戏世界编号。 脚本中未见调用
|-
| [[Lua接口/服务端/LuaFnGetZhuanDanIndex|LuaFnGetZhuanDanIndex]]
| <code>LuaFnGetZhuanDanIndex(itemId)</code> 按转蛋物品编号返回基础表索引，不存在时返回 -1。 脚本中 2 处调用
|-
| [[Lua接口/服务端/LuaFnGetZhuanDanInfo|LuaFnGetZhuanDanInfo]]
| <code>LuaFnGetZhuanDanInfo(typeIndex)</code> 按权重抽取转蛋产物，并按配置返回公告模板。 脚本中 1 处调用
|-
| [[Lua接口/服务端/LuaFnGetZhuandanSpace|LuaFnGetZhuandanSpace]]
| <code>LuaFnGetZhuandanSpace(typeIndex)</code> 返回转蛋所需的道具、材料和任务背包空间。 脚本中 1 处调用
|-
| [[Lua接口/服务端/LuaFnGuid2ObjId|LuaFnGuid2ObjId]]
| <code>LuaFnGuid2ObjId(sceneId, guid)</code> 把Guid转换为objId 脚本中 110 处调用
|-
| [[Lua接口/服务端/LuaFnIsPasswordSetup|LuaFnIsPasswordSetup]]
| <code>LuaFnIsPasswordSetup(sceneId, selfId, flag)</code> 判断玩家是否设置二级密码，0 为未设置，1 为已设置 脚本中 5 处调用
|-
| [[Lua接口/服务端/LuaFnIsPasswordUnlocked|LuaFnIsPasswordUnlocked]]
| <code>LuaFnIsPasswordUnlocked(sceneId, selfId, flag)</code> 判断玩家是否解锁二级密码，0 为未解锁，1 为已解锁 脚本中 2 处调用
|-
| [[Lua接口/服务端/LuaFnObjId2Guid|LuaFnObjId2Guid]]
| <code>LuaFnObjId2Guid(sceneId, selfId)</code> 返回selfId的GUID 脚本中 189 处调用
|-
| [[Lua接口/服务端/LuaFnSendGuajiQuestion|LuaFnSendGuajiQuestion]]
| <code>LuaFnSendGuajiQuestion(sceneId, selfId)</code> 向指定玩家发送不发放金钱奖励的挂机验证码。 脚本中 5 处调用
|-
| [[Lua接口/服务端/LuaFnSendOpResult|LuaFnSendOpResult]]
| <code>LuaFnSendOpResult(sceneId, selfId, resultCode)</code> 向指定玩家发送操作结果提示，成功不返回 Lua 值。 脚本中 4 处调用
|-
| [[Lua接口/服务端/LuaFnSetWorldGlobalData|LuaFnSetWorldGlobalData]]
| <code>LuaFnSetWorldGlobalData(index, value)</code> 设置世界全局数值变量并同步，索引范围为 0 到 53。 脚本中 2 处调用
|-
| [[Lua接口/服务端/LuaFnUpdateAttr|LuaFnUpdateAttr]]
| <code>LuaFnUpdateAttr(sceneId, selfId, arg3, param1, param2, param3)</code> 通过邮件系统更新人物属性 脚本中 1 处调用
|-
| [[Lua接口/服务端/mytime|mytime]]
| <code>mytime()</code> 返回当前 ANSI 时间戳。 脚本中未见调用
|-
| [[Lua接口/服务端/NextCoupleQuestion|NextCoupleQuestion]]
| <code>NextCoupleQuestion(sceneId, selfId, currentPos, privity, sameNum)</code> 更新双人答题进度、默契值和相同答案次数。 脚本中 2 处调用
|-
| [[Lua接口/服务端/OpenWorldReference|OpenWorldReference]]
| <code>OpenWorldReference(sceneId, selfId, pParam)</code> 通知客户端打开江湖指南的指定页面。 脚本中未见调用
|-
| [[Lua接口/服务端/PrintNum|PrintNum]]
| <code>PrintNum(num)</code> 弹出消息框,测试脚本用 脚本中未见调用
|-
| [[Lua接口/服务端/PrintStr|PrintStr]]
| <code>PrintStr(strText)</code> 弹出消息框,测试脚本用 脚本中 17 处调用
|-
| [[Lua接口/服务端/ResetChallengeData|ResetChallengeData]] [[Lua接口/服务端/LuaFnResetChallengeData|LuaFnResetChallengeData]]
| <code>ResetChallengeData(sceneId, selfId)</code> 重置玩家挑战相关记录。 脚本中 4 处调用
|-
| [[Lua接口/服务端/SetActivityParam|SetActivityParam]]
| <code>SetActivityParam(sceneId, uActivityId, uIndex, iValue)</code> 写入活动的脚本参数槽。 脚本中 85 处调用
|-
| [[Lua接口/服务端/SetCharacterDieTime|SetCharacterDieTime]]
| <code>SetCharacterDieTime(sceneId, selfId, nTime)</code> 设置 Character的消失时间, 只对Monster和Pet有效 脚本中 79 处调用
|-
| [[Lua接口/服务端/SetCharacterTimer|SetCharacterTimer]]
| <code>SetCharacterTimer(sceneId, selfId, nTime)</code> 设置 Character的时钟间隔，如果是0则，停止时钟 脚本中 10 处调用
|-
| [[Lua接口/服务端/SetCurCoupleQuestion|SetCurCoupleQuestion]]
| <code>SetCurCoupleQuestion(sceneId, selfId, question, maxAnswer, answer)</code> 设置双人答题的当前题号、选项数和答案。 脚本中 2 处调用
|-
| [[Lua接口/服务端/SetCurTitle|SetCurTitle]]
| <code>SetCurTitle(sceneId, selfId, titleType, titleIndex)</code> 设置当前显示称号。脚本类型 1 到 5 映射到称号类型 2 到 6。 脚本中 30 处调用
|-
| [[Lua接口/服务端/SetPlayerDefaultReliveInfo|SetPlayerDefaultReliveInfo]]
| <code>SetPlayerDefaultReliveInfo(sceneId, selfId, pszHP, pszMP, pszSP, defaultSceneID, defaultPosX, defaultPosZ)</code> 玩家的缺省复活相关的数据设置 脚本中 54 处调用
|-
| [[Lua接口/服务端/SetPlayerDefaultReliveInfoEx|SetPlayerDefaultReliveInfoEx]]
| <code>SetPlayerDefaultReliveInfoEx(sceneId, selfId, pszHP, pszMP, pszSP, defaultSceneID, defaultPosX, defaultPosZ, scriptId)</code> 设置玩家默认复活的生命、气、怒气、场景、位置及关联脚本。 脚本中 4 处调用
|-
| [[Lua接口/服务端/SetQHYTitle|SetQHYTitle]]
| <code>SetQHYTitle(sceneId, selfId, title)</code> 设置群雄逐鹿称号字符串。 脚本中 1 处调用
|-
| [[Lua接口/服务端/SetShimenTitle|SetShimenTitle]]
| <code>SetShimenTitle(sceneId, selfId, title)</code> 设置门派称号字符串。 脚本中 2 处调用
|-
| [[Lua接口/服务端/SetTimer|SetTimer]]
| <code>SetTimer(sceneId, selfId, scriptId, funcName, tickTime)</code> 给玩家打开计时器,时间到时将自动调用OnTimer函数 脚本中 9 处调用
|-
| [[Lua接口/服务端/StartCoupleQuestion|StartCoupleQuestion]]
| <code>StartCoupleQuestion(sceneId, selfId, targetId, npcId, maxQuestionNum)</code> 设置搭档、NPC 和题数，开始玩家的双人答题流程。 脚本中 2 处调用
|-
| [[Lua接口/服务端/StartOneActivity|StartOneActivity]]
| <code>StartOneActivity(sceneId, uActivityId, uInterval, iNoticeType)</code> 在当前场景启动一个活动实例及其周期计时器。 脚本中 29 处调用
|-
| [[Lua接口/服务端/StopCoupleQuestion|StopCoupleQuestion]]
| <code>StopCoupleQuestion(sceneId, selfId)</code> 清空并停止玩家的双人答题流程。 脚本中 4 处调用
|-
| [[Lua接口/服务端/StopOneActivity|StopOneActivity]]
| <code>StopOneActivity(sceneId, uActivityId)</code> 关闭当前场景中的指定活动。 脚本中 27 处调用
|-
| [[Lua接口/服务端/StopTimer|StopTimer]]
| <code>StopTimer(sceneId, sceneTimerIndex)</code> 关闭当前玩家的计时器 //每个玩家身上最多可以绑定三个计时器 脚本中 3 处调用
|-
| [[Lua接口/服务端/ZhuanDanItemDropRandom|ZhuanDanItemDropRandom]]
| <code>ZhuanDanItemDropRandom(arg1, arg2, randomBase, type)</code> 按宝箱类型和随机位置查询掉落物品编号及公告标志。 脚本中 30 处调用
|}
</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix CriticalDefebce

2026-09-19T16:16:24Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的会心防御修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_CriticalDefebce(sceneId, monsterId, value)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix CriticalDefence

2026-09-19T16:16:24Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的会心防御修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_CriticalDefence(sceneId, monsterId)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix CriticalAttack

2026-09-19T16:16:24Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的会心攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_CriticalAttack(sceneId, monsterId, value)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>monsterId</code>
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。 脚本中的实参：<code>LuaFnGetBaseCriticalAttack(sceneId, monsterId) *</code>
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix CriticalAttack

2026-09-19T16:16:23Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的会心攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_CriticalAttack(sceneId, monsterId)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix Miss

2026-09-19T16:16:23Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的闪避修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_Miss(sceneId, monsterId, value)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix Miss

2026-09-19T16:16:23Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的闪避修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_Miss(sceneId, monsterId)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix Hit

2026-09-19T16:16:23Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的命中修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_Hit(sceneId, monsterId, value)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix Hit

2026-09-19T16:16:22Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的命中修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_Hit(sceneId, monsterId)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix ResistPoison

2026-09-19T16:16:22Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的毒抗修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_ResistPoison(sceneId, monsterId, value)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>MonsterId</code>
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。 脚本中的实参：<code>LuaFnGetLifeTimeAttrRefix_ResistPoison(sceneId, </code>
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix ResistPoison

2026-09-19T16:16:22Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的毒抗修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_ResistPoison(sceneId, monsterId)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>MonsterId</code>
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix AttackPoison

2026-09-19T16:16:21Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的毒攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_AttackPoison(sceneId, monsterId, value)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix AttackPoison

2026-09-19T16:16:21Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的毒攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_AttackPoison(sceneId, monsterId)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix ResistLight

2026-09-19T16:16:21Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的玄抗修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_ResistLight(sceneId, monsterId, value)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>MonsterId</code>
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。 脚本中的实参：<code>LuaFnGetLifeTimeAttrRefix_ResistLight(sceneId, M</code>
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix ResistLight

2026-09-19T16:16:21Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的玄抗修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_ResistLight(sceneId, monsterId)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>MonsterId</code>
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix AttackLight

2026-09-19T16:16:20Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的玄攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_AttackLight(sceneId, monsterId, value)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix AttackLight

2026-09-19T16:16:20Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的玄攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_AttackLight(sceneId, monsterId)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix ResistFire

2026-09-19T16:16:20Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的火抗修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_ResistFire(sceneId, monsterId, value)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix ResistFire

2026-09-19T16:16:19Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的火抗修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_ResistFire(sceneId, monsterId)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>MonsterId</code>
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix AttackFire

2026-09-19T16:16:19Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的火攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_AttackFire(sceneId, monsterId, value)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>MonsterId</code>
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。 脚本中的实参：<code>LuaFnGetLifeTimeAttrRefix_ResistFire(sceneId, Mo</code>
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix AttackFire

2026-09-19T16:16:19Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的火攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_AttackFire(sceneId, monsterId)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix ResistCold

2026-09-19T16:16:19Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的冰抗修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_ResistCold(sceneId, monsterId, value)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>MonsterId</code>
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。 脚本中的实参：<code>LuaFnGetLifeTimeAttrRefix_ResistCold(sceneId, Mo</code>
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix ResistCold

2026-09-19T16:16:18Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的冰抗修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_ResistCold(sceneId, monsterId)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>MonsterId</code>
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix AttackCold

2026-09-19T16:16:18Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的冰攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_AttackCold(sceneId, monsterId, value)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix AttackCold

2026-09-19T16:16:18Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的冰攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_AttackCold(sceneId, monsterId)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix DefenceMagic

2026-09-19T16:16:17Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的内功防御修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_DefenceMagic(sceneId, monsterId, value)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（2 处）
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>monsterId</code>（2 处）
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。 脚本中的实参：<code>mDefense</code>（2 处）
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix DefenceMagic

2026-09-19T16:16:17Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的内功防御修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_DefenceMagic(sceneId, monsterId)</pre>

服务端脚本中共出现 2 处调用，实参个数出现过：2 个（2 处）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（2 处）
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>monsterId</code>（2 处）
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix AttackMagic

2026-09-19T16:16:17Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的内功攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_AttackMagic(sceneId, monsterId, value)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix AttackMagic

2026-09-19T16:16:16Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的内功攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_AttackMagic(sceneId, monsterId)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix DefencePhysics

2026-09-19T16:16:16Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的外功防御修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_DefencePhysics(sceneId, monsterId, value)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（2 处）
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>monsterId</code>（2 处）
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。 脚本中的实参：<code>pDefense</code>（2 处）
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix DefencePhysics

2026-09-19T16:16:16Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的外功防御修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_DefencePhysics(sceneId, monsterId)</pre>

服务端脚本中共出现 2 处调用，实参个数出现过：2 个（2 处）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（2 处）
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>monsterId</code>（2 处）
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix AttackPhysics

2026-09-19T16:16:15Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的外功攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_AttackPhysics(sceneId, monsterId, value)</pre>

服务端脚本中共出现 3 处调用，实参个数出现过：3 个（3 处）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（3 处）
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>monsterId</code>（3 处）
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。 脚本中的实参：<code>pAttack</code>（2 处）、<code>LuaFnGetBaseAttackPhysics(sceneId, monsterId) * </code>
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

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

-- event/xunhuan/event_renwulian_fuben.lua
LuaFnSetLifeTimeAttrRefix_AttackPhysics(sceneId, monsterId, LuaFnGetBaseAttackPhysics(sceneId, monsterId) * )</pre>

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix AttackPhysics

2026-09-19T16:16:15Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的外功攻击修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_AttackPhysics(sceneId, monsterId)</pre>

服务端脚本中共出现 2 处调用，实参个数出现过：2 个（2 处）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（2 处）
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>monsterId</code>（2 处）
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/LuaFnSetLifeTimeAttrRefix MaxHP

2026-09-19T16:16:15Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物本次存活期间的生命上限修正值。</div>

== Lua 调用 ==
<pre>LuaFnSetLifeTimeAttrRefix_MaxHP(sceneId, monsterId, value)</pre>

服务端脚本中共出现 4 处调用，实参个数出现过：3 个（4 处）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（4 处）
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>monsterId</code>（4 处）
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。 脚本中的实参：<code>maxHP</code>（3 处）、<code>LuaFnGetMaxBaseHp(sceneId, monsterId) * refixRat</code>
|}

== 返回值 ==
找到怪物并写入后返回 1；未找到等路径返回 0，异常路径无返回值。

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

-- event/xunhuan/event_renwulian_fuben.lua
LuaFnSetLifeTimeAttrRefix_MaxHP(sceneId, monsterId, LuaFnGetMaxBaseHp(sceneId, monsterId) * refixRat)</pre>

</div>

Lua接口/服务端/LuaFnGetLifeTimeAttrRefix MaxHP

2026-09-19T16:16:15Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">读取怪物本次存活期间的生命上限修正值。</div>

== Lua 调用 ==
<pre>LuaFnGetLifeTimeAttrRefix_MaxHP(sceneId, monsterId)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（3 处）
|-
| 2
| <code>monsterId</code> <code>number</code>
| 怪物的场景对象 ID。 脚本中的实参：<code>monsterId</code>（3 处）
|}

== 返回值 ==
返回修正数值。未找到怪物等路径返回 0，异常路径无返回值。

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

</div>

Lua接口/服务端/WithDrawFreeDoubleExpTime

2026-09-19T16:16:14Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">消耗三类免费领取次数，并将对应小时数加入免费双倍经验时间。</div>

同一接口的其他调用名称：<code>LuaFnWithDrawFreeDoubleExpTime</code>。

== Lua 调用 ==
<pre>WithDrawFreeDoubleExpTime(sceneId, selfId, value, valueCity, valueOther)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（2 处）
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：<code>selfId</code>（2 处）
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。 脚本中的实参：<code>0</code>、<code>nPoint</code>
|-
| 4
| <code>valueCity</code> <code>number</code>
| 城市相关数值。 脚本中的实参：<code>0</code>、<code>nPoint</code>
|-
| 5
| <code>valueOther</code> <code>number</code>
| 其他相关数值。 脚本中的实参：<code>0</code>（2 处）
|}

== 返回值 ==
返回 1 个值。返回类型包括 <code>number</code>。明确的固定返回组合包括 <code>1</code>；<code>0</code>。

== 脚本中的调用 ==
以下是服务端脚本里的真实调用点，按实参形态去重后列出 2 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。
<pre>-- obj/city/pc_militaryofficer.lua
WithDrawFreeDoubleExpTime(sceneId, selfId, 0, nPoint, 0)

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

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

</div>

Lua接口/服务端/DEResetWeeklyFreeTime

2026-09-19T16:16:14Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">重置玩家每周免费双倍经验时间。</div>

同一接口的其他调用名称：<code>LuaFnDEResetWeeklyFreeTime</code>。

== Lua 调用 ==
<pre>DEResetWeeklyFreeTime(sceneId, selfId)</pre>

服务端脚本中共出现 2 处调用，实参个数出现过：2 个（2 处）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（2 处）
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：<code>selfId</code>（2 处）
|}

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

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

== 注意事项 ==
* 调用对象必须是当前场景中的有效玩家。
* 调用前要求玩家处于可执行逻辑的状态（实现体断言 <code>pHuman->IsCanLogic()</code>）；不满足时会记录断言，应先确认玩家当前状态。

</div>

Lua接口/服务端/SendDoubleExpToClient

2026-09-19T16:16:14Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">将当前双倍经验状态同步给客户端。</div>

== Lua 调用 ==
<pre>SendDoubleExpToClient(sceneId, selfId)</pre>

服务端脚本中共出现 7 处调用，实参个数出现过：2 个（7 处）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（7 处）
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：<code>selfId</code>（7 处）
|}

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

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

== 注意事项 ==
* 调用对象必须是当前场景中的有效玩家。
* 调用前要求玩家处于可执行逻辑的状态（实现体断言 <code>pHuman->IsCanLogic()</code>）；不满足时会记录断言，应先确认玩家当前状态。

</div>

Lua接口/服务端/DESetCount

2026-09-19T16:16:13Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置三类免费双倍经验领取次数，并记录变更前后状态。</div>

== Lua 调用 ==
<pre>DESetCount(sceneId, selfId, value, valueCity, valueOther)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。
|-
| 4
| <code>valueCity</code> <code>number</code>
| 城市相关数值。
|-
| 5
| <code>valueOther</code> <code>number</code>
| 其他相关数值。
|}

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

== 注意事项 ==
* 调用对象必须是当前场景中的有效玩家。
* 调用前要求玩家处于可执行逻辑的状态（实现体断言 <code>pHuman->IsCanLogic()</code>）；不满足时会记录断言，应先确认玩家当前状态。
* 实现体检查 <code>nRet</code>，不满足时记录断言「[LuaFnDESetFreeTime]: Need larger szBefore」。
* 实现体检查 <code>nRet</code>，不满足时记录断言「[LuaFnDESetFreeTime]: Need larger szAfter」。

</div>

Lua接口/服务端/DEGetCount

2026-09-19T16:16:13Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">返回三类免费双倍经验领取次数。</div>

== Lua 调用 ==
<pre>DEGetCount(sceneId, selfId)</pre>

服务端脚本中共出现 7 处调用，实参个数出现过：2 个（7 处）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（7 处）
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：<code>selfId</code>（7 处）
|}

== 返回值 ==
根据执行分支，返回数量可能为 0、3 个（0 个表示无返回值）。返回类型包括 <code>number</code>。明确的固定返回组合包括 <code>0, 0, 0</code>。

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

== 注意事项 ==
* 调用对象必须是当前场景中的有效玩家。
* 调用前要求玩家处于可执行逻辑的状态（实现体断言 <code>pHuman->IsCanLogic()</code>）；不满足时会记录断言，应先确认玩家当前状态。

</div>

Lua接口/服务端/DESetPreTime

2026-09-19T16:16:13Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置玩家上一次双倍经验刷新时间。</div>

== Lua 调用 ==
<pre>DESetPreTime(sceneId, selfId, nTime)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。
|-
| 3
| <code>nTime</code> <code>number</code>
| 时间数值；单位以本接口说明为准。
|}

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

== 注意事项 ==
* 调用对象必须是当前场景中的有效玩家。
* 调用前要求玩家处于可执行逻辑的状态（实现体断言 <code>pHuman->IsCanLogic()</code>）；不满足时会记录断言，应先确认玩家当前状态。

</div>

Lua接口/服务端/DEGetPreTime

2026-09-19T16:16:13Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">返回玩家上一次双倍经验刷新时间。</div>

== Lua 调用 ==
<pre>DEGetPreTime(sceneId, selfId)</pre>

服务端脚本中共出现 2 处调用，实参个数出现过：2 个（2 处）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（2 处）
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：<code>selfId</code>（2 处）
|}

== 返回值 ==
返回 1 个值。返回类型包括 <code>number</code>。明确的固定返回组合包括 <code>0</code>。

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

== 注意事项 ==
* 调用对象必须是当前场景中的有效玩家。
* 调用前要求玩家处于可执行逻辑的状态（实现体断言 <code>pHuman->IsCanLogic()</code>）；不满足时会记录断言，应先确认玩家当前状态。

</div>

Lua接口/服务端/DESetMoneyTime

2026-09-19T16:16:12Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置玩家的付费双倍经验时间，并记录变更前后状态。</div>

== Lua 调用 ==
<pre>DESetMoneyTime(sceneId, selfId, value)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（2 处）
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：<code>selfId</code>（2 处）
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。 脚本中的实参：<code>nCurHaveTime + 3600</code>、<code>nCurHaveTime + 3600*5</code>
|}

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

== 脚本中的调用 ==
以下是服务端脚本里的真实调用点，按实参形态去重后列出 2 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。
<pre>-- obj/item/DoubleTime_Player.lua
DESetMoneyTime(sceneId, selfId, nCurHaveTime + 3600)

-- obj/item/DoubleTime_Player1.lua
DESetMoneyTime(sceneId, selfId, nCurHaveTime + 3600*5)</pre>

== 注意事项 ==
* 调用对象必须是当前场景中的有效玩家。
* 调用前要求玩家处于可执行逻辑的状态（实现体断言 <code>pHuman->IsCanLogic()</code>）；不满足时会记录断言，应先确认玩家当前状态。
* 实现体检查 <code>nRet</code>，不满足时记录断言「[LuaFnDESetMoneyTime]: Need larger szBefore」。
* 实现体检查 <code>nRet</code>，不满足时记录断言「[LuaFnDESetMoneyTime]: Need larger szAfter」。

</div>

Lua接口/服务端/DEGetMoneyTime

2026-09-19T16:16:12Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">返回玩家通过付费获得的双倍经验时间。</div>

== Lua 调用 ==
<pre>DEGetMoneyTime(sceneId, selfId)</pre>

服务端脚本中共出现 12 处调用，实参个数出现过：2 个（12 处）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（12 处）
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：<code>selfId</code>（11 处）、<code>memberId</code>
|}

== 返回值 ==
返回 1 个值。返回类型包括 <code>number</code>。明确的固定返回组合包括 <code>0</code>。

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

-- obj/city/pc_militaryofficer.lua
DEGetMoneyTime(sceneId, selfId)</pre>

== 注意事项 ==
* 调用对象必须是当前场景中的有效玩家。
* 调用前要求玩家处于可执行逻辑的状态（实现体断言 <code>pHuman->IsCanLogic()</code>）；不满足时会记录断言，应先确认玩家当前状态。

</div>

Lua接口/服务端/DESetLock

2026-09-19T16:16:12Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置玩家的双倍经验锁定状态，并记录变更前后状态。</div>

== Lua 调用 ==
<pre>DESetLock(sceneId, selfId, value)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（5 处）
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：<code>selfId</code>（5 处）
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。 脚本中的实参：<code>0</code>（4 处）、<code>1</code>
|}

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

== 脚本中的调用 ==
以下是服务端脚本里的真实调用点，按实参形态去重后列出 2 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。
<pre>-- obj/item/DoubleTime_Player.lua
DESetLock(sceneId, selfId, 0)

-- obj/luoyang/oluoyang_liujianming.lua
DESetLock(sceneId, selfId, 1)</pre>

== 注意事项 ==
* 调用对象必须是当前场景中的有效玩家。
* 调用前要求玩家处于可执行逻辑的状态（实现体断言 <code>pHuman->IsCanLogic()</code>）；不满足时会记录断言，应先确认玩家当前状态。
* 实现体检查 <code>nRet</code>，不满足时记录断言「[LuaFnDESetLock]: Need larger szBefore」。
* 实现体检查 <code>nRet</code>，不满足时记录断言「[LuaFnDESetLock]: Need larger szAfter」。

</div>

Lua接口/服务端/DEIsLock

2026-09-19T16:16:11Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">返回玩家的双倍经验锁定状态。</div>

== Lua 调用 ==
<pre>DEIsLock(sceneId, selfId)</pre>

服务端脚本中共出现 10 处调用，实参个数出现过：2 个（10 处）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（10 处）
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：<code>selfId</code>（9 处）、<code>memberId</code>
|}

== 返回值 ==
返回 1 个值。返回类型包括 <code>number</code>。明确的固定返回组合包括 <code>0</code>。

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

-- obj/city/pc_militaryofficer.lua
DEIsLock(sceneId, selfId)</pre>

== 注意事项 ==
* 调用对象必须是当前场景中的有效玩家。
* 调用前要求玩家处于可执行逻辑的状态（实现体断言 <code>pHuman->IsCanLogic()</code>）；不满足时会记录断言，应先确认玩家当前状态。

</div>

Lua接口/服务端/DESetFreeTime

2026-09-19T16:16:11Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置玩家的免费双倍经验时间，并记录变更前后状态。</div>

== Lua 调用 ==
<pre>DESetFreeTime(sceneId, selfId, value)</pre>

服务端脚本中未检索到该接口的调用点（已检索 4245 个随包脚本）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。
|-
| 3
| <code>value</code> <code>number</code>
| 要写入的数值。
|}

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

== 注意事项 ==
* 调用对象必须是当前场景中的有效玩家。
* 调用前要求玩家处于可执行逻辑的状态（实现体断言 <code>pHuman->IsCanLogic()</code>）；不满足时会记录断言，应先确认玩家当前状态。
* 实现体检查 <code>nRet</code>，不满足时记录断言「[LuaFnDESetFreeTime]: Need larger szBefore」。
* 实现体检查 <code>nRet</code>，不满足时记录断言「[LuaFnDESetFreeTime]: Need larger szAfter」。

</div>

Lua接口/服务端/DEGetFreeTime

2026-09-19T16:16:11Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">返回玩家当前剩余的免费双倍经验时间。</div>

== Lua 调用 ==
<pre>DEGetFreeTime(sceneId, selfId)</pre>

服务端脚本中共出现 11 处调用，实参个数出现过：2 个（11 处）。

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>（11 处）
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：<code>selfId</code>（10 处）、<code>memberId</code>
|}

== 返回值 ==
返回 1 个值。返回类型包括 <code>number</code>。明确的固定返回组合包括 <code>0</code>。

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

-- obj/city/pc_militaryofficer.lua
DEGetFreeTime(sceneId, selfId)</pre>

== 注意事项 ==
* 调用对象必须是当前场景中的有效玩家。
* 调用前要求玩家处于可执行逻辑的状态（实现体断言 <code>pHuman->IsCanLogic()</code>）；不满足时会记录断言，应先确认玩家当前状态。

</div>

Lua接口/服务端/SetPetCaptureProtect

2026-09-19T16:16:11Z

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

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品|角色属性与物品]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">设置怪物或宠物的捕捉保护角色 GUID。</div>

== Lua 调用 ==
<pre>SetPetCaptureProtect(sceneId, selfId, protectGuid)</pre>

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

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

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code> <code>number</code>
| 当前调用所在的场景 ID。 脚本中的实参：<code>sceneId</code>
|-
| 2
| <code>selfId</code> <code>number</code>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：<code>petObjID</code>
|-
| 3
| <code>protectGuid</code> <code>number</code>
| 保护归属角色 GUID。 脚本中的实参：<code>occupantGuid</code>
|}

== 返回值 ==
根据执行分支，返回数量可能为 0、1 个（0 个表示无返回值）。当前实现存在未设置结果值却返回结果的路径，不能把接收到的值当作成功标志。

== 脚本中的调用 ==
以下是服务端脚本里的真实调用点，按实参形态去重后列出 1 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。
<pre>-- obj/monster/petdropper.lua
SetPetCaptureProtect(sceneId, petObjID, occupantGuid)</pre>

== 注意事项 ==
* 调用对象必须是当前场景中的有效角色对象，可包括玩家、怪物或珍兽。

</div>