☕API Java

Ce document présente l'API Java disponible pour interagir programmatiquement avec le système d'équipes du plugin Horizons.

📝 Introduction

La classe TeamManagerAPI sert de façade publique pour accéder aux fonctionnalités du gestionnaire d'équipes (TeamManager). Cette API permet aux développeurs d'intégrer et de manipuler le système d'équipes d'Horizons dans leurs propres plugins.

📋 Méthodes disponibles

🔍 Vérifications d'équipes

• boolean teamExists(String teamName) - Vérifie si une équipe existe

• boolean isPlayerInTeam(Player player, String teamName) - Vérifie si un joueur est dans une équipe spécifique

ℹ️ Obtention d'informations sur les équipes

• String getTeamPrefix(String teamName) - Obtient le préfixe d'une équipe (renvoie null si l'équipe n'existe pas)

• String getTeamDisplayName(String teamName) - Obtient le nom d'affichage d'une équipe (renvoie null si l'équipe n'existe pas)

• List<UUID> getTeamPlayerUUIDs(String teamName) - Obtient la liste des UUID des joueurs d'une équipe

• List<Player> getTeamPlayers(String teamName) - Obtient la liste des objets Player d'une équipe

🏆 Récupération des équipes

• List<String> getAllTeams() - Obtient la liste de toutes les équipes

• List<String> getTeamsSortedByScore() - Obtient la liste des équipes triées par score (ordre décroissant)

• Map<String, Integer> getAllTeamScores() - Obtient une map associant chaque équipe à son score

👤 Gestion des joueurs

• String getPlayerTeam(Player player) - Obtient le nom de l'équipe d'un joueur (renvoie null si le joueur n'a pas d'équipe)

📊 Gestion des scores

• int getTeamScore(String teamName) - Obtient le score d'une équipe

• void setTeamScore(String teamName, int score) - Définit le score d'une équipe

• void addTeamScore(String teamName, int points) - Ajoute des points au score d'une équipe

• void removeTeamScore(String teamName, int points) - Retire des points du score d'une équipe

💡 Exemples d'utilisation

🎁 Exemple 1: Vérifier l'équipe d'un joueur et ajouter des points

public void rewardPlayerTeam(Player player, int points) {
    String teamName = horizonsAPI.getTeamManagerAPI().getPlayerTeam(player);
    
    if (teamName != null) {
        horizonsAPI.getTeamManagerAPI().addTeamScore(teamName, points);
        player.sendMessage("Votre équipe a reçu " + points + " points !");
    } else {
        player.sendMessage("Vous n'êtes dans aucune équipe !");
    }
}

🏅 Exemple 2: Obtenir le classement des équipes

public void displayTeamRanking(Player player) {
    List<String> teams = horizonsAPI.getTeamManagerAPI().getTeamsSortedByScore();
    
    player.sendMessage("§6=== Classement des équipes ===");
    
    int rank = 1;
    for (String teamName : teams) {
        String displayName = horizonsAPI.getTeamManagerAPI().getTeamDisplayName(teamName);
        int score = horizonsAPI.getTeamManagerAPI().getTeamScore(teamName);
        
        player.sendMessage("§e#" + rank + " §f" + displayName + " §7- §f" + score + " points");
        rank++;
    }
}

🤝 Exemple 3: Vérifier si deux joueurs sont dans la même équipe

public boolean arePlayersInSameTeam(Player player1, Player player2) {
    String team1 = horizonsAPI.getTeamManagerAPI().getPlayerTeam(player1);
    String team2 = horizonsAPI.getTeamManagerAPI().getPlayerTeam(player2);
    
    // Si les deux joueurs ont une équipe et que c'est la même
    return team1 != null && team1.equals(team2);
}

⚙️ Notes d'implémentation

L'API est conçue pour être thread-safe et performante. Les listes retournées sont généralement des copies des collections internes, ce qui permet une utilisation sécurisée sans risquer de corrompre l'état interne du plugin Horizons.

Pour utiliser cette API, vous devez d'abord obtenir une référence au plugin Horizons via le gestionnaire de plugins de Bukkit :

Horizons horizonsPlugin = (Horizons) Bukkit.getPluginManager().getPlugin("Horizons");
TeamManagerAPI teamManagerAPI = horizonsPlugin.getAPI().getTeamManagerAPI();