> For the complete documentation index, see [llms.txt](https://cozy-1.gitbook.io/dev-example2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cozy-1.gitbook.io/dev-example2/destroy-the-core/placeholders-placeholderapi.md).

# Placeholders (PlaceholderAPI)

Destroy The Core includes native integration with PlaceholderAPI, allowing you to display event and player statistics anywhere on your server—including scoreboards, tab lists, and chat messages.

To use these, ensure PlaceholderAPI is installed on your server. All placeholders below use the `%dtc_...%` prefix.

#### 🌍 Global Event Placeholders

| **Placeholder**          | **Description**                                                                                |
| ------------------------ | ---------------------------------------------------------------------------------------------- |
| `%dtc_active_count%`     | Returns the total number of currently active DTC events.                                       |
| `%dtc_active_list%`      | Returns a comma-separated list of active event names, or "None" if no events are running.      |
| `%dtc_total_configured%` | Returns the total number of cores registered on the server, regardless of their active status. |

#### ⚔️ Core-Specific Placeholders

*(Note: Replace `<core>` with the exact name of your core, e.g., `%dtc_health_warzone%`)*

| **Placeholder**             | **Description**                                                                               |
| --------------------------- | --------------------------------------------------------------------------------------------- |
| `%dtc_is_active_<core>%`    | Returns "Yes" if the specific core is currently spawned and active, or "No" if it is offline. |
| `%dtc_health_<core>%`       | Returns the live, remaining health (amount of breaks left) for the specific core.             |
| `%dtc_max_health_<core>%`   | Returns the maximum required breaks for the specific core as configured.                      |
| `%dtc_percentage_<core>%`   | Returns the current completion percentage of the core (e.g., `45.5`).                         |
| `%dtc_progress_bar_<core>%` | Displays a dynamic visual progress bar based on your `config.yml` settings.                   |

#### 🏆 Player Statistics Placeholders

| **Placeholder**    | **Description**                                                             |
| ------------------ | --------------------------------------------------------------------------- |
| `%dtc_wins%`       | Returns the player's total core wins formatted with commas (e.g., `1,500`). |
| `%dtc_wins_raw%`   | Returns the player's raw win count as an unformatted number (e.g., `1500`). |
| `%dtc_wins_short%` | Returns the player's total wins in a shortened format (e.g., `1.5k`).       |
| `%dtc_has_wins%`   | Returns "Yes" if the player has 1 or more wins, or "No" if they have 0.     |

#### 🏆 Top Player Leaderboards

*(Replace `#` with a rank from 1 to 10)*

| **Placeholder**    | **Description**                                                            |
| ------------------ | -------------------------------------------------------------------------- |
| `%dtc_top_name_#%` | Returns the name of the player currently sitting at that leaderboard rank. |
| `%dtc_top_wins_#%` | Returns the total formatted win count of the player at that rank.          |

#### ⏱️ Automated Schedule Tracking

| **Placeholder**         | **Description**                                                                            |
| ----------------------- | ------------------------------------------------------------------------------------------ |
| `%dtc_next_event_time%` | Returns a live, optimized countdown until the next scheduled core opens (e.g., `02h 15m`). |
| `%dtc_next_event_name%` | Returns the display name of the core that is scheduled to spawn next.                      |