Los datapacks (paquetes de datos) amplían Minecraft con funciones, recetas, logros o una nueva generación de mundo, y los resourcepacks aportan texturas y sonidos. Ambos dependen de un formato de datos que cambia con casi cada versión de Minecraft. Si un pack no encaja con la versión de tu servidor o un archivo dentro de él está dañado, el servidor escribe un mensaje en el log. Normalmente solo omite la entrada afectada, pero en un caso cancela el inicio.

Cada apartado de abajo trata uno de estos mensajes. Encontrarás el mensaje completo, junto con las líneas siguientes, en la Consola o en Archivos dentro de logs/latest.log. La parte anterior a los dos puntos en nombres como <pack>:<entrada> se llama espacio de nombres y casi siempre revela de qué pack o mod procede el error. Antes de tocar la carpeta del mundo o los archivos de un pack, crea una copia en Copias de seguridad.

«Failed to load datapacks»: Minecraft cancela el inicio del servidor

Así se ve el mensaje:

Failed to load datapacks, can't proceed with server load. You can either fix your datapacks or reset to vanilla with --safeMode
java.util.concurrent.ExecutionException: java.lang.IllegalStateException: Overworld settings missing

Qué hay detrás: Minecraft cancela el inicio porque no se han podido cargar los paquetes de datos o los datos de generación del mundo necesarios. El servidor permanece apagado. Normalmente un datapack no es compatible con la versión de Minecraft o contiene un archivo dañado. Overworld settings missing significa que faltan los ajustes del mundo principal o que no se han podido leer.

Así lo solucionas:

  1. Crea una copia de seguridad en Copias de seguridad.
  2. Lee en la Consola los errores anteriores y posteriores a este mensaje. Revisa los datapacks y mods añadidos, actualizados o eliminados recientemente.
  3. Abre en Archivos la carpeta datapacks de tu mundo. Descarga una copia del último pack añadido y elimínalo como prueba.
  4. Reinicia. Si el servidor vuelve a funcionar, usa una versión del pack que sea compatible con la versión de Minecraft.
  5. Si el mundo necesita el pack para biomas o dimensiones, restaura una versión compatible o el estado anterior completo desde una copia de seguridad.

Bueno saber: Tras un cambio de software, los archivos del mundo pueden estar organizados de otra manera. Consulta la guía de migración del software correspondiente; para ello te ayuda Cambiar de forma segura la versión de Minecraft y el cargador de mods.

„Failed to load function“: no se puede cargar la función del datapack

Así se ve el mensaje:

Failed to load function <Pack>:<Path>
java.lang.IllegalArgumentException: Whilst parsing command on line <Line>: Incorrect argument for command at position <Position>: …
java.lang.IllegalArgumentException: Whilst parsing command on line <Line>: Can't find element '<Pack>:<Entry>' in registry 'minecraft:item_modifier' …

Qué hay detrás: Los datapacks controlan procesos mediante funciones: archivos de texto con la extensión .mcfunction que contienen comandos. Un comando es desconocido, espera otros argumentos o hace referencia a una entrada de datos que falta, por ejemplo un modificador de objetos (item_modifier). Normalmente el pack no es compatible con la versión de Minecraft. La función falla; el servidor sigue funcionando, pero las funciones del pack que dependen de ella no trabajan.

Cómo solucionarlo:

  1. Lee la línea de error bajo „Failed to load function“: line indica la línea y position el punto dentro de ella. „Can't find element“ indica la entrada que falta.
  2. Sustituye el pack en la carpeta datapacks de tu mundo por la versión para tu versión de Minecraft. Si faltan entradas, comprueba también los paquetes adicionales que necesita el pack.
  3. En el caso de packs propios, corrige la línea indicada en data/<Pack>/function/<Path>.mcfunction; en packs más antiguos la carpeta se llama functions.
  4. Reinicia o escribe reload en la Consola. En Paper y Spigot usa minecraft:reload para que solo se recarguen los datapacks.

Bueno saber: Las funciones opcionales de mods necesitan el mod correspondiente. Ignora estos errores solo si el autor del pack describe expresamente esas funciones adicionales como opcionales.

„Couldn't load … pack metadata“: los metadatos del pack no son compatibles con la versión de Minecraft

Así se ve el mensaje:

Couldn't load file/<Pack>.zip pack metadata: Pack declares support for version newer than <Number>, but is missing mandatory fields min_format and max_format
Couldn't load file/<Pack>.zip pack metadata: Multi-version packs cannot support minimum version of less than <Number>, since this will leave versions in range unable to load pack.

