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.

«Packet queue has … packets»: Simple Voice Chat no da abasto

Así se ve el mensaje:

[voicechat] Packet queue has <Count> 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 pulso de Minecraft; lo normal son 20) o una carga alta de CPU. Los jugadores oyen entonces la voz entrecortada o ausente, mientras que 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 renderizado (view-distance) y la distancia de simulación (simulation-distance) en server.properties, en Archivos. 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 es suficiente, cambia a más rendimiento en Ajustes y suscripción → Plan.

Bueno saber: Algunos mensajes sueltos poco después del inicio o al explorar zonas nuevas no son preocupantes, siempre que 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.

«No bot token»: falla el inicio de sesión de Discord

Así se ve el mensaje:

[DiscordSRV] No bot token has been set in the config; a bot token is required to connect to Discord.
[voicechat-discord] Failed to load a bot. Please make sure that the token property is a string and the vc_id property is a number.
[DiscordWhitelist] Edit plugins/DiscordWhitelist/config.yml and set discord.bot-token, then run /discordwhitelist reload.

Qué hay detrás: las extensiones de Discord inician sesión con un bot propio. Para ello necesitan su token, una cadena de caracteres secreta como una contraseña; si falta o no es válido, la conexión con Discord permanece desactivada, mientras que Minecraft sigue funcionando. En voicechat-discord, además, los tipos de datos pueden ser incorrectos: token debe ser texto y vc_id un número.

Así lo solucionas:

  1. Crea un bot en el Discord Developer Portal o elige el que ya tienes. Si hace falta, genera un nuevo token.
  2. Introduce el token en la configuración desde Archivos: en DiscordSRV, en plugins/DiscordSRV/config.yml bajo BotToken; en DiscordWhitelist, en plugins/DiscordWhitelist/config.yml bajo discord.bot-token. Para otras extensiones, sigue su guía.
  3. En voicechat-discord, token debe ser una cadena de caracteres y vc_id el número que se necesita según la guía.
  4. Si hace falta, invita al bot a tu servidor de Discord, guarda y reinicia Minecraft.

Bueno saber: nunca compartas el token; si se publica, restablécelo. Si hay errores de intents, activa en el Developer Portal los «Privileged Gateway Intents» que se te soliciten.

«Could not download GeoLiteAPI database»: falta 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 de MaxMind; esta descarga ha fallado. Si aparece FileNotFoundException con «No such file or directory», falta el archivo local indicado o una carpeta relacionada. El plugin sigue funcionando; las funciones que dependen del país, como los bloqueos por país, permanecen inactivas sin la base de datos.

Cómo solucionarlo:

  1. Si se trata de problemas de descarga temporales, el próximo reinicio lo intentará de nuevo.
  2. Si aparece «No such file or directory», comprueba en Archivos la ubicación indicada y la ruta configurada en la configuración del plugin. Configura la base de datos siguiendo las instrucciones de la versión de tu plugin.
  3. Si la descarga sigue sin funcionar, revisa la configuración en plugins/<Plugin>/. Si tu versión requiere una clave de licencia, introduce tu clave válida en el campo previsto para ello.
  4. Guarda, reinicia el servidor y comprueba en la Consola si el mensaje desaparece.

Conviene saber: Si no usas funciones que dependan del país, puedes ignorar el mensaje. El resto de funciones del plugin siguen funcionando.

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.

DonatePay: carácter no válido en la dirección de consulta

Así se ve el mensaje:

java.net.URISyntaxException: Illegal character in query at index <Position>: <Address with token removed>

Qué hay detrás: La integración de DonatePay quiere consultar nuevas donaciones, pero no puede procesar la dirección que ha construido para ello. Una URI es una dirección estructurada; su parte de consulta contiene aquí un carácter no permitido. Por eso falla la consulta de donaciones, mientras que el servidor de Minecraft sigue funcionando.

Así lo solucionas:

  1. Abre la Consola o logs/latest.log en Archivos y comprueba si el rastro del error menciona la integración de DonatePay.
  2. Revisa la configuración del plugin en Archivos. Compara las credenciales introducidas con la guía y elimina los espacios o las comillas que se hayan copiado por error.
  3. Actualiza la integración en Plugins o sustituye su archivo subido por ti en Archivos. Reinicia el servidor por completo.
  4. Si el mensaje persiste, entrega al autor del plugin el rastro del error depurado. Elimina todos los valores de token antes de compartirlo.

El plugin de mochilas no puede usar su paquete de recursos

Así se ve el mensaje:

[ᴠᴢʙᴀᴄᴋᴘᴀᴄᴋ] Die URL der Datei '<Archivo>.zip' ist ungültig!

Qué hay detrás: El plugin no puede usar un archivo de paquete de recursos configurado. O bien la dirección no es válida, o bien el paquete externo se detecta como defectuoso. Por ello, la representación de la mochila muestra texturas y fuentes incorrectas o ausentes; el servidor sigue funcionando.

Así lo solucionas:

  1. Comprueba en Archivos, dentro de la configuración del plugin, qué archivo de paquete y qué dirección están configurados.
  2. Compara el archivo con la guía de la versión de tu plugin. Usa una dirección de descarga directa válida y un archivo completo que corresponda.
  3. Reinicia el servidor por completo. Haz que el cliente vuelva a cargar el paquete corregido y comprueba las texturas y las fuentes de la mochila.

libdatachannel: falla la conexión del canal de datos o el envío

Así se ve el mensaje:

[tel.schich.libdatachannel.LibDataChannel] SCTP connection failed
[tel.schich.libdatachannel.LibDataChannel] SCTP sending failed, errno=104

Qué hay detrás: libdatachannel es una biblioteca para conexiones de datos. SCTP designa el método de transmisión que se usa en ella. No se logra establecer una conexión o ya no se puede enviar; la conexión del plugin afectada deja de funcionar. El servidor de juego sigue en marcha.

Así lo solucionas:

  1. Vuelve a intentar la conexión afectada. Comprueba si falla solo una entrada concreta o varias conexiones.
  2. En la Consola, lee las líneas anteriores y posteriores al mensaje. Asigna la biblioteca al plugin que se menciona allí.
  3. Compara sus ajustes de red y requisitos con la documentación. Comprueba especialmente los puertos previstos allí y la accesibilidad del extremo remoto.
  4. Comprueba en Plugins si hay una actualización adecuada. Si el error persiste, abre un ticket e indica la hora y los mensajes adicionales.

Netty: la notificación de red llega a un ejecutor ya finalizado

Así se ve el mensaje:

Failed to submit a listener notification task. Event loop shut down?
java.util.concurrent.RejectedExecutionException: event executor terminated

Qué hay detrás: Netty procesa las tareas de red en un bucle de eventos. Aquí ya ha finalizado, mientras todavía se intenta encolar una notificación. La notificación se descarta. Al detener el servidor puede aparecer como error secundario; durante el juego puede haber una función de red afectada.

Así lo solucionas:

  1. Comprueba la hora en la Consola y compárala con el inicio o la detención del servidor.
  2. Si el error aparece durante el funcionamiento, guarda el mensaje completo de logs/latest.log junto con los errores anteriores. Las líneas de llamada siguientes se llaman stacktrace y pueden mostrar el componente implicado.
  3. Comprueba el componente asociado en Plugins y la Versión del servidor en busca de actualizaciones compatibles entre sí. Reemplaza los archivos con el servidor detenido.
  4. Reinicia por completo y repite la conexión afectada. Si el error persiste, abre un ticket con la hora y el mensaje completo.

¿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.