# 🔖 PlaceholderAPI

YnwMVP offers **full PlaceholderAPI support**, enabling you to display dynamic, real-time information about players, bosses, territories, seasons, and daily statistics in any plugin that supports PlaceholderAPI (e.g., chat formats, scoreboards, holograms, tab lists, and more).

This page serves as a complete reference guide for all available placeholders.

### Overview

nwMVP registers **three PlaceholderAPI expansions**:

1. **nwdailyplayer** – Daily boss statistics
2. **nwseasonplayer** – Season information and player season statistics
3. **nwterritory** – Territory ownership and statistics

**Placeholder Format**

text

```yaml
%<identifier>_<field>%
```

**Examples**

text

```yaml
%nwdailyplayer_damage%
%nwseasonplayer_player_points%
%nwterritory_zone1_name%
```

**Requirements**

* PlaceholderAPI must be installed and enabled.
* nwMVP automatically registers all placeholders on server startup.
* Most placeholders work with offline players (as long as data exists).

### Placeholder Reference Tables

#### Daily Statistics (nwdailyplayer)

| Placeholder                     | Description                              |
| ------------------------------- | ---------------------------------------- |
| %nwdailyplayer\_attempts\_used% | Number of daily boss attempts used today |
| %nwdailyplayer\_max\_attempts%  | Maximum daily attempts allowed           |
| %nwdailyplayer\_top\_rank%      | Times achieved top 3 rank today          |
| %nwdailyplayer\_damage%         | Total damage dealt to bosses today       |
| %nwdailyplayer\_damage\_taken%  | Total damage taken from bosses today     |
| %nwdailyplayer\_healing%        | Total healing done today                 |
| %nwdailyplayer\_first\_strike%  | Times got first strike today             |
| %nwdailyplayer\_final\_blow%    | Times got final blow today               |
| %nwdailyplayer\_reset\_in%      | Time remaining until daily reset         |

#### Season Statistics (nwseasonplayer)

| Placeholder                        | Description                                |
| ---------------------------------- | ------------------------------------------ |
| %nwseasonplayer\_id%               | Current season ID                          |
| %nwseasonplayer\_name%             | Current season display name                |
| %nwseasonplayer\_state%            | Current season state                       |
| %nwseasonplayer\_player\_name%     | Player name in season data                 |
| %nwseasonplayer\_player\_damage%   | Total damage dealt this season             |
| %nwseasonplayer\_player\_taken%    | Total damage taken this season             |
| %nwseasonplayer\_player\_healing%  | Total healing done this season             |
| %nwseasonplayer\_player\_deaths%   | Number of deaths this season               |
| %nwseasonplayer\_player\_points%   | Season points (tier points)                |
| %nwseasonplayer\_player\_tier%     | Current tier                               |
| %nwseasonplayer\_player\_rank%     | Current season rank                        |
| %nwseasonplayer\_rank\_movement%   | Rank change since last update              |
| %nwseasonplayer\_active\_days%     | Number of unique active days this season   |
| %nwseasonplayer\_last\_active%     | Last active timestamp                      |
| %nwseasonplayer\_join\_date%       | Season join date                           |
| %nwseasonplayer\_top\_ranks%       | Times achieved top 3 rank this season      |
| %nwseasonplayer\_non\_top%         | Participations without top 3 rank          |
| %nwseasonplayer\_participation%    | Total boss participations this season      |
| %nwseasonplayer\_boss\_kills%      | Boss kills this season                     |
| %nwseasonplayer\_first\_strike%    | First strikes this season                  |
| %nwseasonplayer\_final\_blow%      | Final blows this season                    |
| %nwseasonplayer\_top\_appearances% | Times appeared in top rankings this season |

**Aliases**

* %nwseasonplayer\_player\_points% → also %nwseasonplayer\_season\_points%, %nwseasonplayer\_tier\_points%
* %nwseasonplayer\_player\_tier% → also %nwseasonplayer\_current\_tier%
* %nwseasonplayer\_player\_rank% → also %nwseasonplayer\_season\_rank%

