Aquí encontrarás los mensajes que aparecen en el registro del servidor en relación con los jugadores de Bedrock. Provienen de dos direcciones: en un servidor Java, el plugin Geyser traduce la conexión de los jugadores de Bedrock y Floodgate les permite entrar sin una cuenta de Java. En un servidor Bedrock nativo (Bedrock Dedicated Server), en cambio, los mensajes suelen provenir de add-ons, es decir, paquetes de comportamiento y de recursos.

Cada sección trata exactamente un mensaje. Encontrarás el texto completo en la Consola y, en los servidores Java, además en Archivos dentro de logs/latest.log. Lee también las líneas inmediatamente posteriores, ya que a menudo indican el paquete afectado o la causa real.

Antes de modificar archivos de configuración, add-ons o archivos del mundo, crea una copia en Copias de seguridad. Así podrás volver al estado anterior en cualquier momento.

„Unable to load Geyser locale map“: archivo de idioma de Geyser no cargado

Así se ve el mensaje:

java.lang.AssertionError: Unable to load Geyser locale map for en_GB
Caught previously unhandled exception in Paper Async Command Builder Thread Pool - <Number>
java.lang.AssertionError: Unable to load Geyser locale map for de_DE

Qué hay detrás: Geyser no puede cargar los datos de idioma necesarios. Por ello, al unirse desde Bedrock falla el inicio de sesión; los ejemplos muestran el error también al construir comandos en Paper. En ese caso pueden verse afectadas las sugerencias de comandos mientras el servidor sigue funcionando. Los errores de descarga que lo acompañan o los datos de idioma guardados dañados ayudan a acotar la causa.

Así lo solucionas:

  1. Reinicia el servidor por completo y sigue el inicio en la Consola.
  2. Comprueba si además aparece „Unable to download and extract … locale“. Este mensaje se refiere a la descarga de los archivos de idioma de Minecraft; más abajo hay una sección propia sobre ello.
  3. Si el error persiste, detén el servidor y haz una copia de los archivos de Geyser. Comprueba en Plugins si hay una versión actual y adecuada de Geyser disponible, y sustituye el archivo del plugin con el servidor detenido.
  4. Si hay errores adicionales de descarga o de caché, haz una copia y elimina en Archivos los datos de idioma descargados afectados de plugins/Geyser-Spigot/locales o la .cache de Geyser. Conserva tus personalizaciones y config.yml.
  5. Reinicia y prueba la unión desde Bedrock y las sugerencias de comandos. Si el mensaje persiste, abre un ticket e indica la hora del mensaje.

„Exception caught in session …“: conexión de Geyser de un jugador de Bedrock interrumpida

Así se ve el mensaje:

[Geyser-Spigot] Exception caught in session of unknown (pre-login)
[Geyser-Spigot] Error thrown in <Player>'s event loop!
[Geyser-Spigot] An exception occurred:

Qué hay detrás: Para cada jugador de Bedrock, Geyser mantiene una sesión propia y traduce en ella todo lo que se intercambia entre el cliente de Bedrock y el servidor de Java. Si algo ha salido mal en esta traducción, normalmente solo se desconecta a ese jugador; el servidor y todos los demás jugadores siguen funcionando. „pre-login“ significa que la conexión se interrumpió antes del inicio de sesión; una ReadTimeoutException significa que los datos no llegaron a tiempo. Un IllegalAccessError en formularios puede afectar al acceso entre Geyser y Floodgate; por eso, revisa ambos juntos.

Cómo solucionarlo:

  1. Anota la hora, el jugador afectado y lo que estaba haciendo en ese momento, por ejemplo, abrir un menú o cambiar de mundo.
  2. Actualiza Geyser y Floodgate a la última versión en Plugins. Si los subiste tú mismo, reemplaza los archivos JAR antiguos en plugins/ en lugar de añadir los nuevos al lado.
  3. Reinicia el servidor y haz que el jugador repita la acción.
  4. Si el error se repite siempre con el mismo jugador o la misma acción, infórmalo en el Discord del proyecto Geyser con la línea del error y las líneas que aparecen debajo.

Bueno saber: Puedes ignorar un mensaje aislado con „pre-login“ si ningún jugador informa de problemas.

Un add-on notifica un error de script

Así se ve el mensaje:

[Scripting] [<Add-on>] LocationInUnloadedChunkError: Trying to access location (<x>, <y>, <z>) which is not in a chunk currently loaded and ticking.
[Scripting] [<Add-on>] InvalidEntityError: Failed to get property 'dimension' due to Entity being invalid (has the Entity been removed?).

