原创 DWAbyss - 深渊（爬塔） 1.0.3

DWAbyss - 深渊（爬塔）​

DWAbyss是一个功能强大的Rust服务器PVE挑战插件（也适用于PVP服务器），为玩家提供了丰富的爬塔式战斗体验。插件包含普通深渊、限时深渊、无尽深渊三种挑战模式和一种世界级事件：随机深渊事件，以及深渊精华商店系统，让玩家在挑战中获得奖励并兑换珍稀物品。

随机深渊事件作为世界级动态事件，会在地图上随机位置生成传送门，为服务器带来更多的探索性和竞争性，让玩家体验到类似MMO游戏中世界BOSS的紧张刺激感。

---

​

深渊空岛​

深渊空岛是本插件的核心特色功能之一。每当玩家开始深渊挑战时，系统会在高空动态生成一个独立的战斗场景，为玩家提供沉浸式的战斗体验。

每次生成的空岛样式都是随机的，并且可以自定义空岛上生成些装饰（油桶、路障等）。
深渊空岛将在地图边界的海面的天空中随机生成，在边界会生成树木阻止玩家离开空岛。

玩家可以在空岛上建造建筑和屏障等防御设施，做好战前准备。

除此之外，也可选择不开启空岛，而是直接在玩家身边生成NPC（后续版本上线）。 该方案已废弃。

空岛生成机制：

• 动态创建：每次挑战开始时实时生成，挑战结束后自动清理
• 独立空间：每个挑战都有专属的空岛，互不干扰
• 高空设计：位于地图边界的海面高空，远离地面玩家活动区域

空岛环境元素：

• 地形基础：每次生成都是完全随机的地形
• 边界防护：周围自动生成树木边界，防止玩家离开空岛区域
  • 树木种类和间距可配置
  • 形成自然的视觉和物理边界
• 表面装饰：随机生成各类装饰物，丰富战斗环境
  • 可添加油桶、篝火、路障甚至动物等内容
  • 装饰物种类和数量完全可配置

空岛安全机制：

• 传送保护：挑战开始时安全传送玩家到空岛
• 位置记录：自动保存玩家原始位置，挑战结束后精准传送回去
• 边界检测：实时监测玩家和NPC位置，防止跌落
• NPC限制：NPC活动范围受限，不会跌落或逃离战斗区域
• 他人隔离：可配置禁止非挑战玩家进入，避免干扰
• 成长装备：可配置禁止在挑战时使用成长型武器或成长型服饰的增益。

空岛规则系统：

• 建造限制：可配置是否允许玩家在空岛建造
  • 完全禁止建造，纯粹战斗挑战
  • 允许放置特定物品（如木制立障），增加战术性
  • 白名单机制，灵活控制可建造实体
• 指令限制：可配置禁用的指令列表
  • 防止玩家使用传送指令离开空岛（如/home、/tp、/tpr）
  • 禁用拆除工具（如/remove）
  • 自定义任何需要限制的指令

空岛装饰战利品：

• 装饰物战利品：可配置深渊空岛上生成的战利品装饰物的内容。
  • 在配置文件将启用装饰物自定义战利品设置为true后，即可控制深渊空岛上的容器战利品。
  • 支持例如油桶、板条箱等实体。
  • 支持配置每个容器最少/最多可产生的物品数量。

---

普通/限时深渊​

DWAbyss 是一个完整的深渊挑战系统插件，为服务器提供了普通深渊、限时深渊和无尽深渊三种挑战模式。玩家可以在自动生成的悬空岛屿 ——「深渊空岛」上挑战多波NPC，获得丰厚奖励。

持久化爬塔系统​

普通深渊和限时深渊支持添加无限个预设深渊层级，每层深渊均可设计不同的难易度等级。
拥有前置关卡解锁机制，要求玩家完成指定深渊层级才能进行该层级深渊的挑战。

每层深渊都支持设置难度（目前仅显示作用）和挑战限时。

NPC波次系统​

深渊挑战支持添加多波NPC（如：第一波→第二波→第三波）。
每波NPC可以添加多种NPC，每种NPC的属性（血量、攻击力）、装备和数量均可以自定义。

玩家传送到空岛后不会立即生成NPC，而是支持设置第一波延迟生成（给玩家准备时间，让其在空岛建造防御设施）。还支持设置波与波之间的间隔时间，给玩家休整。延迟生成时间和间隔时间不计入挑战限时中。
生成NPC时将自动识别玩家距离，避免在玩家面前直接生成。

在NPC波开始/完成时，支持调用触发 XMSkillLibrary·技能库 的技能。

• 注：部分技能因方法不同可能不会在深渊空岛生效，请自行测试。

NPC尸体/战利品设置​

