Skip to main content
The Dungeon Extension provides a comprehensive framework for creating and managing instanced dungeons. It handles lobby creation, party synchronization, world generation, and performance tracking.

Features

Instanced Worlds

Dedicated worlds created/deleted per run.

Party System

Integration with native and external parties.

Lobby GUI

Menus for waiting, joining, and starting.

Persistence

Tracks attempts, completions, and times.

Dynamic Content

Room-based procedural elements.

HUD Integration

Placeholders for real-time status.

Entries

Core Elements

Dungeon Instance: Rules and world logic.
Category: Grouping for menus.
Room: Floor regions and events.

Interaction

Enter Action: Player join logic.
Leave Action: Player exit logic.
Loot Chest: Reward containers.

Menus

Global Menu: Browser for all dungeons.
Party Lobby: Team coordination.

Commands

All commands use /dungeon.
CommandDescriptionPermission
/dungeon start <name>Launch instance manuallyadmin
/dungeon enter <id>Join instanceuse
/dungeon leaveExit instanceuse
/dungeon instance-menuOpen lobbyuse

Placeholders

All placeholders use the prefix %typewriter_dungeon_.
PlaceholderDescription
%typewriter_dungeon_Dungeon%Returns the current value for Dungeon.
%typewriter_dungeon_attempts%Returns the current value for attempts.
%typewriter_dungeon_best%Returns the current value for best.
%typewriter_dungeon_best_time%Returns the current value for best time.
%typewriter_dungeon_completions%Returns the current value for completions.
%typewriter_dungeon_dungeon%Returns the current value for dungeon.
%typewriter_dungeon_format%Returns the current value for format.
%typewriter_dungeon_formatted%Returns the current value for formatted.
%typewriter_dungeon_health%Returns the current value for health.
%typewriter_dungeon_healthpercent%Returns the current value for healthpercent.
%typewriter_dungeon_inst%Returns the current value for inst.
%typewriter_dungeon_list%Returns a formatted list of list.
%typewriter_dungeon_max%Returns the numeric amount for max.
%typewriter_dungeon_maxhealth%Returns the numeric amount for maxhealth.
%typewriter_dungeon_name%Returns the identifier or name for name.
%typewriter_dungeon_percent%Returns the current value for percent.
%typewriter_dungeon_player%Returns the current value for player.
%typewriter_dungeon_players%Returns the current value for players.
%typewriter_dungeon_ratio%Returns the current value for ratio.
%typewriter_dungeon_remaining%Returns the current value for remaining.
%typewriter_dungeon_total%Returns the numeric amount for total.