# Placeholders

{% hint style="info" %}
We hook into PlaceholderAPI so that you don't have to download any expansions!\
(No /papi ecloud download!)

{% endhint %}

### Relational Placeholders

| Relational Placeholder               | Description                                 |
| ------------------------------------ | ------------------------------------------- |
| %rel\_factionsuuid\_relation%        | The relation between the 2 players          |
| %rel\_factionsuuid\_relation\_color% | Color of the relation between the 2 players |

### Player Placeholders

<table><thead><tr><th width="316">Player Placeholder</th><th>Description</th></tr></thead><tbody><tr><td>%factionsuuid_player_name%</td><td>The player's name</td></tr><tr><td>%factionsuuid_player_lastseen%</td><td>Last time the player was seen on the server or their online status</td></tr><tr><td>%factionsuuid_player_group%</td><td>Player's permission group</td></tr><tr><td>%factionsuuid_player_balance%</td><td>Player's money</td></tr><tr><td>%factionsuuid_player_power%</td><td>Player's power</td></tr><tr><td>%factionsuuid_player_maxpower%</td><td>Max power a player can have</td></tr><tr><td>%factionsuuid_player_kills%</td><td>Kills by this player</td></tr><tr><td>%factionsuuid_player_deaths%</td><td>Deaths by this player</td></tr><tr><td>%factionsuuid_player_role%</td><td>Player's faction role</td></tr><tr><td>%factionsuuid_player_role_name%</td><td>Player's faction role's name</td></tr></tbody></table>

### Faction Placeholders

| Faction Placeholder                                | Description                                                                    |
| -------------------------------------------------- | ------------------------------------------------------------------------------ |
| %factionsuuid\_faction\_name%                      | Faction's tag                                                                  |
| %factionsuuid\_faction\_name\_custom%              | Custom faction tag based on lang.yml CUSTOM name                               |
| %factionsuuid\_faction\_only\_space%               | Literally a space, only if the player is in a faction                          |
| %factionsuuid\_faction\_power%                     | Faction's current power                                                        |
| %factionsuuid\_faction\_powermax%                  | Faction's max power                                                            |
| %factionsuuid\_faction\_dtr%                       | Faction's DTR                                                                  |
| %factionsuuid\_faction\_dtrmax%                    | Faction's max DTR                                                              |
| %factionsuuid\_faction\_maxclaims%                 | Faction's max claims                                                           |
| %factionsuuid\_faction\_description%               | Faction's long description                                                     |
| %factionsuuid\_faction\_claims%                    | Number of claimed chunks                                                       |
| %factionsuuid\_faction\_founded%                   | Date your faction was founded                                                  |
| %factionsuuid\_faction\_joining%                   | If your faction is allowing new members                                        |
| %factionsuuid\_faction\_peaceful%                  | If your faction is peaceful                                                    |
| %factionsuuid\_faction\_powerboost%                | Faction's current powerboost                                                   |
| %factionsuuid\_faction\_leader%                    | Name of the leader                                                             |
| %factionsuuid\_faction\_warps%                     | Number of warps                                                                |
| %factionsuuid\_faction\_raidable%                  | If HCF features are enabled, shows if your faction is raidable                 |
| %factionsuuid\_faction\_home\_world%               | World of your faction's home                                                   |
| %factionsuuid\_faction\_home\_x%                   | X coordinate of your faction's home                                            |
| %factionsuuid\_faction\_home\_y%                   | Y coordinate of your faction's home                                            |
| %factionsuuid\_faction\_home\_z%                   | Z coordinate of your faction's home                                            |
| %factionsuuid\_faction\_land\_value%               | Total value of your faction's land                                             |
| %factionsuuid\_faction\_land\_refund%              | How much your faction would get if they refunded the land                      |
| %factionsuuid\_faction\_bank\_balance%             | Faction's bank balance                                                         |
| %factionsuuid\_faction\_allies%                    | Number of allies                                                               |
| %factionsuuid\_faction\_allies\_players%           | Number of allied players                                                       |
| %factionsuuid\_faction\_allies\_players\_offline%  | Number of allied players offline                                               |
| %factionsuuid\_faction\_enemies%                   | Number of enemies                                                              |
| %factionsuuid\_faction\_enemies\_players%          | Number of enemy players                                                        |
| %factionsuuid\_faction\_enemies\_players\_online%  | Number of enemy players online                                                 |
| %factionsuuid\_faction\_enemies\_players\_offline% | Number of enemy players offline                                                |
| %factionsuuid\_faction\_truces%                    | Number of truces                                                               |
| %factionsuuid\_faction\_truces\_players%           | Number of truced players                                                       |
| %factionsuuid\_faction\_truces\_players\_online%   | Number of truced players online                                                |
| %factionsuuid\_faction\_truces\_players\_offline%  | Number of truced players offline                                               |
| %factionsuuid\_faction\_online%                    | Number of players online in your faction                                       |
| %factionsuuid\_faction\_offline%                   | Number of players offline in your faction                                      |
| %factionsuuid\_faction\_relation\_color%           | Relation color (more useful for territory mode)                                |
| %factionsuuid\_faction\_size%                      | Total online and offline faction members                                       |
| %factionsuuid\_faction\_kills%                     | Total kills your faction has                                                   |
| %factionsuuid\_faction\_deaths%                    | Total deaths your faction has                                                  |
| %factionsuuid\_faction\_maxvaults%                 | Max vaults your faction can have                                               |
| %factionsuuid\_faction\_dtr\_frozen%               | True or false (customizable in lang.yml) for DTR frozen state                  |
| %factionsuuid\_faction\_dtr\_frozen\_time%         | Time remaining in frozen state (configure in main.conf) or blank if not frozen |
| %factionsuuid\_faction\_tnt\_balance%              | TNT bank balance                                                               |
| %factionsuuid\_faction\_tnt\_max\_balance%         | Maximum TNT bank balance                                                       |

{% hint style="info" %}
You can edit any placeholder below to say `faction_territory` instead and it will display the information for the faction in which the player is presently standing. For example, **`%factionsuuid_faction_territory_name%`** will display the name of the faction that owns the chunk the player is standing inside at the moment
{% endhint %}

### Saber Placeholders

| Placeholder                      | Description                   |
| -------------------------------- | ----------------------------- |
| %factionsuuid\_grace\_time%      | Time untill grace is over     |
| %factionsuuid\_faction\_points%  | Number of points faction has  |
| %factionsuuid\_faction\_strikes% | Number of strikes faction has |
