Cuando algo falla

Todo creador de complementos rompe un paquete alguna vez. La buena noticia es que Minecraft te dice qué ha fallado, si sabes dónde mirar. Esta página te enseña a encontrar los errores y a arreglar los más comunes.

Paso 1: activa el registro de contenido

El registro de contenido (content log) es la lista de problemas que Minecraft encuentra al cargar tus paquetes. Actívalo una vez y déjalo activado mientras construyes.

1. Abre Minecraft y ve a Ajustes.
2. Abre la sección Creador.
3. Activa Habilitar GUI de registro de contenido.
4. Activa Habilitar archivo de registro de contenido si también quieres guardar los errores en un archivo.

Ahora, cuando cargues un mundo con un paquete roto, los errores aparecerán en pantalla. Puedes abrir la lista completa en cualquier momento desde el menú de pausa, o con Ctrl + H en un teclado.

Cómo leer un error

Una línea del registro de contenido suele tener este aspecto:

[Item][error]-demo:ruby | items/ruby.json | minecraft:item | components | minecraft:max_stack_size | ...

Léela de izquierda a derecha:

• [Item]: qué sistema se ha quejado (Item, Blocks, Entity, Json, Texture...).
• [error] o [warning]: los errores suelen romper algo, las advertencias puede que no.
• La ruta: el archivo y luego el punto exacto dentro de él. Te dice dónde mirar.

El paquete no aparece

Si tu paquete no está en la lista de los ajustes del mundo, Minecraft no ha podido leer su manifiesto.

• JSON roto en manifest.json. Busca comas que faltan, comas de más y comillas incorrectas. Consulta JSON en 5 minutos.
• Manifiesto en el sitio equivocado. Debe estar directamente en la carpeta del paquete, como development_behavior_packs/MyPack/manifest.json. Con una carpeta de más, el paquete se vuelve invisible.
• Tipo de módulo equivocado. Un paquete de comportamiento usa "type": "data" y un paquete de recursos usa "type": "resources". Un BP en la carpeta de paquetes de recursos (o al revés) no aparecerá.
• La importación ha fallado. Si un .mcpack muestra "Error al importar", seguramente el manifiesto está dentro de una subcarpeta del ZIP. Comprime el contenido de la carpeta del paquete, no la carpeta. Consulta Exportar y jugar.

UUID duplicados

Cada cabecera de paquete y cada módulo necesitan su propio UUID. Los problemas aparecen cuando:

• copiaste un manifiesto de un tutorial o de otro paquete y dejaste sus UUID
• copiaste el manifiesto de tu propio BP para hacer el RP y olvidaste cambiarlos
• todavía tienes instalada una copia antigua del mismo paquete

Los síntomas son un paquete que se niega a importarse, que se carga el paquete equivocado o que tus cambios nunca aparecen. La solución: genera cuatro UUID nuevos y comprueba que la entrada dependencies del BP apunte al nuevo UUID de la cabecera del RP. Después borra las copias antiguas del paquete de behavior_packs y resource_packs.

Los cambios no aparecen

Editaste un archivo, pero nada cambió en el juego.

1. ¿Guardaste el archivo? Activa el guardado automático en tu editor.
2. ¿Estás editando la copia correcta? Si importaste el paquete como .mcpack, el juego usa la copia importada en behavior_packs, no tu carpeta del proyecto. Trabaja mejor en las carpetas de desarrollo.
3. ¿Subiste la versión? Cuando importas un .mcpack actualizado, sube la version en la cabecera del manifiesto, o Minecraft puede quedarse con el antiguo.
4. ¿Recargaste? Sal del mundo y vuelve a abrirlo. En los casos más rebeldes, cierra Minecraft del todo.

El paquete está activado, pero nada funciona

• Solo hay un paquete activo. Abre los ajustes del mundo y asegúrate de que tanto el paquete de comportamiento como el de recursos estén en Activos. Añadir una dependencia del BP al RP lo hace automático.
• Hace falta un experimento. Si la función que usaste es experimental, su interruptor debe estar activado en los ajustes de Experimentos del mundo.
• format_version equivocado. Si un archivo dice "format_version": "1.10" pero usa componentes más nuevos, el juego lo lee con reglas antiguas e ignora o rechaza lo que no conoce. Usa una versión actual, como "1.26.30" para los objetos, y sigue los ejemplos de esta wiki.

El objeto no está en el menú creativo

Tu objeto existe, pero no lo encuentras en el inventario creativo.

Sin categoría de menú

Sin menu_category, la categoría por defecto es none, que oculta el objeto del menú creativo. Añádela a la descripción del objeto:

"description": {
  "identifier": "demo:ruby",
  "menu_category": {
    "category": "items"
  }
}

Las categorías en las que puedes mostrar un objeto son construction, equipment, items y nature.

Otras causas

• El archivo no se ha cargado. Busca en el registro de contenido errores con el nombre de tu objeto.
• Prueba el comando. Escribe /give @s demo:ruby. Si dice que el objeto no existe, el paquete de comportamiento no está cargando el archivo. Si recibes el objeto, solo está mal el ajuste del menú.

Mira también la referencia de componentes de objeto para comprobar que cada nombre de componente esté bien escrito.

Texturas que faltan o están rotas

Cuadros negros y morados

Una textura a cuadros morados y negros significa que Minecraft no ha encontrado la imagen que se le pidió usar.

• Ruta equivocada. Las rutas de textura se escriben sin .png y empiezan en la raíz del paquete, como textures/items/ruby. Revisa cada letra.
• Mayúsculas y minúsculas. Algunas plataformas, como Android, tratan Ruby.png y ruby.png como archivos distintos. Usa minúsculas en todas partes.
• Formato equivocado. Guarda en PNG de verdad. Un JPG al que le cambias el nombre a .png no se cargará.
• El RP no está activo. Si el paquete de recursos está desactivado, faltan todas las texturas personalizadas.

Objetos sin icono

Si tu objeto aparece invisible o sin icono:

1. Comprueba que minecraft:icon en el BP use un nombre corto, como "ruby".
2. Comprueba que ese mismo nombre corto esté registrado en RP/textures/item_texture.json.
3. Comprueba que la ruta de ese archivo apunte a tu PNG.

{
  "resource_pack_name": "my_first_addon",
  "texture_name": "atlas.items",
  "texture_data": {
    "ruby": {
      "textures": "textures/items/ruby"
    }
  }
}

Nombres de objeto raros

Si el objeto se llama algo como item.demo:ruby.name en lugar de "Rubí", al archivo de idioma le falta esa línea. Añádela a RP/texts/en_US.lang:

item.demo:ruby.name=Ruby

Una lista rápida

Cuando algo falla y no sabes por qué, repasa esta lista en orden:

1. ¿Registro de contenido activado? Lee el primer error.
2. ¿Todo el JSON es válido?
3. ¿Manifiestos en el sitio correcto, con UUID únicos?
4. ¿Los dos paquetes activos en el mundo?
5. ¿Identificadores escritos igual en todas partes, todo en minúsculas?
6. ¿Rutas de textura correctas, sin .png?
7. ¿Mundo recargado, o Minecraft reiniciado?

Evitar los errores desde el principio

La mayoría de estos problemas vienen de escribir cosas a mano: una coma aquí, un UUID que no coincide allá, una ruta de textura con una letra mal. GodCraft escribe todos estos archivos por ti, así que los manifiestos, los UUID, las rutas de textura y las líneas de idioma siempre coinciden. Si te atascas a menudo, prueba a construir lo mismo en el Taller de GodCraft y compara.