Bedrock y Geyser: entender y solucionar los mensajes del registro del servidor

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.

Geyser no puede cargar sus archivos de idioma

Así se ve el mensaje:

java.lang.AssertionError: Unable to load Geyser locale map for <Idioma>
    at Geyser-Spigot.jar//org.geysermc.geyser.text.GeyserLocale.loadGeyserLocale(GeyserLocale.java:141)

Qué hay detrás: Geyser necesita, para cada jugador de Bedrock, el archivo de idioma de Minecraft correspondiente a su configuración de idioma, por ejemplo alemán o inglés británico. Geyser descarga estos archivos al iniciarse y los guarda en una carpeta propia. Si la descarga falló al iniciar o la carpeta está dañada, Geyser no encuentra el archivo. Entonces la entrada del jugador de Bedrock falla, mientras que los jugadores de Java no se ven afectados.

Así lo solucionas:

1. Reinicia el servidor desde la Consola. Geyser volverá a descargar los archivos de idioma.
2. Sigue el inicio en la consola. Si aparece "Unable to download and extract … locale", la descarga ya ha fallado. Más abajo hay una sección propia sobre esto.
3. Si el mensaje persiste, detén el servidor y borra en Archivos la carpeta plugins/Geyser-Spigot/locales o la carpeta .cache de Geyser.
4. Vuelve a iniciar el servidor y haz que entre un jugador de Bedrock.

Bueno saber: Estas carpetas solo contienen datos que Geyser vuelve a descargar por sí mismo. Tus ajustes en config.yml se conservan.

Geyser notifica un error en la sesión de un jugador de Bedrock

Así se ve el mensaje:

[Geyser-Spigot] Exception caught in session of unknown (pre-login)
[Geyser-Spigot] Error thrown in <Jugador>'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 sale mal en esta traducción, normalmente solo se desconecta a ese jugador. El servidor y el resto de jugadores siguen funcionando. "pre-login" significa que la conexión se interrumpió antes del inicio de sesión. Una ReadTimeoutException debajo indica una conexión interrumpida.

Así lo solucionas:

1. Anota la hora, el jugador afectado y lo que estaba haciendo, 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, sustituye 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 siguientes.

Bueno saber: Los clientes de Bedrock reciben actualizaciones con frecuencia, y un Geyser desactualizado a menudo no funciona bien con clientes nuevos. 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.

Los paquetes de add-ons no se cargan correctamente

Así se ve el mensaje:

The following issues were found when loading packs:
    behavior_packs/<Paquete>
        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 debajo de esta línea: primero el paquete y debajo el motivo. Según el error, no carga el paquete o lo carga de forma distinta a la prevista, por ejemplo como paquete de recursos en lugar de paquete de comportamiento ("Defaulting to resource pack").

Así lo solucionas:

1. Lee las líneas con sangría debajo del mensaje. Indican el paquete y el motivo.
2. Si aparece "too high", el add-on necesita una versión de Bedrock más reciente que la de tu servidor. Usa una edición más antigua del add-on o espera hasta que la versión adecuada esté disponible en Versión o Actualizaciones.
3. En el caso de otros motivos, normalmente ayuda la edición actual 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.

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