Commands

/donjons

Opens the menu named by inventory-menu in the bridge config.yml (dungeons-inventory by default) — the dungeon inventory and preset screen. If the menu fails to compute or open, the player gets the unexpected-error message and the failure is logged with the menu id.

No permission node: any player may open their own dungeon inventory.

/donjons create <blueprint>

Permission dungeons.create. Requests an instance for <blueprint> directly, bypassing the portal.

Unlike walking into a portal, this only checks that the player is in a party (no-party otherwise) — there is no key check, no requirements evaluation, no leader check and no party-size check. It is the staff/testing entry point; the portal is the player-facing one. See Portals & Keys for what the portal path enforces on top.

On completion the player gets creation-success (with %blueprint_name%) or creation-failure; on success TeleportationService sends the leader and every party member to the responding dungeon server.

/dungeon reload

Permission dungeons.reload. Re-reads config.yml, messages.yml, and fully re-scans rooms/ and blueprints/. Reports success or the exception message in chat, and logs the stack trace on failure. Running instances are unaffected — see Reload.

/dungeon simulate <blueprint> [count]

Permission dungeons.simulate. Generates count layouts (default 100, max 5000) for a blueprint — topology only: no world is created and no schematic is pasted — and reports how many rooms each run produced plus a global budget-utilisation summary. Generation runs off the main thread.

count outside 1..5000 is rejected. Runs are enumerated individually only when count <= 50; larger batches get the summary alone.

The reported budget bounds NORMAL-room growth only. Every layout also carries the START room, the END (boss) room, and however many CAP rooms are needed to seal open doorways, so the total room count almost always exceeds the budget — the summary reports budget utilisation (NORMAL / budget) and total rooms separately. Use it to tune generation.min-rooms/max-rooms/branchiness/rooms.weights without building anything. See Generating a layout.