Qué hay detrás: Muchos add-ons de Bedrock incluyen scripts propios en el paquete de comportamiento. Estas líneas las notifica el propio script del add-on, así que el error está en el add-on y no en el servidor. Son típicos los accesos a una entidad que ya no existe o a una zona que no está cargada en ese momento. El servidor sigue funcionando y, normalmente, solo falla brevemente una función del add-on. Si hay muchísimos mensajes, el add-on puede reducir el rendimiento.

Así lo solucionas:

  1. Lee el nombre del add-on. Aparece en el segundo corchete.
  2. Compara la versión de Bedrock de tu servidor en Versión con las versiones que indica el creador del add-on.
  3. Si hay una edición más reciente del add-on, crea una copia de seguridad e instálala siguiendo sus instrucciones.
  4. Si el add-on molesta en el juego, desactívalo como prueba. Para ello, elimina en Archivos su entrada de worlds/<Mundo>/world_behavior_packs.json y reinicia.

Bueno saber: Los contenidos que solo aporta el add-on pueden desaparecer del mundo al desactivarlo. El error del script solo puede corregirlo su creador; las líneas con "at" le ayudan a hacerlo.

„The following issues were found when loading packs“: add-on de Bedrock defectuoso

Así se ve el mensaje:

The following issues were found when loading packs:
Provided 'pack.name' element has an invalid value in pack manifest; Defaulting to resource pack.
The property '/header/min_engine_version' has a version of '<Versión>' which is too high. The highest value we accept is '<Versión>'.

Qué hay detrás: Cada paquete de add-on tiene un archivo de descripción manifest.json. En él figuran, entre otras cosas, el nombre, el identificador, la versión y la versión de Bedrock que el paquete necesita como mínimo. Si el servidor encuentra errores ahí al iniciarse, los enumera con sangría bajo esta línea: primero el paquete y debajo el motivo. Según el error, no carga el paquete en absoluto o lo carga de otra forma a la esperada, por ejemplo, como paquete de recursos en lugar de paquete de comportamiento („Defaulting to resource pack“).

Cómo solucionarlo:

  1. Lee las líneas con sangría bajo el mensaje. Indican el paquete y el motivo.
  2. Si pone „too high“, el add-on necesita una versión de Bedrock más reciente que la de tu servidor. Usa una versión anterior del add-on o espera a que la versión adecuada esté disponible en Versión o Actualizaciones.
  3. En el caso de otros motivos, normalmente ayuda la versión más reciente del add-on del creador.
  4. Si editaste manifest.json tú mismo, revísalo en Archivos. Debe ser un JSON válido (llaves, comas, comillas) y contener todos los campos obligatorios, por ejemplo format_version, header con name, uuid y version, así como modules.
  5. Reinicia y comprueba si la lista ha desaparecido.

No se puede leer la configuración de Geyser

Así se ve el mensaje:

[Geyser-Spigot] Failed to read/create config.yml! Make sure it's up to date and/or readable+writable!
org.geysermc.geyser.platform.spigot.shaded.org.spongepowered.configurate.loader.ParsingException: …

Qué hay detrás: Geyser lee sus ajustes de plugins/Geyser-Spigot/config.yml. El archivo está escrito en YAML, un formato de texto en el que la sangría con espacios y los dos puntos determinan la estructura. Una ParsingException debajo significa que el archivo está dañado en algún punto, a menudo tras una edición manual. Con menos frecuencia está desactualizado o no se puede leer o escribir. Sin una configuración válida, Geyser normalmente no se inicia y los jugadores de Bedrock no pueden entrar al servidor. Los jugadores de Java no notan nada.

Así lo solucionas:

  1. Detén el servidor y abre en Archivos el archivo plugins/Geyser-Spigot/config.yml.
  2. Revisa las líneas que menciona el mensaje de error: tabulaciones en lugar de espacios, sangría desplazada, falta de dos puntos o comillas sin cerrar.
  3. Si no encuentras el error, cambia el nombre del archivo, por ejemplo a config.yml.alt. Geyser creará un nuevo archivo estándar en el siguiente inicio.
  4. Después, traspasa solo los valores necesarios del archivo antiguo. El puerto de Bedrock debe coincidir con el puerto UDP que el panel asigna a tu servidor.
  5. Inicia el servidor y comprueba en la Consola que Geyser se inicia sin errores.

Bueno saber: Si también un archivo recién generado muestra el error, es más probable que se deba a los permisos de archivo. Si no avanzas, abre un ticket e indica la hora del mensaje.

Floodgate está cargado dos veces

Así se ve el mensaje:

java.lang.IllegalArgumentException: Duplicate handler name: floodgate-init

