Muchos plugins no funcionan por sí solos. Los plugins premium comprueban una clave de licencia al iniciar, las conexiones con Discord, Telegram o VK necesitan un token (una especie de contraseña para un bot o una interfaz), los plugins de chat de voz abren un puerto de red propio y algunos descargan bibliotecas o bases de datos desde internet. Si falta alguno de ellos o es rechazado, el plugin escribe un mensaje en el log. Normalmente solo deja de funcionar la función de ese plugin; en un caso, el plugin detiene el servidor a propósito.

Cada sección de abajo trata un mensaje. Encontrarás el mensaje completo en la Consola o en Archivos, en logs/latest.log; la configuración de los plugins está en plugins/<Plugin>/. Antes de cambiar nada, crea una copia en Copias de seguridad. Las claves y los tokens son secretos: no se los enseñes a nadie y recórtalos de las capturas de pantalla.

DonutShop rechaza la clave de licencia

Así se ve el mensaje:

[DonutShop]             DONUTSHOP ERROR
[DonutShop] The licensing server rejected this key.

Qué hay detrás: DonutShop es un plugin de tienda que, al iniciarse, comprueba su clave de licencia en el servidor de licencias del autor. Esa comprobación falló en el último inicio. Incluso un valor introducido y no vacío puede ser inválido, haber caducado o haberse emitido para otra instalación. El servidor de Minecraft puede seguir funcionando, pero DonutShop no está disponible de forma fiable: los jugadores no pueden confiar en la tienda.

Así lo solucionas:

  1. Consigue o comprueba la clave de licencia gratuita a través de la página del proyecto DonutShop en Modrinth oficial.
  2. En Archivos, abre la configuración de DonutShop (plugins/DonutShop/config.yml) e introduce la clave en license-key. Ponla entre comillas, sin espacios delante ni detrás.
  3. Guarda el archivo y reinicia el servidor.
  4. Revisa la Consola: el error solo está solucionado cuando el banner «DONUTSHOP ERROR» ya no aparece en el nuevo inicio.

Conviene saber: Si has copiado la clave de otro servidor, consigue una propia para este servidor.

LibreLogin detiene el servidor: no se puede cargar una biblioteca

Así se ve el mensaje:

[LibreLogin] Failed to load libraries, stopping server to prevent damage
… Failed to download library <Biblioteca>

Qué hay detrás: LibreLogin es un plugin de inicio de sesión con el que los jugadores entran con contraseña. Al iniciarse descarga bibliotecas, es decir, partes de programa que no incluye por sí mismo, entre ellas PacketEvents. Si esta descarga falla, LibreLogin detiene el servidor a propósito en lugar de seguir funcionando a medias. Por tanto, el servidor no arranca hasta que se resuelva el problema.

Así lo solucionas:

  1. Reinicia el servidor una vez. Si la fuente de descarga solo estuvo inaccesible un momento, a menudo funciona en el siguiente intento.
  2. Actualiza LibreLogin en Plugins a la última versión para tu software de servidor. Si tienes PacketEvents instalado como plugin independiente, actualízalo también.
  3. Reinicia y comprueba en la Consola si las bibliotecas se cargan ahora.
  4. Si el mensaje aparece en cada inicio, el servidor no alcanza la dirección de descarga. Puede deberse al acceso a internet, a la resolución de nombres (DNS, que traduce direcciones en números IP) o a la propia dirección. Si no avanzas, abre un ticket e indica la hora del mensaje.

Conviene saber: Cómo actualizar y sustituir plugins se explica en Instalar y gestionar plugins de Minecraft.

Simple Voice Chat descarta paquetes de voz

Así se ve el mensaje:

[voicechat] Packet queue has <Cantidad> packets
[voicechat] Dropping voice chat packets!