支持设置禁止生成NPC尸体，或自定义NPC尸体战利品。
启用禁止生成NPC尸体后，深渊NPC死亡后将不会产生尸体，即使自定义战利品列表不为空。
当禁止生成NPC尸体为false，且自定义NPC尸体战利品列表为空时将使用默认战利品。否则将使用自定义NPC尸体战利品中的物品。

挑战要求​

要求玩家拥有或扣除玩家指定经济系统或物品才能开始该层级挑战：

• 要求玩家拥有指定权限。
• 要求玩家拥有指定DWRole身份。
• 要求玩家VipLogo等级到达x级。
• 要求玩家拥有并扣除指定数量的DWStaminaSystem - 体力系统的体力。
• 要求玩家拥有并扣除指定数量的经济余额（Economics/ServerRewards/IQEconomic/物品/自行填写Hook）。
• 要求玩家拥有并扣除指定数量的物品。

挑战失败机制​

插件拥有多种挑战识别机制，玩家挑战失败后将会传送回传送前的位置。玩家当出现以下情况的时候将视为挑战失败：

• 挑战超时（NPC波生成延迟和间隔时间不计入挑战限时）。
• 玩家在挑战途中死亡（尸体也将会传送到之前的位置）。
• 卡入空岛内部。
• 掉落出空岛区域。
• 玩家离线。

挑战成功奖励​

玩家挑战成功后将获得预设的奖励，例如金币、深渊精华和指定物品。

限时深渊​

限时深渊挑战是定期活动版本的深渊挑战，所有功能与普通深渊相同，但增加了时效性。
支持配置结束时间（如2025/10/31 23:00），到达结束时间后将不再能挑战。适合节日活动、赛季活动或每档的周期活动。

特点​

• 设置活动开始和结束时间，营造紧迫感
• 配置方式与普通深渊相同，但可设置更高难度和奖励
• 可用于节日活动、周末活动或特殊事件
• 过期后自动关闭
• 支持前置解锁机制，可要求完成普通深渊后才能参与

应用场景​

• 节日活动：配置节日主题的NPC和奖励
• 周末挑战：每周末开放高奖励限时副本
• 赛季活动：配合服务器每档更新推出新挑战

---

无尽深渊​

让玩家进行无尽的深渊挑战！插件将根据预设的 时间限制、NPC属性（数量、攻击力、血量）、挑战要求和奖励设置 和对应的倍增倍数，自动生成无尽深渊层级。无限层数设计，永无止境的挑战。

无尽深渊也支持像普通/限时深渊那样要求拥有权限、身份、体力、经济余额或物品等设定。

特点：​

• 无限层数设计，永无止境的挑战
• 基于倍数系统的难度递增（NPC数量、血量、攻击力等按配置倍数递增）
• 奖励随层数递增，层数越高收益越大
• 支持特殊里程碑层级配置（如每15层设置一个特殊BOSS层）
• 内置排行榜系统，激发玩家竞争意识
• 可设置基础要求和每层递增倍数，实现平滑的难度曲线

基础设定​

首先无尽深渊需要设置一个基础设定，即第一层的属性。

这些属性将作为后面每个层级的属性倍数的基础。除了特殊层级外，每个层级的设定都将基于该基础进行计算。

倍增属性​

支持设置的属性有：

• 基础挑战限时(秒) ： 每层限时递增(秒)
• 每个NPC设置 -> NPC数量 ： 每层NPC数量递增倍数
• 每个NPC设置 -> NPC血量 ： 每层NPC血量递增倍数
• 每个NPC设置 -> NPC攻击倍数 ： 每层NPC攻击递增倍数
• 奖励经济余额 ： 每层经济奖励递增倍数
• 奖励深渊精华 ： 每层精华奖励递增倍数
• 每个物品奖励设置 -> 基础物品数量 ： 每层数量递增倍数
• 要求 -> 每层VipLogo等级递增 ： 每层VipLogo等级递增
• 要求 -> 扣除经济余额 ： 每层数量递增倍数
• 要求 -> 扣除体力 ： 每层体力要求递增倍数
• 要求 - > 每个扣除物品 -> 基础物品数量 ： 每层数量递增倍数

特殊层级（里程碑层级）​

当玩家通过无尽深渊爬塔达到指定层级时，支持设置特殊层级，也可以称为里程碑层级。

特殊层级独立于插件自定义生成的倍增属性设置。支持像普通深渊那样的固定设置，固定NPC设置、奖励。

例如在第10层设置普通BOSS、第20层设置精英BOSS、第100层设置噩梦BOSS等设定。可以尽情发挥想象。击败第x层BOSS可以获得特殊成长型武器、强化石等，鼓励玩家参加并突破无尽深渊层级。