Qué hay detrás: El archivo pack.mcmeta describe el formato y el rango de versiones compatible de un datapack o resourcepack. Si faltan campos obligatorios o el rango indicado no es válido, el servidor no carga el pack. El servidor sigue funcionando sin ese pack. Un rango de versiones que se remonta demasiado atrás también puede provocar el mensaje.

Cómo solucionarlo:

  1. El nombre del archivo tras file/ indica el pack. Comprueba tu versión de Minecraft en Versión.
  2. Descarga la versión adecuada del pack y sustituye el archivo afectado en Archivos. Los datapacks están en la carpeta datapacks de tu mundo; los resourcepacks los sustituyes en su ubicación actual. Después reinicia.
  3. En el caso de packs propios, ajusta los metadatos según los requisitos de tu versión de destino: los formatos más antiguos usan pack_format, los más recientes min_format y max_format. Para packs compatibles con varias versiones, también pueden ser necesarios los campos antiguos.
  4. Comprueba si el rango de versiones indicado es válido y si el mensaje desaparece tras el reinicio.

Bueno saber: Cambiar los datos de formato no adapta automáticamente los comandos ni otros contenidos del pack.

„Couldn't load tag“: el datapack hace referencia a entradas que faltan

Así se ve el mensaje:

Couldn't load tag minecraft:load as it is missing following references: <Pack>:<Function> (from file/<Pack>.zip)
Couldn't load tag <Namespace>:<Tag> as it is missing following references: <Mod>:<Entry> (from <Mod>.jar)
Couldn't load tag <Namespace>:<Tag> as it is missing following references: #<Mod>:<Tag> (from mod/<Mod>)

Qué hay detrás: Un tag es una lista con nombre. minecraft:load y minecraft:tick enumeran funciones; otros tags agrupan, por ejemplo, bloques u objetos. No se pudo cargar una entrada necesaria porque una función es defectuosa o falta un pack o un mod. También puede faltar otro tag: lo reconoces por el #. El tag afectado deja de estar disponible; en los tags de funciones, los procesos correspondientes fallan.

Cómo solucionarlo:

  1. Soluciona primero los mensajes „Failed to load function“ del mismo pack.
  2. Comprueba el origen entre paréntesis. Si la entrada que falta pertenece a otro pack o mod, instala su versión adecuada.
  3. Si faltan entradas con minecraft: delante, comprueba también si el pack es compatible con tu versión de Minecraft.
  4. Tras cambios en mods, reinicia. Puedes recargar los datapacks en la Consola con reload; en Paper y Spigot usa minecraft:reload.

Bueno saber: .jar o mod/ como origen apunta a un mod: Errores de mods en servidores Forge, NeoForge y Fabric.

„Couldn’t parse data file …“: el archivo del datapack tiene un formato incorrecto

Así se ve el mensaje:

Couldn't parse data file '<Pack>:<Entry>' from '<Pack>:recipe/<File>.json': DataResult.Error['Unknown registry key …']
Couldn't parse data file '<Pack>:<Entry>' from '<Pack>:recipe/<File>.json': DataResult.Error['List is too short: 0, expected range [1-9]']
Couldn't parse data file '<Pack>:<Entry>' from '<Pack>:recipe/<File>.json': DataResult.Error['Not a string: {"item":"minecraft:tnt"}; List must have contents']

Qué hay detrás: Los datapacks describen, entre otras cosas, recetas y logros en JSON, un formato de texto para datos estructurados. Los mods también incluyen este tipo de archivos. El archivo es un JSON válido, pero contiene campos incorrectos, listas vacías o referencias a entradas desconocidas, por ejemplo un serializador de recetas que procesa el formato de la receta. Minecraft omite la entrada afectada; falta la receta, pero el servidor sigue funcionando.

Así lo solucionas:

  1. Lee después de from qué archivo está afectado; DataResult.Error[…] indica el error.
  2. Si procede de un datapack, sustitúyelo en Archivos, en la carpeta datapacks de tu mundo, por la versión para tu versión de Minecraft.
  3. Si procede de un mod, revisa su versión y las dependencias necesarias; si se trata de un Modpack, actualiza el paquete completo.
  4. En el caso de packs propios, adapta el archivo al formato de tu versión de Minecraft. La wiki de Minecraft describe los formatos de archivo.
  5. Reinicia y comprueba el mensaje.

Bueno saber: Not a string significa aquí: en este punto se espera texto en lugar de un objeto.

„Couldn't parse data file“: los datos del pack o del mod no se pueden leer

