Edit

Placeholder API

[[File:PowerBT.png|center|link=http://wiki.battleplugins.org/Category:BattleTracker:Power]] [[Category: BattleTracker:Power]] [[Category: BattleTracker]]

Within BattleTracker, there is support to display tracker info through a plugin called [https://www.spigotmc.org/resources/placeholderapi.6245/ PlaceholderAPI]. If you are unfamiliar with the plugin, it allows for you to show information with certain placeholders (e.g. %player_name% will return the player name) in plugins that have support for PlaceholderAPI. An example usage of this is displaying your PvP wins through BattleTracker on a scoreboard VIA a scoreboard plugin.

If you also have BattleArena installed, you can display tracker information from it too. An example usage of this is displaying the top players in Arena. The support for these placeholders even extends to custom arena games you have created or even plugins that hook into BattleTracker directly for stats.

== Placeholders == These are the placeholders for BattleTracker. They are split into two sections: player placeholders and rating placeholders. Player placeholders get information on the player that "sees" the placeholder. The rating placeholders get information about players for the rating you specify.

=== Player Placeholders === These placeholders show statistics for a the player viewing the information. This information will look different to each player seeing it ingame.

'''

''' below can be replaced with any arena type or statistic BattleTracker is currently tracking (e.g. pvp, pve, skirmish, etc.).

'''%bt_

_wins%''' Displays the amount wins.

'''%bt_

_losses%''' Displays the amount of losses.

'''%bt_

_kills%''' Displays the amount of kills.

'''%bt_

_deaths%''' Displays the amount of deaths.

'''%bt_

_ties%''' Displays the amount of ties.

'''%bt_

_streak%''' Displays the current streak.

'''%bt_

_maxstreak%''' Displays the max streak.

'''%bt_

_ranking%''' Displays the current ranking.

'''%bt_

_maxranking%''' Displays the max ranking reached.

'''%bt_

_rating%''' Displays the current rating.

'''%bt_

_maxrating%''' Displays the max ranking reached.

'''%bt_

_kdratio%''' Displays the kills to deaths. ratio.

'''%bt_

_wlratio%''' Displays the wins to losses ratio.

=== Rating Placeholders === These placeholders show statistic for the top players. Must be specified at end of placeholder.

'''

''' below can be replaced with any arena type or statistic BattleTracker is currently tracking (e.g. pvp, pve, skirmish, etc.).

'''

''' below can be replaced with the rating you want to get placeholder information from. For example, '''1''' will get information from the #1 player in the leaderboard.

'''%bt

_top_wins

%''' Displays the amount wins.

'''%bt

_top_losses

%''' Displays the amount of losses.

'''%bt

_top_kills

%''' Displays the amount of kills.

'''%bt

_top_deaths

%''' Displays the amount of deaths.

'''%bt

_top_ties

%''' Displays the amount of ties.

'''%bt

_top_streak

%''' Displays the current streak.

'''%bt

_top_maxstreak

%''' Displays the max streak.

'''%bt

_top_ranking

%''' Displays the current ranking.

'''%bt

_top_maxranking

%''' Displays the max ranking reached.

'''%bt

_top_rating

%''' Displays the current rating.

'''%bt

_top_maxrating

%''' Displays the max ranking reached.

'''%bt

_top_kdratio

%''' Displays the kills to deaths. ratio.

'''%bt

_top_wlratio

%''' Displays the wins to losses ratio.

== Return to Index == [[BattleTracker]]

[[Main Page]]