Skip to main content

Leaderboards and Statistic Tracking

BattleArena has support in companion with BattleTracker to track arena statistics and leaderboards.

Tracking Statistics

In order to track statistics, the first step is to simply download BattleTracker. Upon restarting the server with BattleTracker, the following commands will become available:

  • /<arena> top - Shows the leaderboard of player wins in the competition
  • /<arena> rank [name] - Shows the rank and associated statistics of a specific player

Storing Additional Statistics

In some cases, it may be desired to track additional statistics that are not tracked by BattleArena by its own. An example of this in use is ArenaCTF, which tracks the flags captured and shows them in /ctf rank [name].

By default, BattleArena does not track any statistics that are not otherwise tracked by BattleTracker, so this feature is generally most useful for third party plugins that provide their own. However, it is documented here for the sake of visibility. 

In your <arena>.yml, you can simply add the following section to track those statistics permanently. Here is an example with the flags-captured statistic.

tracking:
  stats-tracked:
    flags-captured:
      key: flags_captured
      type: add