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
| Alcance | Cuándo | Ejemplo |
|---|---|---|
provided (Maven) / compileOnly (Gradle) | La clase ya existe en el servidor en tiempo de ejecución | API de Spigot/Paper, API de otro plugin |
compile (Maven) / implementation (Gradle) | Tu plugin debe aportarla | Una 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:
depend: [sofyCore] # obligatoria
# softdepend: [sofyCore] # integración opcionalEjemplo con sofyCore
Consulta Configuración de Maven y Gradle para las coordenadas exactas de sofycore-api.