Qué hay detrás: Simple Voice Chat transmite la voz entre jugadores que están cerca en el juego. El mensaje significa que el chat de voz no da abasto con el procesamiento: los paquetes de voz se acumulan en una cola o se descartan. La causa es un servidor sobrecargado en ese momento, con TPS bajos (ticks por segundo, el ritmo de Minecraft; lo normal son 20) o una carga de CPU alta. Los jugadores oyen entonces la voz entrecortada o ausente. El servidor en sí sigue funcionando.

Así lo solucionas:

  1. Averigua qué genera la carga, por ejemplo con spark: spark: encontrar y entender el lag en el servidor de Minecraft.
  2. Reduce la distancia de visión (view-distance) y la distancia de simulación (simulation-distance) en los Ajustes o en server.properties. Así el servidor carga menos chunks, es decir, secciones del mundo de 16 × 16 bloques.
  3. Reduce el número de entidades (criaturas, animales, objetos en el suelo) en lugares concretos y revisa los plugins que generan mucha carga.
  4. Si no basta, cambia a más rendimiento en Ajustes y suscripción → Plan.

Conviene saber: Algunos mensajes sueltos poco después del inicio o al explorar zonas nuevas son inofensivos mientras vuelvan a cesar.

Simple Voice Chat no consigue su puerto UDP

Así se ve el mensaje:

[voicechat] Failed to run voice chat at UDP port <Puerto>
[voicechat] Disabling Simple Voice Chat

Qué hay detrás: Simple Voice Chat transmite la voz a través de un puerto UDP propio. UDP es el método de red para datos rápidos en tiempo real, como la voz. El puerto configurado no pertenece a tu servidor o ya está ocupado, por ejemplo porque aún está el valor predeterminado de las instrucciones del plugin. Sin puerto, el chat de voz se desactiva; el juego en sí sigue funcionando con normalidad.

Así lo solucionas:

  1. En Archivos, abre el archivo plugins/voicechat/voicechat-server.properties. Si usas Simple Voice Chat como mod, está en config/voicechat/voicechat-server.properties.
  2. Establece port con el número de puerto de tu servidor. Tu puerto de juego está habilitado para TCP y UDP.
  3. Guarda el archivo y reinicia el servidor.
  4. Comprueba en la Consola que el mensaje ya no aparece y prueba el chat de voz en el juego.

Con más detalle: Configurar Simple Voice Chat en el servidor de Minecraft.

Conviene saber: Un puerto UDP solo lo puede abrir un programa a la vez. Si otro plugin ya usa el mismo puerto, por ejemplo Geyser para jugadores de Bedrock, uno de los dos necesita otro puerto que esté asignado a tu servidor.

El plugin de Discord no tiene un token de bot válido

Así se ve el mensaje:

[DiscordSRV] No bot token has been set in the config; a bot token is required to connect to Discord.
[DiscordSRV] The bot token is invalid
[EssentialsDiscord] An error occurred while logging into Discord

Qué hay detrás: Los plugins de Discord como DiscordSRV o EssentialsX Discord se conectan a Discord con un bot propio. Para ello necesitan el token del bot, una cadena de caracteres larga que funciona como una contraseña. En la configuración no hay ninguno, o Discord rechaza el introducido, por ejemplo porque entretanto se restableció. La conexión con Discord queda desactivada y el servidor de Minecraft sigue funcionando con normalidad.

Así lo solucionas:

  1. En el Discord Developer Portal, crea una aplicación con bot o elige tu bot existente. En la sección «Bot», copia el token o genera uno nuevo.
  2. En Archivos, abre el config.yml del plugin, por ejemplo plugins/DiscordSRV/config.yml, e introduce el token (en DiscordSRV, en el campo BotToken).
  3. Invita al bot a tu servidor de Discord, si aún no lo has hecho.
  4. Guarda el archivo y reinicia el servidor.

Conviene saber: Si después de «could not connect to Discord because:» aparece una indicación sobre intents, activa en el Developer Portal los «Privileged Gateway Intents» que se piden para el bot. Si un token se ha hecho público, restablécelo allí e introduce el nuevo.