Así se ve el mensaje:

Couldn't read tag list <Namespace>:<Tag> from <File> in data pack mod/<Mod>
Couldn't parse data file '<Namespace>:<Entry>' from '<File>.json': … Failed to parse either …
java.lang.IllegalStateException: Failed to parse <Namespace>:<Entry> from pack file/<Pack>.zip

Qué hay detrás: Minecraft no puede leer una entrada de datos. „Failed to parse either“ significa que su contenido no encaja con ninguna de las formas de escritura esperadas; First y Second indican los errores respectivos. Normalmente un mod o datapack no es compatible con la versión de Minecraft o el pack está dañado. También pueden verse afectadas recetas, tablas de botín y logros. La entrada falla; en las listas de tags puede quedar vacío un grupo entero. Esto puede alterar las recetas o la generación del mundo.

Cómo solucionarlo:

  1. Busca el origen en el error completo: mod/<Mod> o un .jar apunta a un mod, file/<Pack>.zip a un datapack. El espacio de nombres es otra pista.
  2. Comprueba en Mods o en la carpeta datapacks de tu mundo si las versiones son compatibles con tu versión de Minecraft. Unknown registry key indica una entrada de datos que falta; comprueba los paquetes adicionales necesarios.
  3. Haz una copia del estado actual, detén el servidor y actualiza el último mod o pack que añadiste.
  4. Si el error empezó tras un nuevo datapack, quítalo para probar y reinicia.

Bueno saber: Para errores de mods te ayuda Errores de mods en servidores Forge, NeoForge y Fabric.

„Couldn’t load advancements“: faltan logros o no son válidos

Así se ve el mensaje:

Couldn't load advancements: [<pack>:<logro>, <pack>:<logro>]

Qué hay detrás: Los advancements son los logros que los jugadores desbloquean en el juego. Minecraft no pudo resolver las entradas indicadas al cargar los datapacks, por ejemplo porque hacen referencia a algo que no existe en esta versión. Muchos datapacks y mods también usan los logros de forma invisible como activadores, por ejemplo para detectar que un jugador ha encontrado una estructura. Estas funciones dejan de funcionar, mientras que el servidor sigue en marcha.

Así lo solucionas:

  1. El espacio de nombres antes de los dos puntos te ayuda a encontrar el datapack o el mod responsable. Para ello, revisa el contenido instalado y las líneas anteriores al mensaje.
  2. Actualiza este pack o este mod a la versión para tu versión de Minecraft. Si no lo necesitas, elimínalo después de hacer una copia en Copias de seguridad.
  3. Tras cambios en mods, reinicia el servidor. Para cambios solo en datapacks también sirve reload en la Consola; en Paper y Spigot, minecraft:reload.
  4. Si el mensaje sigue apareciendo después, lee las líneas anteriores en logs/latest.log. Ahí el servidor suele indicar qué parte de una entrada no encaja.

Bueno saber: Aunque el espacio de nombres sea minecraft, el origen puede ser un datapack. Los packs pueden crear entradas propias bajo ese nombre.

El predicado del datapack tiene un formato incorrecto

Así se ve el mensaje:

Couldn't parse element predicates:<pack>:<name> - Not a json array: {"condition":"minecraft:any_of","terms":[…]}

Qué hay detrás: Un predicado es una condición guardada que comprueba un datapack, por ejemplo si un jugador tiene una determinada puntuación. Los comandos y las tablas de botín recurren a ella. Tu versión de Minecraft espera aquí una lista entre corchetes [ … ], pero el pack entrega un único objeto entre llaves { … }. Por eso Minecraft no carga el predicado. Todo lo del pack que dependa de él se comporta mal o no funciona. El servidor en sí sigue funcionando.

Cómo solucionarlo:

  1. El nombre tras predicates: indica el pack y el predicado.
  2. Descarga la versión del datapack para tu versión de Minecraft y sustituye la antigua en la carpeta datapacks de tu mundo.
  3. En packs propios, abre data/<pack>/predicate/<name>.json (en packs antiguos la carpeta se llama predicates) y adapta el archivo al formato actual, tal como lo describe la wiki de Minecraft.
  4. Reinicia o recarga los datapacks.

El texto de aviso del resource pack del servidor tiene un formato incorrecto

Así se ve el mensaje:

Failed to parse resource pack prompt '<Hint>'
com.google.gson.JsonSyntaxException: com.google.gson.stream.MalformedJsonException: Use JsonReader.setStrictness(Strictness.LENIENT) to accept malformed JSON at line 1 column 1 path $

