Instanced Dungeon

插件

· 作者 wertPL

终极副本系统,通过完全可定制、隔离的副本实例来改造你的 Minecraft 服务器

0 本站下载 0 关注 更新于 2 天前

最新 2.4.0 · 26.3 · Paper / Purpur

一键开服(送7天)

⚔️ InstancedDungeons ⚔️

为 Paper 服务器打造的副本地下城,基于可复用的世界模板构建

只需构建一次地下城,即可让多个队伍在互不干扰的独立副本中运行。InstancedDungeons 负责处理模板世界、队伍、目标、阶段、门、怪物、战利品、奖励、生命值、计时器、验证和清理工作。


📚 文档与支持

在报告设置问题之前,请先检查验证输出和文档。如果确实存在故障,请提供插件版本、Paper 版本、Java 版本以及相关控制台错误信息。


✨ 主要功能

🏰 隔离的世界实例

  • 直接使用 /dg world 创建平坦的模板世界,或使用现有世界作为可复用的地下城模板。
  • 为每个队伍提供独立的临时副本。
  • 允许多个小组同时通过同一个地下城。
  • 自动将模板的游戏规则(gamerules)、WorldBorder 设置以及 WorldGuard 区域和标志复制到每个实例中。
  • 清理已完成、失败、被放弃及孤立的实例。
  • 在清理过程中移除匹配的临时 WorldGuard 世界数据。
  • 确保非参与队伍的玩家无法进入活跃实例。

👥 队伍与观察者

  • 使用简短的加入代码创建队伍。
  • 可配置的最小和最大队伍人数。
  • 由队长控制开始运行。
  • 支持离开、重新连接、塔楼过渡和清理。
  • 外部观察者可以跟随活跃的队伍并安全退出。
  • 被淘汰的玩家可以选择观察剩余的运行过程或返回出口。

🎯 Boss 与触发器地下城

选择完成每个地下城的方式:

  • BOSS — 击败配置的 Boss。
  • TRIGGER — 激活一个配置的按钮或压力板。

Boss 和触发器奖励支持独立的掉落几率、数量范围,以及原版物品、ItemsAdder、Oraxen、Nexo 和 MythicMobs 的物品。

奖励交付方式可按目标配置:

  • 直接将奖励发送到背包或在目标位置掉落;
  • 奖励队长、击杀者、触发器激活者、所有存活玩家,或创建一个共享的队伍掉落;
  • 在接收者位置安全地掉落溢出库存的物品;
  • 在地下城开始前拒绝无效的交付方式和接收者组合。

🚪 阶段、门与任务

  • 在地下城内添加进度阶段。
  • 选择现有的门方块,无需破坏或替换它们。
  • 使用潜行点击编辑相同材质的连接方块。
  • 在编辑门时,使用 //set 导入当前的 WorldEdit 选区。
  • 为阶段分配明确的 ID 和顺序号。
  • 通过分配相同的顺序号并行运行多个阶段。
  • 添加带有实时任务进度的多个全息图。

支持的阶段任务包括:

  • 击杀怪物;
  • 拉杆;
  • 同步按钮和压力板;
  • 必需的钥匙;
  • 计时器;
  • 区域目标;
  • 牺牲抉择;
  • Vault 支付;
  • 物品支付。

Free 版每座地下城最多支持两个阶段,每个阶段最多支持两个任务。

⚔️ 怪物生成器

  • 原版怪物和 MythicMobs。
  • 混合的原版/MythicMobs 池。
  • 权重条目和独立的生成几率。
  • 用于 Boss 目标地下城的 Boss 生成器。
  • 支持启动、近距离、延迟以及带延迟的近距离触发模式。

📦 战利品箱子

  • 在模板世界中放置配置好的战利品箱。
  • 每个条目具有随机的几率和最小/最大数量。
  • 支持原版和自定义物品。
  • 药水、涂色箭矢和附魔书 ID。
  • 使用 /dungeon lootchest loot <id> add 将手中的物品添加进去。
  • 为需要钥匙的阶段提供保证的任务钥匙供应。
  • 编辑器粒子效果使配置的位置易于查找。