Qué hay detrás: Al iniciarse, Floodgate se engancha a la conexión de red del servidor para poder reconocer a los jugadores de Bedrock. Esta intervención solo puede existir una vez. El mensaje indica que Floodgate se ha cargado por segunda vez. Normalmente hay dos archivos de Floodgate en la carpeta plugins/, por ejemplo una versión antigua y una nueva. A veces también otro plugin incluye Floodgate por su cuenta. Entonces, los jugadores de Bedrock pueden fallar al entrar.

Así lo solucionas:

  1. Abre en Archivos la carpeta plugins/ y busca todos los archivos que tengan "floodgate" en el nombre y terminen en .jar.
  2. Conserva solo uno, preferiblemente el más reciente, y borra los demás.
  3. En los plugins instalados recientemente, comprueba si según su descripción incluyen Floodgate. En ese caso, solo necesitas una de las dos fuentes.
  4. Reinicia el servidor y haz que entre un jugador de Bedrock.

Bueno saber: La carpeta plugins/floodgate no es un segundo plugin. Contiene los ajustes y la clave de Floodgate y se conserva.

Un add-on contiene entradas que el servidor no entiende

Así se ve el mensaje:

[FeatureRegistry] Feature rule <add-on>:<name> can't place internal feature type.
[Animation] Error: can't find animation <name>

Qué hay detrás: Los add-ons describen criaturas, objetos, bloques, animaciones y partes de la generación del mundo en archivos propios. Si el servidor Bedrock no entiende alguna de estas entradas en su versión, escribe una línea como esta en el registro. «Feature rule» se refiere, por ejemplo, a reglas que distribuyen plantas o estructuras por el mundo. Esa parte del add-on no funciona o solo funciona en parte, pero el resto y el servidor siguen funcionando. Normalmente el add-on está creado para otra versión de Bedrock.

Así lo solucionas:

  1. Encuentra el paquete afectado. La parte anterior a los dos puntos suele ser la abreviatura del add-on; otras líneas indican la ruta behavior_packs/….
  2. Comprueba en Versión qué versión de Bedrock tiene tu servidor.
  3. Crea una copia de seguridad, descarga del creador la edición del add-on que corresponda a esa versión y sustituye el paquete antiguo.
  4. Reinicia y comprueba si las líneas desaparecen.

Conviene saber: Después de una actualización del servidor Bedrock, estas líneas suelen aparecer en mayor número hasta que los creadores adaptan sus add-ons.

Geyser espera Floodgate, pero Floodgate no está

Así se ve el mensaje:

Auth-type set to Floodgate but Floodgate is not installed

Qué hay detrás: En la configuración de Geyser el tipo de inicio de sesión está establecido en floodgate. Así, los jugadores de Bedrock pueden unirse sin una cuenta de Java adicional. Para ello, el plugin Floodgate debe estar instalado y activo. Si falta, Geyser se desactiva y los jugadores de Bedrock no pueden entrar al servidor. Los jugadores de Java no se ven afectados.

Así lo solucionas:

  1. Comprueba en Plugins o en la carpeta plugins/ si Floodgate está presente y si muestra un error propio al iniciar.
  2. Si falta, instala Floodgate en la carpeta plugins/ desde la misma fuente que Geyser y compatible con el software de tu servidor.
  3. Si no quieres usar Floodgate, establece en su lugar el valor auth-type en online en plugins/Geyser-Spigot/config.yml. Entonces los jugadores de Bedrock necesitarán además una cuenta de Java.
  4. Reinicia el servidor y prueba la conexión con Bedrock.

Más detalles: Configurar el crossplay de Bedrock con Geyser y Floodgate

Geyser no puede descargar los archivos de idioma

Así se ve el mensaje:

[Geyser-Spigot] Unable to download and extract <Idioma> locale!

Qué hay detrás: Al iniciarse, Geyser descarga de Mojang los archivos de idioma de Minecraft. Aquí esa conexión se interrumpió; debajo suele aparecer «Connection reset». Hasta el próximo inicio correcto, los jugadores de Bedrock verán textos sin traducir o no podrán unirse en absoluto. El servidor en sí y los jugadores de Java no se ven afectados.

Así lo solucionas:

  1. Reinicia el servidor. A menudo la descarga funciona en el siguiente intento.
  2. Fíjate en la Consola durante el inicio para ver si el mensaje vuelve a aparecer.
  3. Si persiste, detén el servidor y elimina en Archivos la carpeta plugins/Geyser-Spigot/locales o la carpeta .cache de Geyser.
  4. Inicia de nuevo y prueba la conexión con Bedrock.

