Installation

Before installing

Confirm that the server uses Java 21 and is running a supported Paper or Purpur build for Minecraft 1.21.11 or 26.2. Spigot, CraftBukkit, Folia, hybrid Forge/Bukkit servers, and plugin reload managers are outside the supported environment.

Optional integrations can be installed before or after DrakoDungeons:

• PlaceholderAPI exposes %drakodungeons_*% placeholders.

• FastAsyncWorldEdit lets setup mode read a //pos1 and //pos2 cuboid.

Neither dependency is required for basic combat, progression, or menus.

Install the plugin

1

Stop the server

Stop the server completely.

2

Install the JAR

Place DrakoDungeons-1.0.0.jar in the server's plugins directory.

3

Start the server

Start the server normally.

4

Allow baseline files to generate

Wait for Drako Dungeons to generate its complete directory. Because the generated license key is blank, Drako Dungeons then reports NO_LICENSE_KEY and disables itself. This is expected on a clean installation and does not stop the Minecraft server.

5

Stop the server again

Stop the server completely again.

6

Add the license key

Open plugins/DrakoDungeons/config.yml and set the LicenseKey value at the top of the file:

LicenseKey: 'YOUR-LICENSE-KEY'

7

Save the configuration

Save the file without renaming it or changing the LicenseKey capitalization.

8

Start the server

Start the server normally.

9

Check the console

Check the console for Drako Dungeons license validated successfully, the supported-server confirmation, and the successful enable summary.

10

Confirm generated directories

Confirm that plugins/DrakoDungeons/ contains the settings, content, menus, language, docs, and zones directories.

Optional dependency behavior

When FastAsyncWorldEdit is absent, admins can still configure coordinates and use the non-FAWE setup tools. The FAWE selection action is unavailable until the dependency is installed and the server is restarted.

When PlaceholderAPI is absent, DrakoDungeons runs normally but does not register its placeholder expansion.

Updating the JAR

1

Save data

Run /dga save and wait for the success message.

2

Stop the server

Stop the server.

3

Back up plugin data

Back up plugins/DrakoDungeons/, especially dungeons.db and all YAML files.

4

Replace the JAR

Replace the JAR.

5

Start and validate

Start the server, confirm successful license validation in the console, and run /dga validate.