Guía

Cómo crear un plugin de Paper

Actualizado el 7 de octubre de 2026

Paper es el software de servidor de Minecraft más usado para plugins: ejecuta plugins de Spigot y añade una API más amplia y rápida. Un plugin de Paper es un proyecto Java (o Kotlin) compilado contra paper-api. Esto es lo que necesita, a mano o con una IA que lo compile por ti.

Un ejemplo para empezar.

Genera esto con Codexe

Paso a paso

  1. 1.Elige la versión de Minecraft

    Usa la versión que ejecuta tu servidor. Ella decide la versión de Java: Java 17 antes de la 1.20.5, Java 21 desde la 1.20.5 y Java 25 para la 26.x.

  2. 2.Crea el proyecto

    Un proyecto de Gradle o Maven con la dependencia paper-api de esa versión, desde el repositorio de PaperMC, con el ámbito provided/compileOnly.

  3. 3.Escribe la clase principal

    Una clase que extienda JavaPlugin, con onEnable() para registrar comandos y listeners.

  4. 4.Describe el plugin al servidor

    plugin.yml (name, version, main, api-version, commands, permissions). Paper también admite paper-plugin.yml, con sus propias reglas de carga.

  5. 5.Compila y prueba

    Compila el .jar, ponlo en la carpeta plugins/ de un servidor de prueba Paper, inícialo y revisa si hay errores en la consola.

¿Paper o Spigot?

El código escrito para la API de Spigot funciona en Paper, pero no al revés: Paper añade eventos y métodos (por ejemplo, los componentes de texto de Adventure y muchas API asíncronas) que Spigot no tiene. Escribe para Paper si tu servidor usa Paper; escribe para Spigot si el plugin también debe funcionar en servidores Spigot.

La vía rápida

En Codexe, elige un plugin de Bukkit/Spigot/Paper, di "Paper" y la versión en la petición, y describe lo que hace. Codexe prepara el proyecto y la versión de Java correcta, lo compila, corrige los errores de compilación y te deja entrar en un servidor de prueba Paper con el plugin instalado.

Problemas comunes

  • UnsupportedClassVersionError: el plugin se compiló con una versión de Java más nueva que la que usa el servidor.
  • NoSuchMethodError / NoClassDefFoundError: el plugin usa una API que no existe en la versión del servidor, o una dependencia no se incluyó (shade) en el .jar.
  • El plugin carga pero los comandos no hacen nada: el comando falta en plugin.yml o el ejecutor no está registrado.

Preguntas

¿Los plugins de Paper funcionan en Purpur o Folia?

Purpur es un fork de Paper, así que los plugins de Paper funcionan allí. Folia cambia el manejo de hilos: para funcionar en Folia, un plugin debe estar escrito para su programador por regiones.

¿Puedo escribir un plugin de Paper en Kotlin?

Sí. Codexe puede generar un proyecto Gradle en Kotlin con build.gradle.kts para la misma API de Paper.

Crea ahora un plugin de Paper

Este prompt se abre listo para enviar:

“Un plugin para Paper 1.21.4 llamado Bounties: /bounty set <player> <amount> con la economía de Vault, el asesino recibe la recompensa, /bounty list muestra el top 10, las recompensas se guardan entre reinicios y los mensajes están en config.yml.”

Genera esto con Codexe
Cómo crear un plugin de Paper (Minecraft) | Codexe