⚔️ 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. 安装
- 下载 InstancedDungeons JAR。
- 将其放入服务器的
plugins 文件夹中。
- 启动服务器。
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。
⚔️ InstancedDungeons ⚔️
Instanced dungeons for Paper servers, built around reusable world templates
Build a dungeon once, then let multiple parties run through separate copies without interfering with each other. InstancedDungeons handles template worlds, parties, objectives, stages, gates, mobs, loot, rewards, lives, timers, validation, and cleanup.
📚 Documentation and Support
Please check validation output and the documentation before reporting a setup problem. If something is genuinely broken, include the plugin version, Paper version, Java version, and the relevant console error.
✨ Main Features
🏰 Isolated World Instances
- Create flat template worlds directly with
/dg world or use an existing world as a reusable dungeon template.
- Give every party its own temporary copy.
- Run multiple groups through the same dungeon at the same time.
- Automatically copy template gamerules,
WorldBorder settings, and WorldGuard regions and flags to each instance.
- Clean up completed, failed, abandoned, and orphaned instances.
- Remove matching temporary WorldGuard world data during cleanup.
- Keep players who are not part of the run out of active instances.
👥 Parties and Spectators
- Party creation with short join codes.
- Configurable minimum and maximum party sizes.
- Party-leader controls for starting a run.
- Support for leaving, reconnecting, tower transitions, and cleanup.
- External spectators can follow an active party and leave safely.
- Eliminated players can spectate the rest of the run or return to the exit.
🎯 Boss and Trigger Dungeons
Choose how each dungeon is completed:
BOSS — defeat the configured boss.
TRIGGER — activate one configured button or pressure plate.
Boss and trigger rewards support independent drop chances, amount ranges, vanilla items, ItemsAdder, Oraxen, Nexo, and MythicMobs items.
Reward delivery is configurable per objective:
- send rewards directly to inventories or drop them at the objective;
- reward the leader, killer, trigger activator, every alive player, or create one shared party drop;
- safely drop inventory overflow at the recipient's location;
- reject invalid delivery and recipient combinations before the dungeon starts.
🚪 Stages, Gates, and Missions
- Add progression stages inside a dungeon.
- Select existing gate blocks without breaking or replacing them.
- Use sneak-click to edit connected blocks of the same material.
- Import the current WorldEdit selection with
//set while editing a gate.
- Give stages explicit IDs and order numbers.
- Run multiple stages in parallel by assigning the same order.
- Add multiple holograms with live mission progress.
Supported stage missions:
- mob kills;
- levers;
- synchronized buttons and pressure plates;
- required keys;
- timers;
- region objectives;
- sacrifice decisions;
- Vault payments;
- item payments.
The Free edition supports up to two stages per dungeon and two missions per stage.
⚔️ Mob Spawners
- Vanilla mobs and MythicMobs.
- Mixed vanilla/MythicMobs pools.
- Weighted entries and individual spawn chances.
- Boss spawners for boss-objective dungeons.
- Start, proximity, delay, and proximity-with-delay trigger modes.
📦 Loot Chests
- Place configured loot chests in the template world.
- Random chances and min/max amounts per entry.
- Vanilla and supported custom items.
- Potion, tipped-arrow, and enchanted-book IDs.
- Add the item in your hand with
/dungeon lootchest loot <id> add.
- Guaranteed mission-key supply for required-key stages.
- Editor particles make configured locations easy to find.
🗼 Tower Dungeons
Chain dungeon templates together into a longer run. The Free edition supports:
FIRST -> LAST
The party, lives, spectators, and progression are carried across the transition. Entry costs belong to the first dungeon, while the last dungeon completes the tower.
💰 Costs, Lives, and Timers
- Money and item entry costs.
- Vault economy support.
- Leader-only or whole-party payment.
- Player-scoped or shared team lives.
- Unlimited lives with
0.
- Configurable elimination behavior.
- Per-dungeon countdown and bossbar.
- Configurable timer alerts and automatic failure at zero.
🛡️ Dungeon Rules and Item Restrictions
- Control block breaking, block placement, fluids, interactions, fire spread, and TNT.
- Keep mission blocks, gates, objectives, and loot chests protected even when normal building is enabled.
- Decide whether existing player flight is allowed; Creative and Spectator flight remain available.
- Optionally block elytra, ender pearls, chorus fruit, enchanted golden apples, wind charges, firework rockets, maces, and tridents.
Item restrictions are configured per dungeon in config.yml.
⚙️ Event Commands
Each dungeon can run commands for player and party events. Commands may run as the console or as a player and can react to party creation, joins, starts, deaths, mob and boss kills, stages, gates, completion, failure, tower transitions, and more.
Event commands are disabled by default and support context placeholders for players, parties, dungeons, stages, mobs, bosses, worlds, and coordinates.
🔧 Validation and Diagnostics
/dungeon validate <id> checks one dungeon.
/dungeon validate all checks every dungeon.
- Reload validation covers objectives, towers, spawners, loot, costs, stages, and commands.
- Invalid setups are blocked before they can create a broken run.
- Optional lightweight RAM analysis can be toggled with
/dungeon ram analysis.
- RAM analysis is disabled by default and does not scan the heap or force garbage collection.
📋 Compatibility
One universal InstancedDungeons JAR supports both Paper 1.21.x and Paper 26.x. Built-in template world management (/dg world) is included out of the box.
| Requirement |
Supported |
| Server |
Paper 1.21.x, Paper 26.x |
| Java |
Java 21+ (1.21.x) / Java 25+ (26.x) |
Optional Integrations
- WorldGuard — automatic region and flag copying to dungeon instances.
- Multiverse-Core — optional external template world support.
- MythicMobs 5.0+ — custom mobs, bosses, and items.
- ItemsAdder 3.0+ — custom items.
- Oraxen — custom items.
- Nexo — custom items.
- Vault plus an economy plugin — money costs and money missions.
Free and Pro
The Free edition is a complete, playable dungeon system with limits intended for smaller and medium-sized setups.
| Area |
Free |
Pro |
| Active instances |
Up to 6 globally |
♾️ Unlimited |
| Dungeon templates |
Up to 6 |
♾️ Unlimited |
Managed template worlds (/dg world) |
Up to 6 (flat) |
♾️ Unlimited (void, flat, normal + GUI) |
| Tower layout |
FIRST -> LAST |
FIRST -> MIDDLE -> ... -> LAST |
| Stages |
Up to 2 per dungeon |
♾️ Unlimited |
| Missions |
Up to 2 per stage |
♾️ Unlimited |
| Mission blocks |
Up to 3 levers, 3 buttons, and 2 pressure plates per stage |
♾️ Unlimited |
| Required-key mission |
Up to 1 per stage |
♾️ Unlimited |
| Sacrifice, money, item-payment, and region missions |
Up to 1 of each per dungeon |
♾️ Unlimited |
| Item types in an item-payment mission |
Up to 3 |
♾️ Unlimited |
| Kill Mobs targets |
Total kill count only |
Specific vanilla and MythicMobs targets with per-mob progress |
| Kill Mobs filters (only dungeon mobs, count babies) |
✅ |
✅ |
| Boss stages requirements |
❌ |
✅ Specific stage or all stages |
| Checkpoints and closing gate actions |
❌ |
✅ |
Per-dungeon sounds.yml |
❌ |
✅ |
| Admin GUI |
❌ |
✅ |
InstancedDungeons Pro: View the official BuiltByBit page
🚀 Quick Start
1. Install
- Download the InstancedDungeons JAR.
- Place it in the server's
plugins folder.
- Start the server.
2. Create a Template and Dungeon
/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
For a trigger dungeon:
/dungeon create puzzle_room puzzle_template trigger
/dungeon edit puzzle_room
/dungeon setspawn
/dungeon setexit
/dungeon settrigger STONE_BUTTON
/dungeon save
/dungeon reload
3. Add Loot and a Stage
/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. Start a Run
/dungeon open dragon_lair
/dungeon join <code>
/dungeon start
🎮 Commands
Player Commands
| Command |
Description |
/dungeon help |
Show the command list |
/dungeon list |
List available dungeons |
/dungeon open <id> |
Create a party for a dungeon |
/dungeon join <code> |
Join a party |
/dungeon leave |
Leave an open party |
/dungeon start |
Start the run as party leader |
/dungeon exit |
Leave an active dungeon |
/dungeon spectate <leader> |
Spectate an active party |
/dungeon spectator exit |
Leave spectator mode |
Common Admin Commands
| Command |
Description |
/dg world <create|list|delete|tp> |
Manage template worlds |
/dungeon create <id> <world> <boss|trigger> |
Create a dungeon |
/dungeon edit <id> |
Enter editor mode |
/dungeon setspawn |
Set the dungeon spawn |
/dungeon setexit |
Set the exit |
/dungeon setboss |
Set the boss location |
/dungeon settrigger <material> |
Set the trigger objective |
/dungeon boss reward edit |
Edit boss rewards |
/dungeon trigger reward edit |
Edit trigger rewards |
/dungeon addspawner <id> |
Add a mob spawner |
/dungeon addlootchest <id> |
Add a loot chest definition |
/dungeon lootchest give <id> |
Get its placement chest |
/dungeon addcost |
Edit entry costs |
/dungeon stage create <id> |
Create a stage |
/dungeon stage list |
List stage IDs and order |
/dungeon stage <id> order <number> |
Change stage order |
/dungeon stage <id> gate create|edit|delete |
Manage a gate |
/dungeon stage <id> gate stick |
Get the gate editing stick |
/dungeon stage <id> gate hologram create|delete |
Manage stage holograms |
/dungeon gate save |
Save the current gate selection |
/dungeon validate <id|all> |
Validate dungeon files |
/dungeon instances |
Show active parties and instances |
/dungeon reload |
Reload plugin and dungeon files |
/dungeon delete <id> |
Delete a dungeon after confirmation |
The complete command reference, including mission and custom-item commands, is available in the documentation.
🔑 Permissions
| Permission |
Default |
Description |
instanceddungeons.admin |
OP |
Administrative and editor commands |
instanceddungeons.open |
true |
Open dungeon parties |
instanceddungeons.join |
true |
Join dungeon parties |
instanceddungeons.open.<dungeon_id> |
true |
Open a specific dungeon |
instanceddungeons.join.<dungeon_id> |
true |
Join a specific dungeon |
instanceddungeons.spectate |
true |
Spectate active dungeons |
instanceddungeons.bypass.cost |
OP |
Bypass entry costs |
instanceddungeons.bypass.limit |
OP |
Bypass normal start limits |
⚠️ Updating
- Missing settings and messages are appended automatically without replacing existing values.
- The plugin does not create automatic backups. Stop the server and back up the
dungeons folder, data folder, config.yml, and messages.yml before updating.
评论 0
登录后参与评分
还没有评论,来抢沙发吧