> For the complete documentation index, see [llms.txt](https://rareitemhunter.gitbook.io/rareitemhunter-remaster/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rareitemhunter.gitbook.io/rareitemhunter-remaster/configuration/placeholders.md).

# Placeholders

Placeholder support requires PlaceholderAPI.

## Player Placeholders

| Placeholder                    | Description                                 |
| ------------------------------ | ------------------------------------------- |
| `%rih_player_kills%`           | Bosses this player has killed               |
| `%rih_player_damage%`          | Total damage dealt to bosses                |
| `%rih_player_boss_deaths%`     | Times killed by a boss                      |
| `%rih_player_eggs_opened%`     | Eggs awakened by this player                |
| `%rih_player_bosses_awakened%` | Alias of eggs opened                        |
| `%rih_player_best_damage%`     | Highest single hit against a boss           |
| `%rih_player_avg_damage%`      | Average damage per hit against bosses       |
| `%rih_player_last_boss_kill%`  | Name of the last boss killed by this player |

## Server Placeholders

| Placeholder                       | Description                                    |
| --------------------------------- | ---------------------------------------------- |
| `%rih_active_eggs%`               | Number of active eggs                          |
| `%rih_active_bosses%`             | Number of active bosses                        |
| `%rih_last_spawned_boss%`         | Name of the last spawned boss                  |
| `%rih_last_killed_boss%`          | Name of the last killed boss                   |
| `%rih_last_boss_killer%`          | Player who killed the last boss                |
| `%rih_next_boss_spawn_seconds%`   | Seconds until the next automatic spawn attempt |
| `%rih_next_boss_spawn_formatted%` | Formatted time until next automatic spawn      |

## Current Boss Placeholders

When multiple bosses are alive, these reflect the first active boss tracked by the plugin.

| Placeholder                     | Description           |
| ------------------------------- | --------------------- |
| `%rih_current_boss_name%`       | Boss name             |
| `%rih_current_boss_hp%`         | Current HP            |
| `%rih_current_boss_max_hp%`     | Max HP                |
| `%rih_current_boss_hp_percent%` | HP percentage         |
| `%rih_current_boss_target%`     | Current target player |
| `%rih_current_boss_world%`      | Boss world            |
| `%rih_current_boss_x%`          | Boss X                |
| `%rih_current_boss_y%`          | Boss Y                |
| `%rih_current_boss_z%`          | Boss Z                |

## Clan and Faction Placeholders

If a supported group plugin is detected and `groups.provider` is enabled, the plugin also exposes:

* `%rih_player_clan%`
* `%rih_player_clan_colored%`
* `%rih_player_clan_rank%`
* `%rih_player_clan_leader%`
* `%rih_player_clan_members%`
* `%rih_player_clan_kdr%`
* `%rih_player_clan_kills%`
* `%rih_clan_kills%`