Conviene saber: Si al unirse aparece el mensaje «Unable to load Geyser locale map», normalmente es consecuencia de esta descarga fallida. Si falla durante varios inicios, abre un ticket e indica la hora del mensaje.

Geyser no alcanza un servicio de red necesario

Así se ve el mensaje:

[Geyser-Spigot] Got an error
java.net.ConnectException: Connection refused

Qué hay detrás: Para funcionar, Geyser establece conexiones con otros destinos, por ejemplo con un destino configurado o con servicios externos. Aquí una de esas conexiones no se pudo establecer. La línea justo debajo indica el motivo: ConnectException significa que el destino la ha rechazado, a menudo porque allí no hay nada en ejecución. NoRouteToHostException significa que la dirección no es accesible en absoluto. Lo que deja de funcionar depende del destino.

Así lo solucionas:

  1. Lee por completo las líneas bajo «Got an error». A menudo allí aparece la dirección a la que Geyser quería conectarse.
  2. Si has cambiado una dirección de destino o un puerto en plugins/Geyser-Spigot/config.yml, compáralos con los datos del panel y corrígelos.
  3. Si el destino está en otro servidor, comprueba que esté en funcionamiento y accesible.
  4. Actualiza Geyser en Plugins y reinicia el servidor.

Conviene saber: Si el mensaje aparece solo una vez y los jugadores de Bedrock siguen pudiendo entrar al servidor, puedes observarlo primero en lugar de intervenir de inmediato.

Geyser no puede abrir su puerto de Bedrock

Así se ve el mensaje:

[Geyser-Spigot] Failed to start Geyser on <IP>:<Puerto>

Qué hay detrás: Geyser acepta conexiones de Bedrock a través de un puerto UDP propio. UDP es el protocolo de red que Bedrock utiliza para la conexión. Geyser no pudo abrir este puerto: o bien ya lo ocupa otro servicio, o bien no está asignado a tu servidor y por eso no se puede usar. Entonces las conexiones de Bedrock no funcionan, mientras que los jugadores de Java siguen pudiendo entrar al servidor.

Así lo solucionas:

  1. Consulta en el panel qué puerto de Bedrock (UDP) está asignado a tu servidor.
  2. En Archivos, abre plugins/Geyser-Spigot/config.yml y compara el valor port en la sección bedrock. Debe coincidir exactamente con el puerto asignado.
  3. Comprueba si otro servicio UDP usa el mismo puerto, por ejemplo la query (query.port en server.properties) o un plugin de chat de voz. Cada uno de estos servicios necesita su propio puerto.
  4. Guarda, reinicia el servidor y prueba la conexión con Bedrock.

Más detalles: Crossplay de Bedrock: Geyser, Floodgate y puerto UDP

El script de un add-on se colgó y fue cancelado

Así se ve el mensaje:

[Watchdog] Unhandled critical exception of type '<Tipo>' in behavior pack '<Add-on>'

Qué hay detrás: El servidor Bedrock supervisa los scripts de los add-ons con un vigilante, el Watchdog. Si un script tarda demasiado, el servidor lo cancela para que no se detenga todo el mundo. El nombre del add-on aparece en el mensaje después de «behavior pack». En ese momento el servidor puede dar tirones brevemente y las funciones del add-on dejan de funcionar. El servidor en sí sigue funcionando.

Así lo solucionas:

  1. Lee el nombre del add-on en el mensaje.
  2. Comprueba con el creador si hay una edición más reciente para la versión de Bedrock de tu servidor (consulta Versión) e instálala después de hacer una copia de seguridad.
  3. Fíjate en si el mensaje aparece con una acción concreta, por ejemplo al entrar en una zona o cuando hay muchas criaturas en un mismo lugar.
  4. Si aparece con frecuencia, desactiva el add-on como prueba y observa si desaparecen los tirones.

Conviene saber: Un mensaje aislado no es motivo de preocupación. Lo decisivo es si se repite.

Una entrada de permisos sin XUID o nivel

Así se ve el mensaje:

xuid or permission missing from permissions file

Qué hay detrás: En un servidor Bedrock, el archivo permissions.json define quién tiene qué nivel de permisos, por ejemplo operador. Cada entrada necesita dos datos: la XUID, es decir, el identificador fijo de la cuenta de Xbox o Microsoft, y el nivel. Si falta uno de ellos, el servidor no puede asignar la entrada a ningún jugador y no la aplica. El servidor funciona con normalidad, solo que ese permiso no surte efecto.

