> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sentrystudios.org/llms.txt
> Use this file to discover all available pages before exploring further.

# PlaceholderAPI Integration

> Display global and player-specific wipe statistics using PlaceholderAPI.

SentryWipe seamlessly integrates with PlaceholderAPI to allow you to display wipe statistics on scoreboards, holograms, menus, and more.

Our internal API calculates these statistics efficiently so they won't lag your server when called frequently by scoreboard plugins.

## Global Placeholders

These placeholders return statistics for the entire server.

| Placeholder                | Description                                                                     |
| -------------------------- | ------------------------------------------------------------------------------- |
| `%sentrywipe_total_wipes%` | Returns the total number of wipes executed across the entire server's lifetime. |

## Player-Specific Placeholders

These placeholders return statistics relating to the specific player viewing them.

| Placeholder                   | Description                                                                                       |
| ----------------------------- | ------------------------------------------------------------------------------------------------- |
| `%sentrywipe_wipes%`          | Returns the total number of times the viewing player has been wiped.                              |
| `%sentrywipe_wipes_<player>%` | Returns the total number of wipes for a specific named player (e.g., `%sentrywipe_wipes_Notch%`). |

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Placeholders are returning raw text (e.g., %sentrywipe_total_wipes%)" icon="circle-exclamation">
    This means SentryWipe hasn't registered with PlaceholderAPI correctly, or PlaceholderAPI is missing.

    1. Ensure PlaceholderAPI is installed and up-to-date.
    2. Check your SentryWipe `hooks.yml` and ensure `placeholderapi` is set to `enabled: true`.
    3. Restart your server.
  </Accordion>

  <Accordion title="Can I download the expansion from /papi ecloud?" icon="cloud-arrow-down">
    No! SentryWipe's placeholders are bundled internally with the plugin for maximum performance and stability. You do **not** need to run `/papi ecloud download sentrywipe`. They will work automatically as long as the hook is enabled in `hooks.yml`.
  </Accordion>
</AccordionGroup>