Statistics

📈 Overview

Player statistics are tracked using the PlayerStatistic enum. This structured data system separates global statistics (like gems) from mode-specific statistics (like kills or wins).

Check the Javadocs for reference.

---

🧮 Managing Statistics

You can read and modify player statistics using the StatisticStorage found within their PlayerData.

Accessing Player Data

First, ensure you fetch the player's data profile:

import xericker.arenalegends.playerdata.instance.PlayerData;
import xericker.arenalegends.playerdata.manager.PlayerDataManager;

PlayerData data = PlayerDataManager.getInstance().get(player);
if (data == null) return;

Reading Values

You can get global values (like currency) or game-mode specific values.

import xericker.arenalegends.playerdata.storage.statistic.PlayerStatistic;
import xericker.arenalegends.core.game.contract.game.GameMode;

// Get a global statistic
long gems = data.getStatistics().get(PlayerStatistic.GEMS);

// Get a mode-specific statistic
long soloKills = data.getStatistics().get(GameMode.SOLO, PlayerStatistic.KILLS);

Modifying Values

You can easily add, subtract, or set a statistic's value.

// Add 100 gems
data.getStatistics().add(PlayerStatistic.GEMS, 100);

// Set solo wins to 5
data.getStatistics().set(GameMode.SOLO, PlayerStatistic.WINS, 5);