EpicQuestDungeoning

EpicQuest Dungeoning lets pack authors and server owners load custom dungeon structures from config and send players into them through a simple portal flow — no coding required.

Export builds with WorldEdit or structure blocks, drop them in a folder, edit one JSON file, and players can pick a dungeon, step on a portal block, explore, and return to spawn when they’re done.

Features

• Dungeon selection GUI — preview images, descriptions, confirmation dialog, and per-player dungeon selection.
• Configurable portal block — step on any block ID to enter your selected dungeon.
• Shared void dimension — all dungeons live in epicquest_dungeoning:dungeons, spaced along the X axis so large schematics do not overlap.
• Schematic support — vanilla structure .nbt and WorldEdit Sponge .schem (v1/v2/v3).
• Return to spawn — inventory button returns you to your bed / respawn anchor / world spawn (not the nether portal).
• Teleport charge — particles and sounds while entering or returning; configurable duration; interrupted by movement or damage; bypassed in creative.
• Live config reload — edit dungeons.json and open /dungeon select to pick up changes without a full server restart.
• Reload progress bar — real per-step loading overlay when selecting, reloading, or resetting dungeons.
• Reset all dungeons — reload every schematic from disk (cooldown-gated; creative bypass).
• Structure protection — optional block-break / block-place protection inside dungeons.
• Fall damage immunity — optional short immunity after returning from a dungeon.
• One-shot trial spawners — trial spawners placed in schematics fire once per dungeon reset.

Player flow

1. Run /dungeon select (or /dungeons select) and choose a dungeon.
2. Stand on the configured portal block until the teleport charge completes.
3. Explore the dungeon. Use the return button in your inventory to go back to spawn (also charged).
4. Operators can use Reset All Dungeons on the selection screen to wipe and reload every schematic.

Author setup

On first launch the mod creates:

config/epicquest_dungeoning/
  dungeons.json
  schematics/
  images/

1. Drop .nbt or .schem files into schematics/.
2. Add dungeon entries to dungeons.json (id, name, description, schematic filename, spawn point).
3. Optional: add preview PNGs to images/ and reference them with "image": "preview.png".
4. Run /dungeon select or /dungeon reload to load changes — no restart required for list updates.

Example dungeon entry

Spawn coordinates are relative to each dungeon’s placement origin by default (1st dungeon at X=0, 2nd at X=10000, etc.). Set "absolute_position": true to use world coordinates directly.

Configuration (dungeons.json)

Commands

• /dungeon select — open the dungeon picker (reloads config + schematics with progress bar).
• /dungeon return — return to spawn from inside a dungeon.
• /dungeon list — show active dungeon IDs and the config file path in use.
• /dungeon reload — (op) reload config, clear non-player entities in the dungeon dimension, and preload schematics.

Each dungeon spawn uses relative coordinates to the schematic placement origin by default. Set "absolute_position": true for raw world coordinates. Spawn Y respects your configured value (with a safe fallback only if that spot is not standable).

Requirements

• Minecraft: 1.21.1
• Loader: NeoForge

Designed for adventure packs and RPG servers that want instanced dungeon content without writing custom dimension code.