🗼 塔楼地下城

将地下城模板链接成更长的流程。Free 版支持:

FIRST -> LAST

队伍、生命值、观察者和进度会在过渡过程中保留。入场费用属于第一个地下城,而最后一个地下城完成整个塔楼流程。

💰 费用、生命值和计时器

  • 金钱和物品入场费用。
  • 支持 Vault 经济系统。
  • 仅限队长或全队支付。
  • 玩家级或共享团队生命值。
  • 使用 0 表示无限生命值。
  • 可配置的被淘汰行为。
  • 每座地下城的倒计时和 Boss 栏。
  • 可配置的计时器警报和归零时的自动失败。

🛡️ 地下城规则与物品限制

  • 控制方块破坏、方块放置、流体、交互、火焰蔓延和 TNT。
  • 即使允许正常建造,也能保护任务方块、门、目标和战利品箱。
  • 决定是否允许现有的玩家飞行能力;创造模式和旁观模式的飞行仍然可用。
  • 可选择禁止鞘翅、末影珍珠、紫颂果、附魔金苹果、风弹、烟花火箭、战锤和三叉戟。

物品限制在 config.yml 中按地下城进行配置。

⚙️ 事件命令

每座地下城都可以为玩家和队伍事件运行命令。命令可以作为控制台或玩家执行,并可响应队伍创建、加入、开始、死亡、怪物和 Boss 击杀、阶段、门、完成、失败、塔楼过渡等事件。

事件命令默认禁用,并支持针对玩家、队伍、地下城、阶段、怪物、Boss、世界和坐标的上下文占位符。

🔧 验证与诊断

  • /dungeon validate <id> 检查单个地下城。
  • /dungeon validate all 检查所有地下城。
  • 重载验证涵盖目标、塔楼、刷怪笼、战利品、费用、阶段和命令。
  • 无效的配置会在导致运行损坏之前被阻止。
  • 可选的轻量级 RAM 分析可以通过 /dungeon ram analysis 切换启用。
  • RAM 分析默认处于禁用状态,不会扫描堆内存或强制进行垃圾回收。

📋 兼容性

一个通用的 InstancedDungeons JAR 文件同时支持 Paper 1.21.x 和 Paper 26.x。内置模板世界管理功能(/dg world)开箱即用。

要求 支持情况
服务器 Paper 1.21.x, Paper 26.x
Java Java 21+ (1.21.x) / Java 25+ (26.x)

可选集成

  • WorldGuard — 自动将区域和标志复制到地下城实例中。
  • Multiverse-Core — 可选的外部模板世界支持。
  • MythicMobs 5.0+ — 自定义生物、Boss 和物品。
  • ItemsAdder 3.0+ — 自定义物品。
  • Oraxen — 自定义物品。
  • Nexo — 自定义物品。
  • Vault 加上一个经济插件 — 金钱费用和金钱任务。

免费版与专业版

免费版是一个完整且可玩的地下城系统,其限制旨在适用于较小和中规模的配置。

领域 免费版 专业版
活动实例 全局最多 6 个 ♾️ 无限制
地下城模板 最多 6 个 ♾️ 无限制
管理的模板世界 (/dg world) 最多 6 个 (flat) ♾️ 无限制 (void, flat, normal + GUI)
塔楼布局 FIRST -> LAST FIRST -> MIDDLE -> ... -> LAST
阶段 每个地下城最多 2 个 ♾️ 无限制
任务 每个阶段最多 2 个 ♾️ 无限制
任务方块 每个阶段最多 3 个拉杆、3 个按钮和 2 个压力板 ♾️ 无限制
钥匙任务 每个阶段最多 1 个 ♾️ 无限制
献祭、金钱、物品支付和区域任务 每个地下城每种类型最多 1 个 ♾️ 无限制
物品支付任务中的物品类型 最多 3 种 ♾️ 无限制
击杀生物目标 仅总击杀数 特定的原版和 MythicMobs 目标,具有按生物进度统计
击杀生物过滤器(仅限地下城生物,计算幼崽) ✅ ✅
Boss 阶段要求 ❌ ✅ 特定阶段或所有阶段
检查点和关闭大门动作 ❌ ✅
每个地下城的 sounds.yml ❌ ✅
管理员 GUI ❌ ✅

