En esta guía vas a crear un complemento vacío que Minecraft reconozca. Todavía no añadirá nada, pero es la base de todos los objetos, bloques y criaturas que hagas después. Te llevará unos diez minutos.
La estructura de carpetas
Crea una carpeta de proyecto donde quieras, por ejemplo en el escritorio. Dentro, crea dos carpetas: una para el paquete de comportamiento y otra para el paquete de recursos.
my_first_addon/
BP/
manifest.json
pack_icon.png
items/
RP/
manifest.json
pack_icon.png
textures/
texts/Los nombres BP y RP son solo una costumbre que siguen la mayoría de los creadores. A Minecraft le da igual cómo se llamen las carpetas exteriores. Solo le importa lo que hay dentro, y el archivo más importante es manifest.json.
Para qué sirve un manifiesto
Todos los paquetes necesitan un manifest.json en su carpeta principal. Le dice a Minecraft:
- el nombre y la descripción del paquete
- un ID único (el UUID) para que el juego pueda distinguir unos paquetes de otros
- la versión del paquete
- qué tipo de paquete es (de comportamiento o de recursos)
- qué otros paquetes necesita
Si falta el manifiesto o está roto, Minecraft no mostrará el paquete.
UUID
Un UUID es un ID largo y aleatorio con este aspecto: 7da910dc-081d-41d2-84e6-fcd9e04cbffb. Cada paquete necesita sus propios UUID, y nunca debería haber dos paquetes en el mundo que compartan uno.
Para un complemento con BP + RP necesitas cuatro UUID:
- Cabecera del paquete de comportamiento
- Módulo del paquete de comportamiento
- Cabecera del paquete de recursos
- Módulo del paquete de recursos
Para conseguirlos, busca "UUID generator" en tu navegador y copia cuatro nuevos. En VS Code, las extensiones para Bedrock también pueden generarlos.
Nunca copies los UUID de un tutorial
Los UUID de esta página son ejemplos. Si los copias y otra persona también lo hizo, vuestros paquetes chocarán y uno de ellos no se cargará. Genera siempre los tuyos.
El manifiesto del paquete de comportamiento
Crea BP/manifest.json, pega esto y luego cambia los UUID por los tuyos:
{
"format_version": 2,
"header": {
"name": "My First Add-on",
"description": "My very first behavior pack",
"uuid": "7da910dc-081d-41d2-84e6-fcd9e04cbffb",
"version": [1, 0, 0],
"min_engine_version": [1, 26, 50]
},
"modules": [
{
"type": "data",
"uuid": "92b4a8c1-cbc4-4b82-85bd-e36e922d0621",
"version": [1, 0, 0]
}
],
"dependencies": [
{
"uuid": "f67430fa-ef89-4f40-802d-9574599c764d",
"version": [1, 0, 0]
}
]
}El manifiesto del paquete de recursos
Crea RP/manifest.json. Fíjate en que el tipo de módulo es distinto y en que el UUID de su cabecera coincide con el de las dependencies del paquete de comportamiento:
{
"format_version": 2,
"header": {
"name": "My First Add-on",
"description": "My very first resource pack",
"uuid": "f67430fa-ef89-4f40-802d-9574599c764d",
"version": [1, 0, 0],
"min_engine_version": [1, 26, 50]
},
"modules": [
{
"type": "resources",
"uuid": "654e78d1-0b0d-4f13-9a3b-6336f0ceab13",
"version": [1, 0, 0]
}
]
}Todos los campos explicados
format_version
La versión del formato del propio manifiesto. Usa 2, que es la que usan los paquetes del juego base de Mojang. Es un número sin más, no un texto entre comillas.
Nota
También existe un format_version 3 de manifiesto más reciente, en el que las versiones se escriben como texto, por ejemplo "1.0.0", en lugar de como listas. La versión 2 sigue siendo totalmente compatible y es la que usa esta wiki.
header
Información sobre el paquete en conjunto.
name: se muestra en la lista de paquetes del juego.description: el texto pequeño que aparece bajo el nombre.uuid: el ID único del paquete.version: tres números: mayor, menor y parche. Súbela cuando publiques una actualización, por ejemplo de[1, 0, 0]a[1, 0, 1]. Minecraft la usa para saber que un paquete es más nuevo.min_engine_version: la versión más antigua de Minecraft para la que está escrito tu paquete. También decide cómo lee el juego algunos de tus archivos, así que ponle la versión con la que estás probando, como[1, 26, 50].
modules
Lo que hay dentro del paquete. Un paquete necesita al menos un módulo, y cada módulo tiene su propio UUID.
| Tipo de módulo | Se usa en | Contiene |
|---|---|---|
data | Paquete de comportamiento | Objetos, bloques, entidades, recetas, tablas de botín, funciones |
resources | Paquete de recursos | Texturas, modelos, sonidos, textos |
script | Paquete de comportamiento | Archivos JavaScript que usan la Script API |
dependencies
Una lista de otros paquetes que este necesita. Cada entrada tiene el uuid y la version de la cabecera del otro paquete.
Aquí, el paquete de comportamiento depende del paquete de recursos. Ese enlace tiene un efecto muy práctico: cuando activas el paquete de comportamiento en un mundo, Minecraft activa también el paquete de recursos por ti. Sin él, los jugadores podrían activar solo el BP y ver objetos sin texturas.
Consejo
La dependencia tiene que apuntar al UUID de la cabecera del RP, no al UUID de su módulo. Es uno de los errores más comunes de los principiantes.
Iconos de paquete
Añade un pack_icon.png en la carpeta principal de cada paquete, junto al manifiesto. Es la imagen que aparece en la lista de paquetes.
- Hazlo cuadrado. Tanto 128x128 como 256x256 píxeles quedan bien.
- Guárdalo en PNG.
- Puedes usar la misma imagen para los dos paquetes.
Si no hay icono, el paquete sigue funcionando, pero muestra una imagen genérica en blanco.
Añade un archivo de idioma
Los nombres que se ven en el juego salen de los archivos de idioma del paquete de recursos. Crea ya estos dos archivos para tenerlos listos en las siguientes guías:
["en_US"]pack.name=My First Add-on
pack.description=My very first add-onMás adelante añadirás aquí líneas como item.demo:ruby.name=Ruby.
Comprueba que se carga
- Copia la carpeta
BPencom.mojang/development_behavior_packs. - Copia la carpeta
RPencom.mojang/development_resource_packs. - Abre Minecraft y crea un mundo nuevo.
- En los ajustes del mundo, abre Paquetes de comportamiento y mira en Disponibles. Tu paquete debería estar ahí con su icono.
- Actívalo. El paquete de recursos debería activarse solo, gracias a la dependencia.
Si el paquete no aparece, revisa Cuando algo falla. Lo más probable es que haya una errata en un manifiesto, así que lee después JSON en 5 minutos.
La forma fácil
Escribir los manifiestos y generar los UUID a mano es una tarea que solo haces una vez por proyecto, pero también es donde una pequeña errata lo rompe todo. GodCraft hace esta parte por ti: cada complemento que creas en el Taller recibe sus propios UUID nuevos, los dos manifiestos y el enlace de dependencia entre ambos paquetes. Tú solo rellenas en los ajustes del paquete los detalles que te interesan.
Siguientes pasos
Tu complemento vacío funciona. Ahora dale algo que hacer:
- Tu primer objeto personalizado
- Bloque personalizado
- Exportar y jugar para compartirlo con tus amigos