Introducción a la API

ScalaPlot expone una API pública (módulo scalaplot-api) que permite a otros plugins leer y modificar el estado de las parcelas: obtener información, gestionar confianza/baneos, reclamar/restaurar/eliminar, valoraciones, estado de los reportes y eventos de Bukkit dedicados.

Añadir la dependencia

Añade Plot como dependencia suave o dura en tu plugin.yml:

depend: [Plot]
# o, si es opcional:
softdepend: [Plot]

Y añade el módulo ScalaPlot-API (contenido en scalaplot-api/target/ScalaPlot-API-X.X.X.jar) como dependencia de compilación en tu proyecto Maven/Gradle.

Obtener la instancia de la API

1. Recupera el plugin Plot desde Bukkit.
2. Haz un cast a la interfaz PublicAPI.
3. Llama a los métodos disponibles.

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

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

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

Consejo

Comprueba siempre que Bukkit.getPluginManager().getPlugin("Plot") no sea null antes de hacer el cast, para gestionar correctamente el caso en que ScalaPlot no esté instalado o aún no se haya cargado.

Qué expone la API

• Obtención de parcelas: por ubicación, propietario o ID.
• Gestión de confianza y baneos: trustPlayer, untrustPlayer, banPlayer, unbanPlayer.
• Operaciones sobre parcelas: claimPlot, resetPlot, deletePlot.
• Valoraciones y reportes: getAverageRating, getStatus/setStatus.
• Eventos de Bukkit: reclamo, baneo, confianza, entrada/salida, cambio de propietario, copia de seguridad, reportes.
• Managers internos: acceso a PlotManager, WorldEditManager, MapManager para usos avanzados.

Continúa con PublicAPI: métodos para la referencia completa.