Dungeons

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

Quick Start

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].

Requirements

• Java 21
• Paper 1.21.x

Build From Source

mvn -B package

Output jar: target/Dungeons.jar

Version Bump Workflow

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)

Learn More

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

Community

• Support
• Security Policy
• Code of Conduct