Introduction à l'API

ScalaPlot expose une API publique (module scalaplot-api) qui permet à d’autres plugins de lire et modifier l’état des parcelles : récupération d’informations, gestion de la confiance/des bans, claim/réinitialisation/suppression, notations, statut des signalements et événements Bukkit dédiés.

Ajouter la dépendance

Ajoutez Plot comme dépendance souple ou stricte dans votre plugin.yml :

depend: [Plot]
# ou, si optionnel :
softdepend: [Plot]

Et ajoutez le module ScalaPlot-API (contenu dans scalaplot-api/target/ScalaPlot-API-X.X.X.jar) comme dépendance de compilation dans votre projet Maven/Gradle.

Obtenir l’instance de l’API

1. Récupérez le plugin Plot depuis Bukkit.
2. Effectuez un cast vers l’interface PublicAPI.
3. Appelez les méthodes disponibles.

import com.scala.plotAPI.PublicAPI;
import org.bukkit.Bukkit;

PublicAPI api = (PublicAPI) Bukkit.getPluginManager().getPlugin("Plot");

if (api != null) {
    boolean premium = api.isPremium();
    // ...
}

Astuce

Vérifiez toujours que Bukkit.getPluginManager().getPlugin("Plot") n’est pas null avant d’effectuer le cast, afin de gérer correctement le cas où ScalaPlot n’est pas installé ou n’est pas encore chargé.

Ce que l’API expose

• Récupération des parcelles : par position, propriétaire ou ID.
• Gestion de la confiance et des bans : trustPlayer, untrustPlayer, banPlayer, unbanPlayer.
• Opérations sur les parcelles : claimPlot, resetPlot, deletePlot.
• Notations et signalements : getAverageRating, getStatus/setStatus.
• Événements Bukkit : claim, ban, confiance, entrée/sortie, changement de propriétaire, sauvegarde, signalements.
• Managers internes : accès à PlotManager, WorldEditManager, MapManager pour des usages avancés.

Poursuivez avec PublicAPI : méthodes pour la référence complète.