Qué hay detrás: Con resource-pack-prompt en server.properties defines el texto que ven los jugadores cuando el servidor les ofrece un resource pack. Minecraft espera ahí un componente de texto en formato JSON, no una frase sencilla. Si el servidor no puede leer el valor, omite el aviso. El servidor sigue funcionando con normalidad, solo que tu texto de aviso no aparece.

Cómo solucionarlo:

  1. En Archivos, abre el archivo server.properties en la carpeta principal del servidor.
  2. Escribe el valor como texto JSON, por ejemplo resource-pack-prompt={"text":"<Hint>"}.
  3. Si no necesitas un aviso propio, deja vacío el valor tras el signo igual.
  4. Guarda el archivo y reinicia el servidor.

Bueno saber: Los demás valores del archivo se explican en Configurar server.properties de Minecraft.

El archivo pack.mcmeta de un pack es defectuoso

Así se ve el mensaje:

Couldn't load file/<Pack>.zip pack metadata: com.google.gson.stream.MalformedJsonException: <Details>

Qué hay detrás: pack.mcmeta es el archivo de identificación de cada pack y se encuentra en su carpeta principal. Aquí no es un JSON válido: falta, por ejemplo, una coma, unas comillas o un paréntesis o llave. Por eso Minecraft no puede identificar el pack y no lo carga. El servidor sigue funcionando sin el pack.

Cómo solucionarlo:

  1. Lo más sencillo es volver a descargar el pack desde su página oficial y sustituir el archivo en la carpeta datapacks de tu mundo.
  2. En packs propios, abre pack.mcmeta. Si el pack está como archivo ZIP, descárgalo, corrige el archivo en tu ordenador y vuelve a subir el archivo comprimido.
  3. Comprueba el contenido con un validador de JSON, es decir, una página web o un editor que marque los errores de sintaxis, y corrige el punto marcado. El mensaje suele indicar la línea y la columna.
  4. Reinicia el servidor.

Bueno saber: Los errores típicos son una coma después de la última entrada, comillas tipográficas en lugar de comillas rectas y una llave de cierre que falta.

Una receta menciona un objeto que no existe

Así se ve el mensaje:

Expected item to be an item, was unknown string '<mod>:<item>'

Qué hay detrás: Una receta menciona un objeto que no existe en el servidor. Casi siempre falta el mod que aporta ese objeto, o está en una versión en la que el objeto tiene otro nombre. Solo se omite la receta afectada. El servidor se inicia con normalidad, pero esa receta concreta no se puede fabricar en el juego.

Cómo solucionarlo:

  1. Lee el nombre entre comillas. Antes de los dos puntos aparece el mod responsable: en horsepower:flour es el mod «horsepower».
  2. Comprueba en Mods si ese mod está instalado.
  3. Si está instalado, compara su versión con la que prevé tu modpack y ajústala.
  4. Reinicia el servidor y comprueba si el mensaje deja de aparecer.

Bueno saber: Si el mod falta a propósito, por ejemplo porque lo quitaste del modpack, puedes ignorar el mensaje. Entonces solo falta esa receta. Cómo encajan los mods y el modpack se muestra en Configurar correctamente mods y modpacks de Minecraft.

Una receta usa un tipo de procesamiento desconocido

Así se ve el mensaje:

com.google.gson.JsonSyntaxException: Unknown recipe '<mod>:<recipe-type>'

Qué hay detrás: Muchos mods incluyen sus propios tipos de receta, por ejemplo para un molino o una prensa. Aquí una receta usa un tipo de procesamiento que el servidor no conoce. El mod que lo define falta o es demasiado antiguo. La receta se omite y el servidor sigue funcionando.

Cómo solucionarlo:

  1. El nombre antes de los dos puntos indica el mod responsable.
  2. Instálalo en Mods o actualízalo a una versión que encaje con tu modpack.
  3. Si la receta procede de un datapack que añadiste tú mismo, elimina la receta de ahí o quita todo el pack de la carpeta datapacks de tu mundo.
  4. Reinicia el servidor.

Bueno saber: Si falta un mod por completo, el mensaje suele aparecer muchas veces seguidas con el mismo nombre antes de los dos puntos. Entonces basta con instalar ese único mod. Si falta a propósito, solo faltan las recetas que usan su tipo de procesamiento.

Archivo JSON vacío en los datos de mods o datapacks

Así se ve el mensaje:

com.google.gson.JsonParseException: java.io.EOFException: End of input at line 1 column 1 path $

