Dungeon Party Menu

Action entry for the dungeon party lobby selection menu. Uses the GUI extension's layout system (layoutPool + mainLayoutId).

Lobby slots are dynamically injected based on maxSimultaneousInstances. Buttons use buttonType markers in the layout pool.

Layout System

The menu uses the GUI extension's layout engine. Define your visual structure in layoutPool. Lobby slots are injected at positions marked with buttonType: DUNGEON_LOBBY_SLOT, and buttons are resolved via buttonType: DUNGEON_READY, DUNGEON_LEAVE, DUNGEON_AUTO_FILL.

Buttons use virtual coordinates (x, y).

Buttons System

Use buttonType markers in the layout pool to configure interactive buttons. If a button type is absent from the layout, no button of that type appears.

ButtonType	Description	Default Position
DUNGEON_INFO	Information button	(8, 5)
DUNGEON_READY	Ready / Not Ready toggle (dual-state)	(3, 5)
DUNGEON_LEAVE	Leave lobby button	(0, 5)
DUNGEON_AUTO_FILL	Auto-join first available lobby	(5, 5)

Placeholders

Placeholder	Description
{index}	Lobby index (1-based)
{players}	Current player count
{max}	Max party size
{available}	Available slots
{status}	Lobby status
{ready}	"READY" or "WAITING"
{time}	Remaining seconds
{player_names}	All player names with ready/not-ready formatting
{ready_players}	Names of ready players
{not_ready_players}	Names of not-ready players
{player}	Player name (join/quit messages)
{missing}	Missing player count
{dungeon_name}	Dungeon instance name

Configuration

dungeon_party_menu — Map

Properties

dungeonInstance

"> Target dungeon instance for this lobby. lobbyItem — Item

Item used for lobby slots. inventoryTitle

"> Title of the inventory. Supports placeholders. lobbyName

"> Name format for lobby slots. Supports {index}, {players}, {max}. lobbyLore

"> Lore format for lobby slots. joinMessage

"> Message sent to the lobby when a player joins. quitMessage

"> Message sent to the lobby when a player leaves. readyPlayerPrefix

"> Prefix for ready players in lobby lore. readyPlayerSuffix

"> Suffix for ready players in lobby lore. notReadyPlayerPrefix

"> Prefix for not-ready players in lobby lore. notReadyPlayerSuffix

"> Suffix for not-ready players in lobby lore. guiType — GuiType

GUI type. layoutPool

"> Pool of layout definitions. Use buttonType markers for lobby slots and buttons. mainLayoutId

"> ID of the main layout. audio — GuiAudioData

Audio configuration.

Example

dungeon_party_menu:
  id: "dungeon_party_lobby"
  dungeonInstance: "ancient_temple"
  inventoryTitle: "<blue>👥 LOBBY</blue>"
  lobbyItem: PLAYER_HEAD
  layoutPool:
    - id: "main"
      type: simple
      items:
        - item: PLAYER_HEAD
          x: 0
          y: 0
          buttonType: "DUNGEON_LOBBY_SLOT"
          name: "<gold>Lobby {index}"
        - item: LIME_DYE
          x: 7
          y: 0
          buttonType: "DUNGEON_READY"
          name: "<green>✅ Ready</green>"
        - item: BARRIER
          x: 7
          y: 2
          buttonType: "DUNGEON_LEAVE"
          name: "<red>🚪 Leave</red>"
        - item: BOOK
          x: 7
          y: 4
          buttonType: "DUNGEON_INFO"
          name: "<gold>Info</gold>"