Games

🎮 Game Instance

The Game object represents an active match in ArenaLegends. You can use it to retrieve information about the current state, active players, and more.

Check the Javadocs for reference.

---

🧮 Accessing Games

The easiest way to retrieve a game instance is through the GameManager or GameDataManager.

By ID

You can look up a game using its specific identifier.

import xericker.arenalegends.core.game.Game;
import xericker.arenalegends.core.game.GameManager;

Game game = GameManager.getById("my-arena");
if (game != null) {
    // Perform actions with the game
}

From a Player

If you want to know if a player is currently in a game:

import xericker.arenalegends.playerdata.instance.GameData;
import xericker.arenalegends.playerdata.manager.GameDataManager;
import xericker.arenalegends.core.game.Game;

GameData data = GameDataManager.getData(player);
if (data != null && data.getGame() != null) {
    Game game = data.getGame();
    player.sendMessage("You are playing in: " + game.getId());
}

---

📋 Structured Data

Once you have a Game object, you can access its structured data and components.

Game State

The state of a game dictates what phase it is currently in (e.g., waiting, starting, in-game).

import xericker.arenalegends.core.game.contract.game.GameState;

if (game.getState() == GameState.IN_GAME) {
    // The match is currently running
}

Players & Teams

You can fetch the list of participating players or determine which team a player belongs to.

import xericker.arenalegends.core.player.team.GameTeam;

// Get all players in the match
List<Player> players = game.getPlayers();

// Get a specific player's team
GameTeam team = game.getTeam(player);
if (team != null) {
    player.sendMessage("You are on team: " + team.getId());
}