---

随机深渊事件​

随机深渊事件是动态生成的世界级PvE事件，在地图上随机位置出现传送门，为玩家提供即时挑战机会。

动态生成​

插件将根据配置文件设置的最大/最小生成间隔时间，自动在地图上生成深渊传送门。可配置同时生成多个深渊传送门数量。

支持要求服务器至少有X名玩家才会生成随机深渊。

还支持设置深渊的持续时间，超时没有玩家挑战将自动消失。

支持在配置文件启用地图标记，启用后生成的随机深渊将显示在地图上。

挑战与释放​

• 开始挑战：随机深渊事件一次只允许一名玩家进入挑战，其他玩家会收到"已被占用"提示
• 失败释放：玩家挑战失败后，事件立即释放给其他玩家
  • 摧毁空岛重置战斗场景
  • 恢复地图标记
  • 为失败玩家设置冷却时间
• 成功移除：玩家挑战成功后，事件完全移除（传送门、标记、空岛）
• 挑战失败：玩家挑战失败后进入该事件的冷却期（默认5分钟，可配置）
  • 每个事件的冷却独立，失败A事件不影响挑战B事件。
  • 设置为0秒则失败后立即可再次挑战。

事件配置​

随机深渊事件的深渊层级设置与普通/限时深渊类似，主要是新增了权重系统：

• 加权随机：每个随机事件配置独立的权重值
• 灵活控制：
  • 高权重事件（如150）：出现频率高，适合新手友好事件
  • 中权重事件（如100）：中等频率，适合常规挑战
  • 低权重事件（如30）：稀有事件，适合高难度或传奇挑战
• 累积计算：系统根据所有事件的权重总和随机抽取

极好的性能​

随机深渊事件拥有极好的性能，仅在需要时进行必要的计算。
深渊NPC及空岛也是当玩家开始挑战时才会生成，在玩家挑战成功/失败离开空岛后立即清理。

相关方法也进行了深度的性能优化。

与普通深渊的区别​

---

全动态UI​

本次深渊插件设计了全动态化的UI设计，几乎所有UI组件都会根据配置内容自动变化，自动生成合适的UI内容。

例如右侧的深渊详情界面，它会根据您配置文件设置的金币奖励、深渊精华奖励和可添加无限的物品奖励数量自动生成通过奖励部分，自动变化高度，调整下方UI内容位置。层级NPC也是这样，您可以在配置文件中添加无数个NPC，并显示在UI界面中。如果超出了高度将会自动变为滚动视图，无限制的完整显示全部内容。

---

聊天指令​

• /sy - 打开深渊界面。
• /sy abandon - 放弃当前挑战的深渊。

管理员指令​

查询指令​

• DWABYSS_ADMIN CHECK 普通 <玩家ID> - 查看玩家普通深渊数据
• DWABYSS_ADMIN CHECK 限时 <玩家ID> - 查看玩家限时深渊数据
• DWABYSS_ADMIN CHECK 无尽 <玩家ID> - 查看玩家无尽深渊数据
• DWABYSS_ADMIN CHECK 精华 <玩家ID> - 查看玩家深渊精华数据
• DWABYSS_ADMIN CHECK 商店 <玩家ID> - 查看玩家商店购买数据

清理指令​

• DWABYSS_ADMIN CLEAR 普通 <玩家ID> - 清理玩家普通深渊数据
• DWABYSS_ADMIN CLEAR 限时 <玩家ID> - 清理玩家限时深渊数据
• DWABYSS_ADMIN CLEAR 无尽 <玩家ID> - 清理玩家无尽深渊数据
• DWABYSS_ADMIN CLEAR 精华 <玩家ID> - 清理玩家深渊精华数据
• DWABYSS_ADMIN CLEAR 商店 <玩家ID> - 清理玩家商店购买数据
• DWABYSS_ADMIN CLEAR 全部 <玩家ID> - 清理玩家所有深渊数据

随机深渊事件指令​

• abyss.spawnevent - 随机生成一个随机深渊事件
• abyss.spawnevent <事件ID> - 生成指定ID的随机深渊事件

---

配置文件​

默认配置文件请查看 配置文件 标签页。

远期计划​

以下是根据用户建议进行采纳的功能与计划，计划远期添加到插件中。

多人合作模式​

在配置文件中开启多人合作模式后，玩家可以在普通/限时/无尽爬塔中邀请第二名玩家协助。第二名玩家接受邀请后可加入本次挑战，与该玩家一起完成本层级。

可设置仅限邀请队友、好友或 XMRelationship·关系系统 的关系玩家。

技能库联动​

在玩家挑战深渊层级时，达到指定条件会触发 XMSkillLibrary·技能库 的一些技能。