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
⚠️ Important
Folia users must configure an unused arena area in an already loaded secondary world. Follow the Folia setup guide before starting a dungeon. Paper uses the existing world backend.
Installation Steps
- Stop your server
- Back up your plugin data and worlds, then obtain
DungeonForge-1.1.0.jarfrom the release package. Remove the older DungeonForge JAR before installing the new one. - Place the JAR file in your
plugins/folder - Start the server to generate config files
- (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
| Plugin | Purpose |
|---|---|
| Vault | Economy rewards on dungeon completion |
| PlaceholderAPI | Stats and leaderboard placeholders |
| MythicMobs | Custom mob spawning |
| Boss (UCM) | Spawn Unbelievable Custom Monsters bosses in dungeons |
| ForgeQuests | Story quests, quest boards, waypoint guidance, dungeon clear objectives, boss kill objectives |
| MMOItems | Custom items in loot tables |
| Citizens | NPC support for quests/merchants |
| ModelEngine | Custom mob models |