Lua接口/服务端函数索引/暗器：修订间差异

来自天龙知识库
跳到导航跳到搜索

Waylee​（留言 | 贡献）

3个用户组
5,114次编辑
雪舞​（留言 | 贡献）
7,476次编辑
整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明
 
Waylee​（留言 | 贡献）
行政员、​界面管理员、​管理员
5,114次编辑
维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例
 
（未显示2个用户的2个中间版本）
第1行： 第1行：
__NOTOC__
__NOTOC__
<div class="lua-reference" style="max-width:1200px;margin:0 auto;line-height:1.8;color:#29343a;font-family:Arial,'Microsoft YaHei',sans-serif;letter-spacing:0;overflow-wrap:anywhere;">
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]]
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]]


<div style="padding:14px 0;border-top:3px solid #287568;">暗器：19 个接口，19 个调用名称。</div>
<div class="lua-lead">暗器：21 个接口，21 个调用名称，其中 16 个在当前脚本中有调用。</div>
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
{| class="wikitable"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;width:36%;" | 函数 / 别名
! scope="col" class="lua-w36" | 函数 / 别名
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 调用与用途
! scope="col" | 调用与用途
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/AdjustDarkAttrForBagItem|AdjustDarkAttrForBagItem]]
| [[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 />将背包暗器的一点指定附加属性随机转移到其他属性。
| <code>AdjustDarkAttrForBagItem(sceneId, selfId, nBagPos, nAttrIndex)</code><br />将背包暗器的一点指定附加属性随机转移到其他属性。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/AdjustDarkSkillForBagItem|AdjustDarkSkillForBagItem]]
| [[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 />重洗背包暗器的技能。
| <code>AdjustDarkSkillForBagItem(sceneId, selfId, nBagPos)</code><br />重洗背包暗器的技能。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DarkLevelUp|DarkLevelUp]]
| [[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 完成一次暗器突破。
| <code>DarkLevelUp(sceneId, selfId)</code><br />由 NPC 完成一次暗器突破。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DarkOperateResult|DarkOperateResult]]
| [[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 />向客户端返回一次暗器操作结果。
| <code>DarkOperateResult(sceneId, selfId, nOperateType, nSuccessType)</code><br />向客户端返回一次暗器操作结果。<br /><span class="lua-muted">脚本中 22 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkAttrForBagItem|GetDarkAttrForBagItem]]
| [[Lua接口/服务端/GetBagDarkLevel|GetBagDarkLevel]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkAttrForBagItem(sceneId, selfId, nBagPos, nAttrIndex)</code><br />取得背包暗器指定附加属性的数值。
| <code>GetBagDarkLevel(sceneId, selfId, bagIndex)</code><br />读取背包指定暗器的修炼等级；空格或非暗器返回零。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkCleanTimes|GetDarkCleanTimes]]
| [[Lua接口/服务端/GetDarkAttrForBagItem|GetDarkAttrForBagItem]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkCleanTimes(sceneId, selfId, nBagPos)</code><br />取得背包暗器已经洗过的属性次数。
| <code>GetDarkAttrForBagItem(sceneId, selfId, nBagPos, nAttrIndex)</code><br />取得背包暗器指定附加属性的数值。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkLevel|GetDarkLevel]]
| [[Lua接口/服务端/GetDarkCleanTimes|GetDarkCleanTimes]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkLevel(sceneId, selfId)</code><br />取得当前装备暗器的等级；未装备时返回 0。
| <code>GetDarkCleanTimes(sceneId, selfId, nBagPos)</code><br />取得背包暗器已经洗过的属性次数。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkQualityGrade|GetDarkQualityGrade]]
| [[Lua接口/服务端/GetDarkLevel|GetDarkLevel]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkQualityGrade(sceneId, selfId)</code><br />取得当前装备暗器的实际品阶。
| <code>GetDarkLevel(sceneId, selfId)</code><br />取得当前装备暗器的等级；未装备时返回 0。<br /><span class="lua-muted">脚本中 5 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkQualityGradeFromTB|GetDarkQualityGradeFromTB]]
| [[Lua接口/服务端/GetDarkQualityGrade|GetDarkQualityGrade]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkQualityGradeFromTB(sceneId, selfId)</code><br />取得暗器配表中的初始品阶。
| <code>GetDarkQualityGrade(sceneId, selfId)</code><br />取得当前装备暗器的实际品阶。<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkSkillId|GetDarkSkillId]]
| [[Lua接口/服务端/GetDarkQualityGradeFromTB|GetDarkQualityGradeFromTB]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkSkillId(sceneId, selfId, nSkillIndex)</code><br />取得装备暗器某一阶段的技能编号。
| <code>GetDarkQualityGradeFromTB(sceneId, selfId)</code><br />取得暗器配表中的初始品阶。<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkTotalCleanTimes|GetDarkTotalCleanTimes]]
| [[Lua接口/服务端/GetDarkSkillId|GetDarkSkillId]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkTotalCleanTimes(sceneId, selfId, nBagPos)</code><br />取得背包暗器允许洗属性的总次数。
| <code>GetDarkSkillId(sceneId, selfId, nSkillIndex)</code><br />取得装备暗器某一阶段的技能编号。<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/HaveDarkEquiped|HaveDarkEquiped]]
| [[Lua接口/服务端/GetDarkTotalCleanTimes|GetDarkTotalCleanTimes]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">HaveDarkEquiped(sceneId, selfId)</code><br />是否装备了有效暗器。
| <code>GetDarkTotalCleanTimes(sceneId, selfId, nBagPos)</code><br />取得背包暗器允许洗属性的总次数。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsDarkNeedLevelUpByNpcNow|IsDarkNeedLevelUpByNpcNow]]
| [[Lua接口/服务端/HaveDarkEquiped|HaveDarkEquiped]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">IsDarkNeedLevelUpByNpcNow(sceneId, selfId)</code><br />判断暗器当前是否必须由 NPC 完成突破。
| <code>HaveDarkEquiped(sceneId, selfId)</code><br />是否装备了有效暗器。<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsItemDark|IsItemDark]]
| [[Lua接口/服务端/IsDarkNeedLevelUpByNpcNow|IsDarkNeedLevelUpByNpcNow]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">IsItemDark(sceneId, selfId, nItemSerial)</code><br />按物品配表编号判断该装备是否为暗器。
| <code>IsDarkNeedLevelUpByNpcNow(sceneId, selfId)</code><br />判断暗器当前是否必须由 NPC 完成突破。<br /><span class="lua-muted">脚本中 2 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/ResetDarkForBagItem|ResetDarkForBagItem]]
| [[Lua接口/服务端/IsItemDark|IsItemDark]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">ResetDarkForBagItem(sceneId, selfId, nBagPos)</code><br />重置背包暗器的属性和技能。
| <code>IsItemDark(sceneId, selfId, nItemSerial)</code><br />按物品配表编号判断该装备是否为暗器。<br /><span class="lua-warn">脚本中未见调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/ResetDarkQualityForBagItem|ResetDarkQualityForBagItem]]
| [[Lua接口/服务端/LuaFnDarkUpgrade|LuaFnDarkUpgrade]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">ResetDarkQualityForBagItem(sceneId, selfId, nBagPos, nType)</code><br />按指定类型重洗背包暗器的品阶。
| <code>LuaFnDarkUpgrade(sceneId, selfId, equipPos, stonePos)</code><br />用修炼满 90 的梅花镖与寒冰星石锻造成品阶 +400 的新暗器，并重置该暗器的修炼与技能。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetDarkCleanTimes|SetDarkCleanTimes]]
| [[Lua接口/服务端/ResetDarkForBagItem|ResetDarkForBagItem]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">SetDarkCleanTimes(sceneId, selfId, nBagPos, nTimes)</code><br />设置背包暗器已经洗过的属性次数。
| <code>ResetDarkForBagItem(sceneId, selfId, nBagPos)</code><br />重置背包暗器的属性和技能。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetDarkGainExpRate|SetDarkGainExpRate]]
| [[Lua接口/服务端/ResetDarkQualityForBagItem|ResetDarkQualityForBagItem]]
| 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。
| <code>ResetDarkQualityForBagItem(sceneId, selfId, nBagPos, nType)</code><br />按指定类型重洗背包暗器的品阶。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetDarkQualityGrade|SetDarkQualityGrade]]
| [[Lua接口/服务端/SetDarkCleanTimes|SetDarkCleanTimes]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">SetDarkQualityGrade(sceneId, selfId, nQuality)</code><br />设置当前装备暗器的实际品阶。
| <code>SetDarkCleanTimes(sceneId, selfId, nBagPos, nTimes)</code><br />设置背包暗器已经洗过的属性次数。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/SetDarkGainExpRate|SetDarkGainExpRate]]
| <code>SetDarkGainExpRate(sceneId, selfId, fRate)</code><br />设置暗器经验倍率，合法范围为 0.01 到 10。<br /><span class="lua-muted">脚本中 1 处调用</span>
|-
| [[Lua接口/服务端/SetDarkQualityGrade|SetDarkQualityGrade]]
| <code>SetDarkQualityGrade(sceneId, selfId, nQuality)</code><br />设置当前装备暗器的实际品阶。<br /><span class="lua-warn">脚本中未见调用</span>
|}
|}
</div>
</div>

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

首页 · 服务端接口 · 调用约定

暗器：21 个接口，21 个调用名称，其中 16 个在当前脚本中有调用。
函数 / 别名 调用与用途
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 处调用
GetBagDarkLevel GetBagDarkLevel(sceneId, selfId, bagIndex)
读取背包指定暗器的修炼等级；空格或非暗器返回零。
脚本中 1 处调用
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)
按物品配表编号判断该装备是否为暗器。
脚本中未见调用
LuaFnDarkUpgrade LuaFnDarkUpgrade(sceneId, selfId, equipPos, stonePos)
用修炼满 90 的梅花镖与寒冰星石锻造成品阶 +400 的新暗器，并重置该暗器的修炼与技能。
脚本中 1 处调用
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)
设置当前装备暗器的实际品阶。
脚本中未见调用
检索自“https://www.waylee.net/index.php?title=Lua接口/服务端函数索引/暗器&oldid=11438”