#### Territory Placeholders (nwterritory)

**Territory-Specific (replace \<territory\_id> with actual ID, e.g., zone1)**

| Placeholder Pattern                              | Description                             |
| ------------------------------------------------ | --------------------------------------- |
| %nwterritory\_\<id>\_name%                       | Territory display name                  |
| %nwterritory\_\<id>\_owner\_guild%               | Current owner guild name                |
| %nwterritory\_\<id>\_guild\_uuid%                | Owner guild UUID                        |
| %nwterritory\_\<id>\_owner\_guild\_leader%       | Leader of owner guild                   |
| %nwterritory\_\<id>\_status%                     | Last capture status                     |
| %nwterritory\_\<id>\_consecutive\_captures%      | Consecutive captures by current owner   |
| %nwterritory\_\<id>\_total\_captures%            | Total captures ever                     |
| %nwterritory\_\<id>\_maintenance\_paid%          | Maintenance paid status                 |
| %nwterritory\_\<id>\_guild\_damage%              | Guild damage in last capture            |
| %nwterritory\_\<id>\_guild\_damage\_taken%       | Guild damage taken in last capture      |
| %nwterritory\_\<id>\_guild\_healing%             | Guild healing in last capture           |
| %nwterritory\_\<id>\_top\_player\_damage%        | Player with most damage in last capture |
| %nwterritory\_\<id>\_top\_player\_damage\_taken% | Player who took most damage             |
| %nwterritory\_\<id>\_top\_player\_healing%       | Player with most healing                |
| %nwterritory\_\<id>\_first\_strike\_player%      | Player who got first strike             |
| %nwterritory\_\<id>\_final\_blow\_player%        | Player who got final blow               |
| %nwterritory\_\<id>\_max\_participants%          | Peak participants in last capture       |
| %nwterritory\_\<id>\_guild\_count%               | Unique guilds that participated         |
| %nwterritory\_\<id>\_previous\_guild\_uuid%      | Previous owner guild UUID               |
| %nwterritory\_\<id>\_previous\_guild%            | Previous owner guild name               |
| %nwterritory\_\<id>\_pvp\_player%                | Player with most PvP kills              |
| %nwterritory\_\<id>\_pvp\_kills%                 | Total PvP kills in last capture         |
| %nwterritory\_\<id>\_capture\_time%              | Timestamp of last successful capture    |

**Player Location-Based**

All territory-specific fields are available with the prefix player\_location\_.

**Example:** %nwterritory\_player\_location\_name% → current territory's display name **Note:** Player must be online and inside a territory region.

**Player Guild-Based**

| Placeholder                                    | Description                                        |
| ---------------------------------------------- | -------------------------------------------------- |
| %nwterritory\_player\_guild\_territory\_count% | Number of territories owned by player's guild      |
| %nwterritory\_player\_guild\_total\_captures%  | Sum of all captures across guild-owned territories |

**Note:** Player must be online and in a guild.

### Usage Examples

#### Chat (e.g., EssentialsX)

text

```yaml
{player} dealt %nwdailyplayer_damage% damage today!
```

#### Scoreboard

text

```yaml
Daily Stats
Damage: %nwdailyplayer_damage%
Healing: %nwdailyplayer_healing%
Reset in: %nwdailyplayer_reset_in%
```

#### Holograms (e.g., DecentHolograms)

YAML

```yaml
lines:
  - '&6&lCurrent Territory'
  - '&7Name: &f%nwterritory_player_location_territory_name%'
  - '&7Owner: &a%nwterritory_player_location_owner_guild%'
  - '&7Consecutive: &b%nwterritory_player_location_consecutive_captures%'
```

### Important Notes

* **Caching & Performance**: Most values are cached; territory data may query the database if not in memory.
* **Offline Support**: Player-specific placeholders work for offline players when data exists.
* **Error/Default Values**:
  * none, no-data, never, 0, 0.00, false, etc., depending on context.
* **Real-time Updates**: Values update instantly for online players.