Introduzione alla API

ScalaPlot espone una API pubblica (modulo scalaplot-api) che permette ad altri plugin di leggere e modificare lo stato dei plot: recupero informazioni, gestione di fiducia/ban, claim/reset/delete, valutazioni, stato delle segnalazioni ed eventi Bukkit dedicati.

Aggiungere la dipendenza

Aggiungi Plot come dipendenza soft o hard nel tuo plugin.yml:

depend: [Plot]
# oppure, se opzionale:
softdepend: [Plot]

E aggiungi il modulo ScalaPlot-API (contenuto in scalaplot-api/target/ScalaPlot-API-X.X.X.jar) come dipendenza di compilazione nel tuo progetto Maven/Gradle.

Ottenere l’istanza della API

1. Recupera il plugin Plot da Bukkit.
2. Effettua il cast all’interfaccia PublicAPI.
3. Chiama i metodi disponibili.

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

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

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

Consiglio

Verifica sempre che Bukkit.getPluginManager().getPlugin("Plot") non sia null prima di effettuare il cast, per gestire correttamente il caso in cui ScalaPlot non sia installato o non si sia ancora caricato.

Cosa espone la API

• Recupero plot: per posizione, per proprietario, per ID.
• Gestione fiducia e ban: trustPlayer, untrustPlayer, banPlayer, unbanPlayer.
• Operazioni sui plot: claimPlot, resetPlot, deletePlot.
• Valutazioni e segnalazioni: getAverageRating, getStatus/setStatus.
• Eventi Bukkit: claim, ban, trust, enter/leave, cambio proprietario, backup, segnalazioni.
• Manager interni: accesso a PlotManager, WorldEditManager, MapManager per usi avanzati.

Prosegui con PublicAPI: metodi per il riferimento completo.