Placeholders

%dungeons_experience%

double

The player's live, unclaimed run experience, off the DungeonPlayerData in the dungeon server's in-memory cache. null if they have no cached data (no active instance for their party on this server).

%dungeons_alive%

boolean

Whether the player is still an alive participant of their instance. false when they are dead (spectating) or in no instance.

%dungeons_inInstance%

boolean

Whether the player is currently registered to any instance.

%dungeons_party%

Party

The player's AstralParty party object, for further nesting (%dungeons_party_...%). null if they are not in one.

%dungeons_instance_state%

InstanceState

The player's instance state — CREATING, ACTIVE, ENDING, DESTROYING, DESTROYED, DESTROY_FAILED. See Instance states.

%dungeons_instance_mobs_alive%

int

The number of entities the instance is currently tracking.

%dungeons_instance_mobs_total%

int

The number of mob spawn markers the instance was created with.

%dungeons_inventory_helmet%

ItemStack

Slot 0 of the inventory's own array. null when empty.

%dungeons_inventory_chestplate%

ItemStack

Slot 1, same.

%dungeons_inventory_leggings%

ItemStack

Slot 2, same.

%dungeons_inventory_boots%

ItemStack

Slot 3, same.

%dungeons_inventory_slot_<n>%

ItemStack

Slot n of the inventory's own array. Unlike the four above, an empty slot yields an empty stack rather than null, so a menu can copy-from it unconditionally. n may itself be a placeholder. Out of range or unparseable yields the literal string <invalid slot: n>.

%dungeons_inventory_content%

ItemProvider

All 24 slots as a provider, empty slots included as empty stacks — so a menu layout renders the whole grid and provider index equals slot index.

%dungeons_inventory_equipped%

DungeonInventoryGrid

The grid the player is wearing: the equipped preset's content, or the inventory's own array when none is equipped. Nest further with grid_*.

%dungeons_inventory_presets%

ItemProvider

The player's presets, for a menu layout. Each entry nests as preset_*.

%dungeons_inventory_activePreset%

DungeonInventoryPreset

The equipped preset object, or null.

%dungeons_inventory_hasActivePreset%

boolean

Whether a preset is equipped.

%dungeons_inventory_activePresetId%

String

The equipped preset's UUID, or the literal string none.

%dungeons_inventory_stat_<key>%

double

The summed value of AstralItems stat <key> across every item in equippedContent(). See Stat totals.

%preset_name%

String

The preset's name.

%preset_uuid%

String

Its UUID, as a string.

%preset_content%

ItemProvider

All 24 slots, empty ones as empty stacks.

%preset_slot_<n>%

ItemStack

Slot n, empty slots as empty stacks. Out of range or unparseable yields null (not the <invalid slot> string the inventory uses).

%grid_content%

ItemProvider

All 24 slots, empty ones as empty stacks.

%grid_slot_<n>%

ItemStack

Slot n. Out of range or unparseable yields <invalid slot: n>. Unlike the inventory's own slot_<n>, n is parsed as a plain integer and is not itself placeholder-resolved.

%blueprint_id%

String

The blueprint id.

%blueprint_name%

Component

Its display name, resolved against the calling container.

%blueprint_key%

ItemStack

Its key item, resolved (but not stamped with the dungeons:blueprint PDC — this is the raw wrapper output, not a working key).

%blueprint_particle%

Particle

Its portal particle.

%data_blueprintId%

String

The blueprint the run was for.

%data_experience%

double

Experience accumulated across the run.

%data_killedMobs%

int

Mobs this player personally killed.

%data_duration%

long

Run length in milliseconds, stamped when the player left the dungeon server.

%data_completed%

boolean

Whether the boss was defeated while this player was alive.