Installation

Server requirements

• Server software: Paper, Folia, or Purpur — see the tested API targets and runtime limits
• API build baseline: Paper 1.20.1
• Java version: Java 21 or newer as required by your chosen server

Installation steps

1. 01Stop your server
2. 02Back up your plugin data and worlds, then obtain the DungeonForge JAR from the release package. Remove the older DungeonForge JAR before installing the new one.
3. 03Place the JAR file in your plugins/ folder
4. 04Start the server to generate config files
5. 05(Recommended) Restart after making config changes

Generated files

plugins/DungeonForge/
├── config.yml          # Main configuration
├── loot_tables.yml     # Loot table definitions
├── dungeons/           # Your dungeon saves
│   └── *.yml
└── templates/          # Room templates (NBT)
    └── <dungeonId>/
        └── *.nbt

Dungeon packs export to plugins/DungeonForge/packs/ (zip). Use /df pack export <dungeon>.

Optional integrations