-
Notifications
You must be signed in to change notification settings - Fork 0
PlaceholderAPI
juimuifun edited this page May 20, 2026
·
2 revisions
# PlaceholderAPI Integration
DungeonsTower hooking into [PlaceholderAPI](https://placeholderapi.com/) allows you to display real-time dungeon statistics to your players on scoreboards, action bars, or chat.
**Note:** These placeholders only return valid data when a player is physically standing inside the `world_dungeon` world and within the bounds of a generated maze.
## Available Placeholders
| Placeholder | Output Description | Example Output |
|-------------|--------------------|----------------|
| `%dt_maze%` | The name of the maze the player is currently inside. | `GoblinCave` |
| `%dt_floor%` | The current floor number the player is on. | `1` |
| `%dt_total_floors%` | The total number of floors in the current maze. | `5` |
| `%dt_room_type%` | The specific "type" of cell defined in the JSON. | `BOSS`, `NORMAL`, `STAIRS_UP` |
| `%dt_room_shape%` | The geometric shape of the room the player is standing in. | `CORNER`, `CROSSROAD` |
| `%dt_room_label%` | The custom label defined in the JSON for that specific cell. | `TreasureRoom` |
*(If the player is not in a maze, these will return `None`, `N/A`, or `0` depending on the placeholder).*