El plugin no puede descargar la base de datos de países

Así se ve el mensaje:

[AuthMe] Could not download GeoLiteAPI database [FileNotFoundException]: plugins/AuthMe/GeoLite2-Country.mmdb (No such file or directory)

Qué hay detrás: Algunos plugins, como AuthMe, asignan las direcciones IP a un país. Para ello descargan una base de datos de países, normalmente GeoLite2 del proveedor MaxMind. Esta descarga ha fallado. El plugin sigue funcionando; solo las funciones que dependen del país, como los bloqueos por país, permanecen inactivas mientras falte la base de datos.

Así lo solucionas:

  1. Normalmente es un problema temporal del otro extremo. El siguiente reinicio vuelve a intentar la descarga; no tienes que hacer nada de inmediato.
  2. Si el mensaje persiste durante varios inicios, revisa la configuración del plugin en plugins/<Plugin>/. A menudo el plugin necesita una clave de licencia propia para la descarga, y la configuración indica el campo correspondiente.
  3. Introduce la clave, guarda y reinicia el servidor.

Conviene saber: Si no usas funciones que dependan del país, puedes ignorar el mensaje. El inicio de sesión y el resto de funciones del plugin funcionan igualmente.

DonutShop está bloqueado sin clave de licencia

Así se ve el mensaje:

[DonutShop]             DONUTSHOP LOCKED
[DonutShop] No license key is set in config.yml.
[DonutShop] Then run: /link <your-key>

Qué significa: DonutShop solo se inicia con una clave de licencia. En su config.yml no hay ninguna, por eso la tienda permanece bloqueada. La clave es gratuita, pero tienes que conseguirla una vez con el autor. El servidor de Minecraft en sí no se ve afectado.

Cómo solucionarlo:

  1. Consigue la clave gratuita con el autor del plugin. El mensaje indica cómo hacerlo, mediante un enlace de Discord, en las líneas alrededor del banner.
  2. Ejecuta /link <tu-clave> tal como indica el mensaje, o introduce la clave en plugins/DonutShop/config.yml.
  3. Reinicia el servidor.
  4. Comprueba en la Consola si el banner "DONUTSHOP LOCKED" ha desaparecido.

Conviene saber: Si después aparece "DONUTSHOP ERROR", la clave fue rechazada. En ese caso te ayuda la sección sobre la licencia rechazada de DonutShop.

Se rechaza el token de VK del plugin

Así se ve el mensaje:

com.vk.api.sdk.exceptions.ApiAuthException: User authorization failed (5): User authorization failed: invalid access_token (4).

Qué significa: Algunos plugins se conectan con VK, la red social VKontakte. Para ello necesitan un token de acceso, una especie de contraseña para la interfaz. VK ha rechazado el token introducido ("invalid access_token"), así que no es válido, ha caducado o ha sido revocado. Las funciones de VK del plugin están desactivadas, el resto del servidor funciona con normalidad.

Cómo solucionarlo:

  1. Genera en VK un nuevo token de acceso con los permisos que exige el plugin. Cuáles son se indica en las instrucciones del plugin.
  2. En Archivos, abre la configuración del plugin en plugins/<Plugin>/ y sustituye el token antiguo por el nuevo.
  3. Guarda el archivo y reinicia el servidor.
  4. Comprueba en la Consola que el mensaje ya no aparece.

Conviene saber: El stacktrace que aparece debajo, es decir, las líneas con sangría que empiezan por at …, muestra qué plugin está afectado. Junto a com.vk.api aparece allí el nombre del paquete del plugin.

El plugin no puede proporcionar su resourcepack

Así se ve el mensaje:

java.io.IOException: HTTP 403 dla http://<Dirección>/<Pack>.zip
Failed to start resourcepack server: Server is not publicly reachable on <Dirección>:<Puerto>