InstancedDungeons Pro: 查看官方 BuiltByBit 页面


🚀 快速入门

1. 安装

  1. 下载 InstancedDungeons JAR。
  2. 将其放入服务器的 plugins 文件夹中。
  3. 启动服务器。

2. 创建模板和地下城

/dg world create dragon_template flat normal 500
/dungeon create dragon_lair dragon_template boss
/dungeon edit dragon_lair
/dungeon setspawn
/dungeon setexit
/dungeon setboss
/dungeon save
/dungeon reload

对于触发型地下城:

/dungeon create puzzle_room puzzle_template trigger
/dungeon edit puzzle_room
/dungeon setspawn
/dungeon setexit
/dungeon settrigger STONE_BUTTON
/dungeon save
/dungeon reload

3. 添加战利品和阶段

/dungeon edit dragon_lair
/dungeon addlootchest treasure_1
/dungeon lootchest give treasure_1
/dungeon stage create entrance
/dungeon stage entrance gate create
/dungeon gate save
/dungeon stage entrance gate hologram create

4. 开始运行

/dungeon open dragon_lair
/dungeon join <code>
/dungeon start

🎮 命令

玩家命令

命令 描述
/dungeon help 显示命令列表
/dungeon list 列出可用的地下城
/dungeon open <id> 为地下城组建小队
/dungeon join <code> 加入小队
/dungeon leave 离开开放的小队
/dungeon start 作为小队队长开始运行
/dungeon exit 离开活跃的地下城
/dungeon spectate <leader> 旁观活跃的小队
/dungeon spectator exit 离开旁观模式

常用管理员命令

命令 描述
/dg world <create|list|delete|tp> 管理模板世界
/dungeon create <id> <world> <boss|trigger> 创建地下城
/dungeon edit <id> 进入编辑模式
/dungeon setspawn 设置地下城出生点
/dungeon setexit 设置出口
/dungeon setboss 设置 Boss 位置
/dungeon settrigger <material> 设置触发目标
/dungeon boss reward edit 编辑 Boss 奖励
/dungeon trigger reward edit 编辑触发奖励
/dungeon addspawner <id> 添加生物刷怪笼
/dungeon addlootchest <id> 添加战利品箱定义
/dungeon lootchest give <id> 获取其放置的战利品箱
/dungeon addcost 编辑入场费用
/dungeon stage create <id> 创建阶段
/dungeon stage list 列出阶段 ID 和顺序
/dungeon stage <id> order <number> 更改阶段顺序
/dungeon stage <id> gate create|edit|delete 管理大门
/dungeon stage <id> gate stick 获取大门编辑棒
/dungeon stage <id> gate hologram create|delete 管理阶段全息图
/dungeon gate save 保存当前选择的大门
/dungeon validate <id|all> 验证地下城文件
/dungeon instances 显示活跃小队和实例
/dungeon reload 重载插件和地下城文件
/dungeon delete <id> 确认后删除地下城

完整的命令参考(包括任务和自定义物品命令)可在 文档 中查看。


🔑 权限

权限 默认值 描述
instanceddungeons.admin OP 管理与编辑命令
instanceddungeons.open true 开启副本派对
instanceddungeons.join true 加入副本派对
instanceddungeons.open.<dungeon_id> true 开启特定副本
instanceddungeons.join.<dungeon_id> true 加入特定副本
instanceddungeons.spectate true 观战活跃副本
instanceddungeons.bypass.cost OP 绕过入场费用
instanceddungeons.bypass.limit OP 绕过常规开始限制

⚠️ 更新说明

  • 缺失的设置项和消息会自动追加,不会覆盖现有值。
  • 该插件不会自动创建备份。在更新前,请停止服务器并备份 dungeons 文件夹、data 文件夹、config.yml 以及 messages.yml。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源