Skip to content

DRE2N/DungeonsXL

Repository files navigation

DungeonsXL

Builds Wiki Issues JavaDocs MCStats

Build Status codebeat badge

DungeonsXL is a server mod that allows you to instantiate worlds.

Its main goal is to offer a way to use a world in a set state multiple times by a player (like for a jump'n'run), a group of players (e.g. for a quest dungeon, an adventure map or a PvE arena) or even by groups of groups of players (e.g. for PvP arenas). DungeonsXL also provides custom game mechanics to make these worlds interesting. It might also be helpful if you want players to build something in creative mode quickly and uncomplicated without any influence on their main world data (inventory, levels etc.).

Features

  • Create as many dungeons as you wish!
  • The instantiation system allows dungeons to be played by multiple groups of players at the same time without clashes.
  • Dungeons are accessable through portals in one of your main worlds. Read more...
  • Invite players to edit single dungeons without the need to give them any further permissions. Read more...
  • Allow players to build in creative mode safely without any influence to their game progress in the main worlds!
  • Set checkpoints, breakable blocks, triggers, messages and much more through signs in the edit mode. Read more...
  • Per dungeon configuration (you should try that after you became familiar with the basics of this plugin). Read more...
  • Link multiple floors together to create large dungeons with multiple levels. Read more...
  • Use a dungeon as a tutorial and give them a PEX group when they finish it. Read more...
  • Players can play the dungeon with their own items or with configurable classes.
  • The classes support doges!
  • Mob waves: Read more...
  • PvP
  • Time limits
  • A built-in custom mob system and support for MythicMobs. Read more...
  • A powerful API: Read more...
  • Different game types allow you to use your maps dynamically for different purposes. Read more...
  • Announcements sothat users can join the next match easily. Read more...
  • Per dungeon resource packs
  • ...and many more!

The concept

If you want to learn how to use DungeonsXL step by step, please have a look at the wiki page getting started.

Compatibility

Server

DungeonsXL works with Spigot 1.8 and higher. However, support for 1.13-1.17 has a higher priority than support for 1.8-1.12. Old builds that support older versions are unusable for production environments. See here for detailed information. DungeonsXL only works with Spigot and does not support CraftBukkit builds.

ItemsXL

DungeonsXL requires ItemsXL 1.0.2 to run.

Building information and dependencies

Building DungeonsXL from source requires Apache Maven. Maven automatically fetches all dependencies and builds DungeonsXL; just run build.bat or enter the command mvn clean install.

DRECommons

DRECommons is a util library for common tasks.

Caliburn API

Caliburn is an API to read custom items and mobs from config files.

Vignette

Vignette is a Bukkit GUI Framework.

Java

Make sure that your server uses Java 8 or higher.

UUIDs

Supported.

Known incompatibilities

  • Corpses
  • PerWorldInventory

Many incompatibilities can be fixed with PerWorldPlugins (fork for 1.8+). Try to add the incompatible plugins only to the worlds where you need them.