Qué significa: Algunos plugins entregan a los jugadores un resourcepack propio. Para ello lo descargan desde una dirección, lo generan ellos mismos o inician un pequeño servidor web integrado desde el que los jugadores lo descargan. Uno de estos pasos ha fallado. Los jugadores no reciben el pack y faltan las texturas o funciones que dependen de él. El servidor sigue funcionando.

Cómo solucionarlo:

  1. Lee el estado HTTP del mensaje: 403 significa acceso denegado, 404 significa archivo no encontrado.
  2. Abre en el navegador la dirección del pack que figura en la configuración del plugin. Debe descargar directamente el archivo ZIP y no mostrar una vista previa ni una página de inicio de sesión.
  3. Corrige la dirección o sube el pack a un lugar que lo sirva públicamente.
  4. Si el plugin usa un servidor web integrado, indica allí únicamente un puerto que esté asignado a tu servidor en el panel y sea accesible públicamente.
  5. Reinicia el servidor.

El plugin necesita una clave de API para un servicio externo

Así se ve el mensaje:

Please set your <Servicio> API key
Get your API key from: https://<Proveedor>/…
accessToken=MISSING

Qué significa: El plugin trabaja con un servicio externo, por ejemplo para estadísticas o para conectarse con una página web. Para ello necesita una clave de API o credenciales de acceso. Una clave de API es un identificador con el que el plugin se identifica ante el servicio. En la configuración falta. Hasta que la introduzcas, el plugin no funcionará; el resto del servidor sigue funcionando.

Cómo solucionarlo:

  1. Lee el mensaje: normalmente indica el servicio, el archivo y el campo, y a menudo también la dirección donde obtener la clave ("Get your API key from:").
  2. Crea una cuenta en el servicio y genera allí la clave.
  3. En Archivos, abre el archivo indicado en plugins/<Plugin>/ e introduce la clave. El archivo suele estar en formato YAML, donde la sangría con espacios determina la estructura; no la modifiques y pon el valor entre comillas.
  4. Guarda el archivo y reinicia el servidor.

Conviene saber: Si después el plugin indica que no puede leer el archivo, te ayuda El archivo de configuración de un plugin es defectuoso.

El plugin premium no encuentra una clave de licencia válida

Así se ve el mensaje:

No License Key Found!
Please enter a valid key in license.yml
Authentication failed! API key is invalid

Qué significa: El plugin es un plugin premium o necesita una clave del proveedor y no encuentra ninguna válida en su configuración. Entonces se desactiva por completo o desactiva algunas funciones. El servidor sigue funcionando, solo que sin las funciones de este plugin.

Cómo solucionarlo:

  1. Busca la clave de tu compra, por ejemplo en tu cuenta de la página donde compraste el plugin, o pregunta al proveedor.
  2. En Archivos, abre el archivo que indica el mensaje, normalmente plugins/<Plugin>/license.yml o plugins/<Plugin>/config.yml, e introduce la clave.
  3. Guarda el archivo y reinicia el servidor.
  4. Si no tienes clave, elimina el plugin en Plugins en lugar de dejarlo funcionando permanentemente con errores.

Conviene saber: Descarga los plugins premium solo desde la página oficial de venta. Las versiones de fuentes no oficiales, en las que se ha eliminado la comprobación de licencia, contienen con frecuencia software malicioso.

El bot de Telegram del plugin no se inicia

Así se ve el mensaje:

Error removing old webhook

Qué significa: Un plugin con conexión a Telegram se registra al iniciarse en Telegram con un bot. Para ello primero elimina un webhook antiguo, es decir, una dirección guardada a la que Telegram enviaría los mensajes nuevos. Esto ha fallado, normalmente porque el token del bot no es válido o porque Telegram no estaba accesible en ese momento. La función de Telegram permanece desactivada, el servidor de Minecraft sigue funcionando con normalidad.