Cómo solucionarlo:

  1. Abre la configuración de tu servidor y, dentro de ella, la sección «Permisos (Ops)».
  2. Elimina la línea sin XUID o añade la XUID del jugador.
  3. Reinicia el servidor después.
  4. Es más sencillo usar el comando op <Jugador> en la Consola mientras el jugador está conectado. Entonces el servidor registra la XUID por sí mismo.

Bueno saber: En Bedrock cuenta la XUID, no el nombre del jugador. Por eso, una entrada sin XUID no tiene ningún efecto, aunque el nombre sea correcto.

Floodgate interrumpe la configuración de sus componentes internos

Así se ve el mensaje:

Unable to create injector, see the following errors:
IllegalStateException: Couldn't create lambda for: "MethodHandle(PlayerLinkHolder,ShutdownEvent)void"

Qué hay detrás: El injector es la configuración de los componentes internos del plugin. Aquí Floodgate no consigue crear un manejador de eventos para la vinculación de cuentas. Por eso Floodgate no se inicia por completo. Así, el inicio de sesión de Bedrock, que Floodgate necesita, no está disponible.

Así lo solucionas:

  1. Lee el informe de error completo en la Consola o en Archivos, en logs/latest.log.
  2. Anota el software del servidor y las versiones de Java, Geyser y Floodgate que aparecen en el registro de inicio.
  3. Consulta los entornos compatibles del proyecto Floodgate. Instala versiones adecuadas de Floodgate y Geyser; si usas un software híbrido, comprueba expresamente que sea compatible.
  4. Reinicia el servidor por completo y prueba a entrar con Bedrock. Si el error persiste, notifícalo al proyecto Floodgate con el informe completo.

Bedrock no puede leer la lista de permisos

Así se ve el mensaje:

Malformed permissions file. Top level needs to be an array [], with inner levels nested in {}

Qué hay detrás: El servidor Bedrock no puede leer su lista de permisos. El archivo usa JSON, un formato de texto estructurado. En el exterior debe haber una lista entre corchetes y dentro, cada entrada de permisos entre llaves. Cualquier otra estructura impide que se carguen esas entradas.

Así lo solucionas:

  1. Detén el servidor. En Archivos, haz una copia del permissions.json existente antes de editarlo.
  2. Restaura una versión que funcione o corrige la estructura: por fuera [ y ], por dentro los objetos individuales con { y }. Separa varios objetos con comas.
  3. Conserva las entradas existentes y usa comillas dobles para los nombres de campo y los valores de texto. Elimina las comas sobrantes y cierra todos los corchetes y llaves.
  4. Guarda el archivo, reinicia el servidor y revisa la Consola. Después, comprueba si los permisos previstos vuelven a aplicarse.

Bueno saber: Una lista vacía elimina los permisos especiales registrados. No la uses como sustituto para reparar las entradas existentes.

Geyser: la señalización externa no obtiene un endpoint UDP de ICE

Así se ve el mensaje:

[Geyser-Spigot] Could not start the external signaling service
java.lang.IllegalStateException: Cannot acquire ICE UDP mux endpoint
Failed to register pending ICE UDP mux listener

Qué hay detrás: ICE organiza el establecimiento de una conexión de datos. El multiplexor UDP distribuye paquetes de red a través de un endpoint compartido. Aquí no se puede configurar su listener. Por ello, en Geyser deja de funcionar la señalización externa para las nuevas conexiones; el servidor de juego sigue en marcha.

Cómo solucionarlo:

  1. Lee los errores de red anteriores en la Consola. Presta atención a otros mensajes sobre la inicialización o sobre el enlace del puerto UDP.
  2. Revisa en Archivos los ajustes de Geyser para el transporte, la señalización y el puerto UDP según la documentación actual de Geyser.
  3. Comprueba en Plugins si hay una actualización adecuada de Geyser. Cambia el tipo de señalización solo si se corresponde con la configuración de conexión que tienes prevista.
  4. Tras la corrección, reinicia por completo y prueba a entrar de nuevo. Si el error persiste, abre un ticket e indica la hora y los mensajes completos que lo acompañan.

¿No encuentras tu mensaje?

Lee el mensaje completo en la Consola o en logs/latest.log, incluidas las líneas inmediatamente anteriores. Si va seguido de un stacktrace, es decir, una lista de líneas que empiezan por «at», este muestra dónde se originó el error. Nombres como Geyser-Spigot.jar o floodgate que aparezcan en él indican el plugin afectado. En los servidores Bedrock, los corchetes o las rutas dentro de behavior_packs/ indican el add-on. Crea una copia de seguridad antes de cambiar nada. Si no consigues avanzar, abre un ticket e indica la hora del mensaje.