Saltar al contenido

Desarrollo de plugins

Cómo usar dependencias Maven en plugins de Minecraft

Entiende los alcances provided y compile, el shading y las dependencias de plugin.yml cuando tu plugin de Minecraft usa la API de otro plugin.

  • Maven
  • Gradle
  • Java

Un plugin de Minecraft suele depender de dos tipos de librerías: APIs que aporta el servidor u otros plugins en tiempo de ejecución, y librerías que tu plugin debe llevar dentro de su JAR.

Provided frente a compile

AlcanceCuándoEjemplo
provided (Maven) / compileOnly (Gradle)La clase ya existe en el servidor en tiempo de ejecuciónAPI de Spigot/Paper, API de otro plugin
compile (Maven) / implementation (Gradle)Tu plugin debe aportarlaUna librería de JSON o HTTP

Si incluyes la API de otro plugin en tu JAR, existirán dos copias de las mismas clases en tiempo de ejecución, lo que provoca conflictos de clases. Usa siempre provided para las APIs de plugins.

Shading y relocalización

Las librerías que sí aportas suelen incluirse (shade) en el JAR y relocalizarse a un paquete privado para que no choquen con otro plugin que lleve una versión distinta. El propio sofyCore relocaliza sus librerías de bases de datos y de red por este motivo.

Declara la dependencia del plugin

Compilar contra una API no basta: Bukkit también debe cargar antes el otro plugin. Decláralo en plugin.yml:

plugin.ymlYAML
depend: [sofyCore]     # obligatoria
# softdepend: [sofyCore]  # integración opcional

Ejemplo con sofyCore

Consulta Configuración de Maven y Gradle para las coordenadas exactas de sofycore-api.