Cómo solucionarlo:

  1. En Telegram, abre el chat con @BotFather y haz que te muestre el token de tu bot o que genere uno nuevo.
  2. En Archivos, abre la configuración del plugin en plugins/<Plugin>/ y sustituye el token. Cópialo completo; un token de bot empieza con un número y dos puntos.
  3. Guarda el archivo y reinicia el servidor.
  4. Comprueba en la Consola que el mensaje ya no aparece.

Conviene saber: Si el mensaje aparece solo una vez y en el siguiente inicio ya no, Telegram no estuvo accesible durante un momento. En ese caso no tienes que cambiar nada.

El plugin no obtiene un puerto de red propio

Así se ve el mensaje:

Failed to bind to /<Address>:<Port>
[PlasmoVoice] Failed to start the udp server

Qué hay detrás: Algunos plugins abren un puerto de red propio, por ejemplo para un chat de voz como Plasmo Voice o para una página web con mapa o estadísticas. La dirección o el puerto configurados no están disponibles en tu servidor: el puerto no está asignado a él, ya está en uso, o en la configuración figura una dirección IP fija que el servidor no puede utilizar así. La función del plugin queda desactivada, el resto del servidor sigue funcionando.

Así lo solucionas:

  1. En Archivos, abre la configuración del plugin en plugins/<Plugin>/ y busca las entradas del puerto y de la dirección.
  2. Introduce un puerto que esté asignado a tu servidor en el panel y que todavía esté libre.
  3. Deja la dirección vacía o establece 0.0.0.0. Esto significa: accesible en todas las interfaces de red del servidor.
  4. Guarda el archivo, reinicia el servidor y comprueba en la Consola que el mensaje ya no aparece.

Bueno saber: Un puerto solo puede abrirlo un programa a la vez. Si dos plugins usan el mismo, cada uno necesita uno propio. Más información sobre los puertos: Comprobar los puertos de Minecraft y los errores de conexión.

Un plugin o servicio adicional no consigue su puerto

Así se ve el mensaje:

[<Plugin>] Failed to start HTTP server: Address already in use
java.net.BindException: Address already in use

Qué hay detrás: Un plugin o un servicio adicional, como el chat de voz, una web propia, Query o RCON, quiere abrir un puerto propio que ya está ocupado. A menudo, en su configuración figura el puerto del juego, y el servidor ya lo ha abierto él mismo al iniciarse. El servidor sigue funcionando con normalidad y los jugadores pueden unirse, solo que esa función concreta queda desactivada.

Así lo solucionas:

  1. En la Consola, lee el nombre entre corchetes que aparece antes del mensaje, por ejemplo [<Plugin>]. En Salud del servidor aparece en „Plugin o servicio afectado“.
  2. En Archivos, abre la configuración en plugins/<Plugin>/ y busca la entrada del puerto. Para Query y RCON son query.port y rcon.port en el archivo server.properties.
  3. Introduce un puerto que no sea el del juego y que ningún otro plugin utilice. La pestaña Ports muestra todos los puertos de tu servidor.
  4. Para Simple Voice Chat y otros plugins conocidos, los asistentes de Plugins configuran automáticamente un puerto libre.
  5. Guarda el archivo, reinicia el servidor y comprueba en la Consola que el mensaje ya no aparece.

Bueno saber: Un reinicio por sí solo no ayuda mientras en la configuración siga el mismo puerto. Más información sobre los puertos: Comprobar los puertos de Minecraft y los errores de conexión.

¿Tu mensaje no aparece aquí?

Lee el mensaje completo en la Consola o en logs/latest.log, incluidas las líneas anteriores. El nombre entre corchetes al principio de la línea, por ejemplo [DiscordSRV], suele indicar el plugin. Si falta, te ayuda el stacktrace: en las líneas con sangría que empiezan por at … aparecen nombres de paquetes y carpetas que apuntan al plugin o al mod. Qué claves, tokens o puertos necesita un plugin lo explica su página de proyecto. Antes de cambiar la configuración, crea una copia de seguridad. Si no avanzas, abre un ticket e indica la hora del mensaje.