🔖 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

%<identifier>_<field>%

Examples

text

%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

{player} dealt %nwdailyplayer_damage% damage today!

Scoreboard

text

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

Holograms (e.g., DecentHolograms)

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.