https://www.waylee.net/index.php?action=history&feed=atom&title=Lua%E6%8E%A5%E5%8F%A3%2F%E6%9C%8D%E5%8A%A1%E7%AB%AF%E5%87%BD%E6%95%B0%E7%B4%A2%E5%BC%95%2F%E6%9A%97%E5%99%A8
Lua接口/服务端函数索引/暗器 - 版本历史
2026-09-07T13:47:17Z
本wiki上该页面的版本历史
MediaWiki 1.46.0
https://www.waylee.net/index.php?title=Lua%E6%8E%A5%E5%8F%A3/%E6%9C%8D%E5%8A%A1%E7%AB%AF%E5%87%BD%E6%95%B0%E7%B4%A2%E5%BC%95/%E6%9A%97%E5%99%A8&diff=1204&oldid=prev
雪舞：整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明
2026-09-07T11:16:13Z
<p>整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明</p>
<p><b>新页面</b></p><div>__NOTOC__<br />
<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;"><br />
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]]<br />
<br />
<div style="padding:14px 0;border-top:3px solid #287568;">暗器：19 个接口，19 个调用名称。</div><br />
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"<br />
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;width:36%;" | 函数 / 别名<br />
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 调用与用途<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/AdjustDarkAttrForBagItem|AdjustDarkAttrForBagItem]]<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 />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/AdjustDarkSkillForBagItem|AdjustDarkSkillForBagItem]]<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 />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DarkLevelUp|DarkLevelUp]]<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DarkLevelUp(sceneId, selfId)</code><br />由 NPC 完成一次暗器突破。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DarkOperateResult|DarkOperateResult]]<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 />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkAttrForBagItem|GetDarkAttrForBagItem]]<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 />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkCleanTimes|GetDarkCleanTimes]]<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 />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkLevel|GetDarkLevel]]<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkLevel(sceneId, selfId)</code><br />取得当前装备暗器的等级；未装备时返回 0。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkQualityGrade|GetDarkQualityGrade]]<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkQualityGrade(sceneId, selfId)</code><br />取得当前装备暗器的实际品阶。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkQualityGradeFromTB|GetDarkQualityGradeFromTB]]<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetDarkQualityGradeFromTB(sceneId, selfId)</code><br />取得暗器配表中的初始品阶。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkSkillId|GetDarkSkillId]]<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 />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetDarkTotalCleanTimes|GetDarkTotalCleanTimes]]<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 />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/HaveDarkEquiped|HaveDarkEquiped]]<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">HaveDarkEquiped(sceneId, selfId)</code><br />是否装备了有效暗器。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsDarkNeedLevelUpByNpcNow|IsDarkNeedLevelUpByNpcNow]]<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">IsDarkNeedLevelUpByNpcNow(sceneId, selfId)</code><br />判断暗器当前是否必须由 NPC 完成突破。<br />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsItemDark|IsItemDark]]<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 />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/ResetDarkForBagItem|ResetDarkForBagItem]]<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 />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/ResetDarkQualityForBagItem|ResetDarkQualityForBagItem]]<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 />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetDarkCleanTimes|SetDarkCleanTimes]]<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 />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetDarkGainExpRate|SetDarkGainExpRate]]<br />
| 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 />
|-<br />
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetDarkQualityGrade|SetDarkQualityGrade]]<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 />
|}<br />
</div></div>
雪舞