Qué hay detrás: Al cargar los datos del juego, es decir, recetas, tablas de botín, tags y similares, Minecraft ha encontrado un archivo JSON vacío. «End of input at line 1 column 1» significa: el archivo termina antes de que aparezca el primer carácter. Con frecuencia proviene de un mod, de un datapack o de una subida incompleta o dañada. La entrada afectada se omite y el servidor sigue funcionando.

Así lo solucionas:

  1. Lee en la Consola o en logs/latest.log las líneas inmediatamente anteriores y posteriores. Normalmente ahí se indica qué archivo o qué mod está afectado.
  2. Si el archivo está en un datapack propio, sustitúyelo por una versión completa o elimínalo.
  3. Si pertenece a un mod o a un datapack descargado, vuelve a descargarlo y a subirlo. Asegúrate de que la subida se complete por completo.
  4. Reinicia el servidor.

Bueno saber: Para muchos archivos o archivos grandes, un programa SFTP suele ser más cómodo que la subida desde el navegador: Editar archivos del servidor en el panel y conectarse por SFTP.

El archivo del paquete de recursos tiene una estructura no válida

Así se ve el mensaje:

<Pack> does not contain a valid pack_manifest.json or manifest.json
The resource pack <Pack> is invalid and failed to load

Qué hay detrás: No se pudo cargar el paquete de recursos. Suele afectar a los packs de Bedrock: necesitan un archivo manifest.json o pack_manifest.json que describa el pack. El motivo más habitual es un nivel de carpeta adicional, en el que dentro del archivo comprimido hay primero una carpeta y el archivo está dentro de ella. También un archivo dañado o un formato de pack inadecuado provocan este mensaje. El pack no se carga, pero el servidor sigue funcionando.

Así lo solucionas:

  1. Lee el mensaje detallado en las líneas alrededor de este mensaje; indica el motivo exacto.
  2. Abre el archivo comprimido en tu ordenador. manifest.json o pack_manifest.json debe estar directamente en el nivel superior, no en una subcarpeta.
  3. Si el archivo está en una subcarpeta, vuelve a empaquetar el contenido de esa carpeta como archivo ZIP y súbelo de nuevo.
  4. Si el archivo comprimido está dañado, vuelve a descargar el pack. Un paquete de recursos de Java con pack.mcmeta en lugar de manifiesto no sirve aquí; hay que recrearlo en formato Bedrock.
  5. Reinicia el servidor.

Bueno saber: Otros mensajes de Bedrock se explican en Servidor Bedrock y Geyser: mensajes en el log.

El bloque Jigsaw indica un bloque de sustitución desconocido

Así se ve el mensaje:

Failed to parse jigsaw replacement state '<Block>' at BlockPos{x=<x>, y=<y>, z=<z>}

Qué hay detrás: Los bloques Jigsaw son bloques técnicos con los que se montan estructuras a partir de piezas individuales. Cada bloque Jigsaw define por qué bloque se sustituye tras el montaje. Aquí ese bloque de sustitución es desconocido, normalmente por una errata como minecrat: en lugar de minecraft:. Al generar, el bloque queda vacío en ese punto. El servidor sigue funcionando, la estructura solo tiene un hueco.

Así lo solucionas:

  1. Anota la posición de BlockPos{…}: x, y y z.
  2. Ve allí con permisos de OP en modo creativo, por ejemplo con /tp <x> <y> <z>.
  3. Abre el bloque Jigsaw con clic derecho y corrige el nombre en el campo del bloque de sustitución (en el cliente en inglés «Turns into»).
  4. Si la estructura proviene de un datapack o de un mod, el error está en su archivo de estructura. Entonces ayuda una versión corregida del pack o del mod; informa del error al autor.

Bueno saber: El mensaje es inofensivo para el funcionamiento. Solo afecta al aspecto de la estructura en ese punto concreto. Cómo asignar permisos de OP se explica en Permisos de OP y comandos en el servidor de Minecraft.

¿Tu mensaje no aparece aquí?

Lee el mensaje completo en la Consola o en logs/latest.log, también las líneas justo anteriores; a menudo ahí se indica qué pack se estaba cargando. El espacio de nombres antes de los dos puntos y datos como file/<Pack>.zip o mod/<mod> muestran el origen. Si sigue un stacktrace, es decir, líneas con sangría que empiezan por at …, los nombres de carpetas y paquetes que contiene revelan el mod o el plugin implicado. Antes de modificar archivos del mundo o de un pack, crea una copia en Copias de seguridad. Si no avanzas, abre un ticket e indica la hora del mensaje.