Lua接口/服务端函数索引/暗器：修订间差异
来自天龙知识库
跳到导航跳到搜索
整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明 |
维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例 |
||
| 第3行： | 第3行： | ||
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]] | [[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]] | ||
<div style="padding:14px 0;border-top:3px solid #287568;">暗器：19 个接口，19 | <div style="padding:14px 0;border-top:3px solid #287568;">暗器：19 个接口，19 个调用名称，其中 14 个在当前脚本中有调用。</div> | ||
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;" | {| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;" | ||
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;width:36%;" | 函数 / 别名 | ! scope="col" style="text-align:left;background:#edf3f2;padding:8px;width:36%;" | 函数 / 别名 | ||
| 第9行： | 第9行： | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/AdjustDarkAttrForBagItem|AdjustDarkAttrForBagItem]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/AdjustDarkAttrForBagItem|AdjustDarkAttrForBagItem]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">AdjustDarkAttrForBagItem(sceneId, selfId, nBagPos, nAttrIndex)</code><br />将背包暗器的一点指定附加属性随机转移到其他属性。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">AdjustDarkAttrForBagItem(sceneId, selfId, nBagPos, nAttrIndex)</code><br />将背包暗器的一点指定附加属性随机转移到其他属性。<br /><span style="color:#657078;">脚本中 1 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/AdjustDarkSkillForBagItem|AdjustDarkSkillForBagItem]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/AdjustDarkSkillForBagItem|AdjustDarkSkillForBagItem]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">AdjustDarkSkillForBagItem(sceneId, selfId, nBagPos)</code><br />重洗背包暗器的技能。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">AdjustDarkSkillForBagItem(sceneId, selfId, nBagPos)</code><br />重洗背包暗器的技能。<br /><span style="color:#657078;">脚本中 1 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DarkLevelUp|DarkLevelUp]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DarkLevelUp|DarkLevelUp]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DarkLevelUp(sceneId, selfId)</code><br />由 NPC 完成一次暗器突破。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DarkLevelUp(sceneId, selfId)</code><br />由 NPC 完成一次暗器突破。<br /><span style="color:#657078;">脚本中 1 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DarkOperateResult|DarkOperateResult]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DarkOperateResult|DarkOperateResult]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DarkOperateResult(sceneId, selfId, nOperateType, nSuccessType)</code><br />向客户端返回一次暗器操作结果。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DarkOperateResult(sceneId, selfId, nOperateType, nSuccessType)</code><br />向客户端返回一次暗器操作结果。<br /><span style="color:#657078;">脚本中 22 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkAttrForBagItem|GetDarkAttrForBagItem]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkAttrForBagItem|GetDarkAttrForBagItem]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkAttrForBagItem(sceneId, selfId, nBagPos, nAttrIndex)</code><br />取得背包暗器指定附加属性的数值。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkAttrForBagItem(sceneId, selfId, nBagPos, nAttrIndex)</code><br />取得背包暗器指定附加属性的数值。<br /><span style="color:#657078;">脚本中 1 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkCleanTimes|GetDarkCleanTimes]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkCleanTimes|GetDarkCleanTimes]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkCleanTimes(sceneId, selfId, nBagPos)</code><br />取得背包暗器已经洗过的属性次数。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkCleanTimes(sceneId, selfId, nBagPos)</code><br />取得背包暗器已经洗过的属性次数。<br /><span style="color:#657078;">脚本中 1 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkLevel|GetDarkLevel]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkLevel|GetDarkLevel]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkLevel(sceneId, selfId)</code><br />取得当前装备暗器的等级；未装备时返回 0。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkLevel(sceneId, selfId)</code><br />取得当前装备暗器的等级；未装备时返回 0。<br /><span style="color:#657078;">脚本中 5 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkQualityGrade|GetDarkQualityGrade]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkQualityGrade|GetDarkQualityGrade]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkQualityGrade(sceneId, selfId)</code><br />取得当前装备暗器的实际品阶。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkQualityGrade(sceneId, selfId)</code><br />取得当前装备暗器的实际品阶。<br /><span style="color:#a08a6a;">脚本中未见调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkQualityGradeFromTB|GetDarkQualityGradeFromTB]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkQualityGradeFromTB|GetDarkQualityGradeFromTB]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkQualityGradeFromTB(sceneId, selfId)</code><br />取得暗器配表中的初始品阶。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkQualityGradeFromTB(sceneId, selfId)</code><br />取得暗器配表中的初始品阶。<br /><span style="color:#a08a6a;">脚本中未见调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkSkillId|GetDarkSkillId]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkSkillId|GetDarkSkillId]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkSkillId(sceneId, selfId, nSkillIndex)</code><br />取得装备暗器某一阶段的技能编号。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkSkillId(sceneId, selfId, nSkillIndex)</code><br />取得装备暗器某一阶段的技能编号。<br /><span style="color:#a08a6a;">脚本中未见调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkTotalCleanTimes|GetDarkTotalCleanTimes]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkTotalCleanTimes|GetDarkTotalCleanTimes]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkTotalCleanTimes(sceneId, selfId, nBagPos)</code><br />取得背包暗器允许洗属性的总次数。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkTotalCleanTimes(sceneId, selfId, nBagPos)</code><br />取得背包暗器允许洗属性的总次数。<br /><span style="color:#657078;">脚本中 1 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/HaveDarkEquiped|HaveDarkEquiped]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/HaveDarkEquiped|HaveDarkEquiped]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">HaveDarkEquiped(sceneId, selfId)</code><br />是否装备了有效暗器。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">HaveDarkEquiped(sceneId, selfId)</code><br />是否装备了有效暗器。<br /><span style="color:#657078;">脚本中 2 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsDarkNeedLevelUpByNpcNow|IsDarkNeedLevelUpByNpcNow]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsDarkNeedLevelUpByNpcNow|IsDarkNeedLevelUpByNpcNow]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">IsDarkNeedLevelUpByNpcNow(sceneId, selfId)</code><br />判断暗器当前是否必须由 NPC 完成突破。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">IsDarkNeedLevelUpByNpcNow(sceneId, selfId)</code><br />判断暗器当前是否必须由 NPC 完成突破。<br /><span style="color:#657078;">脚本中 2 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsItemDark|IsItemDark]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsItemDark|IsItemDark]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">IsItemDark(sceneId, selfId, nItemSerial)</code><br />按物品配表编号判断该装备是否为暗器。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">IsItemDark(sceneId, selfId, nItemSerial)</code><br />按物品配表编号判断该装备是否为暗器。<br /><span style="color:#a08a6a;">脚本中未见调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/ResetDarkForBagItem|ResetDarkForBagItem]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/ResetDarkForBagItem|ResetDarkForBagItem]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">ResetDarkForBagItem(sceneId, selfId, nBagPos)</code><br />重置背包暗器的属性和技能。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">ResetDarkForBagItem(sceneId, selfId, nBagPos)</code><br />重置背包暗器的属性和技能。<br /><span style="color:#657078;">脚本中 1 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/ResetDarkQualityForBagItem|ResetDarkQualityForBagItem]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/ResetDarkQualityForBagItem|ResetDarkQualityForBagItem]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">ResetDarkQualityForBagItem(sceneId, selfId, nBagPos, nType)</code><br />按指定类型重洗背包暗器的品阶。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">ResetDarkQualityForBagItem(sceneId, selfId, nBagPos, nType)</code><br />按指定类型重洗背包暗器的品阶。<br /><span style="color:#657078;">脚本中 1 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetDarkCleanTimes|SetDarkCleanTimes]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetDarkCleanTimes|SetDarkCleanTimes]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">SetDarkCleanTimes(sceneId, selfId, nBagPos, nTimes)</code><br />设置背包暗器已经洗过的属性次数。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">SetDarkCleanTimes(sceneId, selfId, nBagPos, nTimes)</code><br />设置背包暗器已经洗过的属性次数。<br /><span style="color:#657078;">脚本中 1 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetDarkGainExpRate|SetDarkGainExpRate]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetDarkGainExpRate|SetDarkGainExpRate]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">SetDarkGainExpRate(sceneId, selfId, fRate)</code><br />设置暗器经验倍率，合法范围为 0.01 到 10。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">SetDarkGainExpRate(sceneId, selfId, fRate)</code><br />设置暗器经验倍率，合法范围为 0.01 到 10。<br /><span style="color:#657078;">脚本中 1 处调用</span> | ||
|- | |- | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetDarkQualityGrade|SetDarkQualityGrade]] | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetDarkQualityGrade|SetDarkQualityGrade]] | ||
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">SetDarkQualityGrade(sceneId, selfId, nQuality)</code><br />设置当前装备暗器的实际品阶。 | | style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">SetDarkQualityGrade(sceneId, selfId, nQuality)</code><br />设置当前装备暗器的实际品阶。<br /><span style="color:#a08a6a;">脚本中未见调用</span> | ||
|} | |} | ||
</div> | </div> | ||
2026年9月19日 (六) 13:03的版本
暗器：19 个接口，19 个调用名称，其中 14 个在当前脚本中有调用。
| 函数 / 别名 | 调用与用途 |
|---|---|
| AdjustDarkAttrForBagItem | AdjustDarkAttrForBagItem(sceneId, selfId, nBagPos, nAttrIndex)将背包暗器的一点指定附加属性随机转移到其他属性。 脚本中 1 处调用 |
| AdjustDarkSkillForBagItem | AdjustDarkSkillForBagItem(sceneId, selfId, nBagPos)重洗背包暗器的技能。 脚本中 1 处调用 |
| DarkLevelUp | DarkLevelUp(sceneId, selfId)由 NPC 完成一次暗器突破。 脚本中 1 处调用 |
| DarkOperateResult | DarkOperateResult(sceneId, selfId, nOperateType, nSuccessType)向客户端返回一次暗器操作结果。 脚本中 22 处调用 |
| GetDarkAttrForBagItem | GetDarkAttrForBagItem(sceneId, selfId, nBagPos, nAttrIndex)取得背包暗器指定附加属性的数值。 脚本中 1 处调用 |
| GetDarkCleanTimes | GetDarkCleanTimes(sceneId, selfId, nBagPos)取得背包暗器已经洗过的属性次数。 脚本中 1 处调用 |
| GetDarkLevel | GetDarkLevel(sceneId, selfId)取得当前装备暗器的等级；未装备时返回 0。 脚本中 5 处调用 |
| GetDarkQualityGrade | GetDarkQualityGrade(sceneId, selfId)取得当前装备暗器的实际品阶。 脚本中未见调用 |
| GetDarkQualityGradeFromTB | GetDarkQualityGradeFromTB(sceneId, selfId)取得暗器配表中的初始品阶。 脚本中未见调用 |
| GetDarkSkillId | GetDarkSkillId(sceneId, selfId, nSkillIndex)取得装备暗器某一阶段的技能编号。 脚本中未见调用 |
| GetDarkTotalCleanTimes | GetDarkTotalCleanTimes(sceneId, selfId, nBagPos)取得背包暗器允许洗属性的总次数。 脚本中 1 处调用 |
| HaveDarkEquiped | HaveDarkEquiped(sceneId, selfId)是否装备了有效暗器。 脚本中 2 处调用 |
| IsDarkNeedLevelUpByNpcNow | IsDarkNeedLevelUpByNpcNow(sceneId, selfId)判断暗器当前是否必须由 NPC 完成突破。 脚本中 2 处调用 |
| IsItemDark | IsItemDark(sceneId, selfId, nItemSerial)按物品配表编号判断该装备是否为暗器。 脚本中未见调用 |
| ResetDarkForBagItem | ResetDarkForBagItem(sceneId, selfId, nBagPos)重置背包暗器的属性和技能。 脚本中 1 处调用 |
| ResetDarkQualityForBagItem | ResetDarkQualityForBagItem(sceneId, selfId, nBagPos, nType)按指定类型重洗背包暗器的品阶。 脚本中 1 处调用 |
| SetDarkCleanTimes | SetDarkCleanTimes(sceneId, selfId, nBagPos, nTimes)设置背包暗器已经洗过的属性次数。 脚本中 1 处调用 |
| SetDarkGainExpRate | SetDarkGainExpRate(sceneId, selfId, fRate)设置暗器经验倍率，合法范围为 0.01 到 10。 脚本中 1 处调用 |
| SetDarkQualityGrade | SetDarkQualityGrade(sceneId, selfId, nQuality)设置当前装备暗器的实际品阶。 脚本中未见调用 |
