Guía

Cómo crear un plugin de Spigot

Actualizado el 7 de octubre de 2026

Un plugin de Spigot usa la API de Bukkit/Spigot, así que funciona en Spigot y en todos sus forks, Paper incluido. Eso lo convierte en la opción más amplia cuando no sabes dónde se va a ejecutar el plugin. Esta guía cubre el proyecto, el código y la compilación.

Cambia el ejemplo para que se ajuste a tu servidor.

Genera esto con Codexe

Paso a paso

  1. 1.Prepara Java y una herramienta de compilación

    Instala el JDK que corresponda a tu versión de Minecraft (17, 21 o 25) y usa Maven o Gradle.

  2. 2.Añade la API de Spigot

    Añade spigot-api para tu versión desde el repositorio de Spigot con el ámbito provided. Solo hace falta para compilar; el servidor la proporciona en tiempo de ejecución.

  3. 3.Escribe comandos y listeners

    Registra un CommandExecutor con getCommand("name").setExecutor(...) y los listeners de eventos con registerEvents.

  4. 4.Escribe el plugin.yml

    Nombre, versión, clase principal, api-version (desde la 1.13), comandos y permisos.

  5. 5.Compila e instala

    mvn package, y después copia el .jar de target/ a la carpeta plugins/ del servidor y reinicia.

Versiones antiguas (1.8 a 1.12)

Muchos servidores de minijuegos siguen usando la 1.8. La API es más antigua (sin api-version y con nombres de materiales distintos), así que el plugin debe escribirse para esa versión y no copiarse de un tutorial de la 1.21. Codexe te pregunta la versión y escribe el código para esa API.

Con Codexe

Describe el plugin y di "Spigot" con la versión. Codexe genera el proyecto Maven, lo compila, corrige los errores y te deja probarlo en un servidor de prueba de esa versión antes de descargarlo.

Preguntas

¿Necesito BuildTools?

Solo para ejecutar un servidor Spigot o para usar NMS (código interno del servidor). Para compilar contra la API normal, basta con la dependencia spigot-api.

¿Plugin de Spigot o plugin de Paper?

Spigot si debe funcionar en todas partes; Paper si tu servidor usa Paper y quieres su API extra. Mira cómo crear un plugin de Paper.

Crea un plugin de Spigot

Este prompt se abre listo para enviar:

“Un plugin para Spigot 1.8.8 llamado Kits: /kit <name> da un conjunto de objetos configurable con un cooldown por kit, kits definidos en config.yml, permiso kits.<name> por kit y cooldowns guardados entre reinicios.”

Genera esto con Codexe
Cómo crear un plugin de Spigot: preparación, código y compilación | Codexe