CI Lint CI Tests and Coverage Latest Release Java 21 License

Dungeons is a Paper plugin for creating, editing, and running configurable dungeon content with queueing, teams, triggers, functions, difficulty scaling, and loot table rewards.

1. Place Dungeons.jar in your server plugins/ directory.
2. Start the server once to generate runtime files under plugins/Dungeons/.
3. Configure global settings in plugins/Dungeons/config.yml.
4. Create or edit dungeon content with /dungeon editor commands.
5. Start a run with /dungeon play <dungeon>[:difficulty].

• Java 25
• Paper 26.x

mvn -B package

Output jar: target/Dungeons.jar

Use the helper script to bump semver, commit, and tag:

scripts/bump-version.sh patch
scripts/bump-version.sh minor --push

Options:

• major|minor|patch: required bump type
• --push: push branch + tag after creating them
• --remote <name>: push/check against a remote (default: origin)

• Configuration Guide
• Documentation Index
• Architecture
• Development Notes
• Testing and Quality
• Contributing

• Support
• Security Policy
• Code of Conduct