Getting started

Installation

SHADED or ORIGINAL?

First of all, you should decide which version of DungeonsXL you would like to use. There are two:

SHADED

• Standard distribution version
• Contains BRCommons
• Standalone
• Available at SpigotMC.org and at the build server

Use the shaded version if you do not need the benefits of the original version.

ORIGINAL

• The pure DungeonsXL without any dependencies shaded into the jar
• Requires BRCommons
• Available at the build server

Use the original version if you want to run DungeonsXL with a Minecraft version which is not supported by DungeonsXL or if you use another plugin by DRE2N.

Addons and connected plugins

Even though DungeonsXL is standalone, you will achieve the best experiences if you use some of this plugins:

CommandsXL

CommandsXL unleashes a lot of the potential of DungeonsXL through the possibility to create command signs that use the CXL API to execute commands.

MythicMobs

MythicMobs allows you to create much more sophisticated mobs than DungeonsXL is able to provide itself.

RPGMe

Upcoming

BetonQuest

Upcoming

Factions

Upcoming

Integrations

Besides that, DungeonsXL integrates with Vault to support the permission system of PermissionsEx and the economy system of CraftConomy. Other permission or economy plugins might work if they support Vault, but they are completely unsupported.

The first dungeon

Creation

TO DO

Importing maps

Of course, you do not have to build a new map. Just copy any map you want as a DXL map to DungeonsXL/maps/; DungeonsXL will find and recognize it.

Editing the map

If you want to work on an existing map, just type in /dxl edit . If a player edits a map, he gets creative mode, the inventory is saved and cleared and all commands are denied unless the player has the permission node dxl.bypass. Therefore, a player who is editing a dungeon map is unable to interact with the main worlds of the server. This is quite useful if you want to provide a possibility to build in creative mode without the need to grant dangerous permissions.

A player is allowed to edit a map if he has the permission node dxl.edit or if he is explicitely invited to work on a map. To invite a player, run the command /dxl invite _.

You can always leave a dungeon map (or, precisely: A dungeon player group) with /dxl leave. A player who leaves a dungeon gets his old inventory, potion effects, levels, game mode etc. back.

Setting up the floor configuration

TO DO

Entering the dungeon

TO DO

Group setup

TO DO

Testing without reward

TO DO

ADVANCED: Multi floor dungeons (MFDs)

TO DO

Setting up the dungeon config

TO DO

Linking floors

TO DO

ADVANCED: Game types

TO DO

API