¿Qué es un complemento?

Un complemento (add-on) es un conjunto de archivos que cambia Minecraft Bedrock Edition. Puede añadir objetos, bloques, criaturas, recetas y sonidos nuevos, o cambiar cosas que ya están en el juego. No necesitas modificar el juego en sí: Minecraft lee tus archivos y los carga encima del juego normal.

Lo mejor es que los complementos están hechos de simples archivos de texto e imágenes. Si sabes editar un archivo de texto y dibujar una imagen de 16x16, puedes hacer un complemento.

Dos tipos de paquetes

La mayoría de los complementos están formados por dos paquetes que trabajan en equipo.

Paquete de comportamiento (BP)

El paquete de comportamiento controla cómo funcionan las cosas. Vive en el lado "servidor" del juego, lo que significa que decide las reglas:

• cuánto daño hace una espada
• cuánta hambre recupera una comida
• qué hace una criatura cuando ve a un jugador
• qué objetos necesita una receta de fabricación
• qué se suelta al romper un bloque

Los paquetes de comportamiento son sobre todo archivos JSON, además de archivos .mcfunction para comandos y archivos JavaScript para scripts.

Paquete de recursos (RP)

El paquete de recursos controla qué aspecto y qué sonido tienen las cosas. Se ejecuta en el lado "cliente", en el dispositivo de cada jugador:

• texturas (las imágenes de objetos, bloques y criaturas)
• modelos 3D y animaciones
• sonidos y música
• los nombres que ves en el juego, en todos los idiomas
• partículas y algunos menús

¿Por qué dos paquetes?

Separar el aspecto de las reglas hace que los paquetes sean flexibles. Un paquete de texturas es solo un paquete de recursos sin paquete de comportamiento. Un paquete que solo cambia el comportamiento de las criaturas puede ser solo un paquete de comportamiento. Cuando añades algo totalmente nuevo, como una espada personalizada, normalmente necesitas los dos: el BP dice que existe y cómo funciona, y el RP le da una textura y un nombre.

Aquí tienes un ejemplo pequeñito. Este archivo del paquete de comportamiento crea un objeto nuevo:

{
  "format_version": "1.26.30",
  "minecraft:item": {
    "description": {
      "identifier": "demo:ruby",
      "menu_category": {
        "category": "items"
      }
    },
    "components": {
      "minecraft:icon": {
        "textures": {
          "default": "ruby"
        }
      },
      "minecraft:max_stack_size": 64
    }
  }
}

El nombre de icono "ruby" apunta a una imagen registrada en el paquete de recursos. Sin el paquete de recursos, el objeto seguiría existiendo pero no tendría textura. Crearás este objeto paso a paso en Tu primer objeto personalizado.

¿Qué puedes cambiar?

Los complementos dan mucho de sí. Estas son las cosas principales que aprenderás en esta wiki:

Cada cosa nueva se construye a partir de componentes. Un componente es una pequeña función, como "este objeto se puede comer" o "este bloque emite luz". Vas apilando componentes como si fueran piezas de construcción. La referencia de componentes de objeto los recoge todos con ejemplos.

Tipos de archivo que te vas a encontrar

Cuando descargas un complemento, normalmente viene como uno de estos archivos:

• .mcpack: un solo paquete (un paquete de comportamiento o un paquete de recursos). En realidad es un archivo .zip con otro nombre.
• .mcaddon: un conjunto que contiene varios paquetes, normalmente un BP y su RP juntos. También es un .zip renombrado.
• .mcworld y .mctemplate: mundos completos y plantillas de mundo, que pueden llevar paquetes dentro.

Cuando abres uno de estos archivos, Minecraft lo importa automáticamente. Aprenderás a crearlos en Exportar y jugar.

Funciona en todas partes

Bedrock Edition funciona en Windows, Android, iPhone y iPad, Xbox, PlayStation y Nintendo Switch. Los complementos usan los mismos archivos en todos ellos. Un paquete que hagas en tu móvil funciona en el PC de un amigo, y uno hecho en PC funciona en un móvil.

Hay algunos límites que conviene conocer:

• En las consolas no puedes importar tus propios archivos directamente. Aun así puedes jugar con complementos en un Realm, en un servidor o desde el Marketplace.
• Algunas funciones están marcadas como experimentales. Solo funcionan si el mundo tiene ese experimento activado. La mayoría de los objetos, bloques y criaturas ya no necesitan ningún experimento.

Dos formas de hacer un complemento

A mano. Creas carpetas, escribes JSON en un editor de texto, dibujas las texturas en un editor de imágenes y luego lo comprimes todo. Esta wiki te enseña cada paso, y saber cómo funcionan los archivos es una habilidad estupenda.

La forma fácil. GodCraft es una app gratuita para iPhone y Android que crea complementos sin código. Abres el Taller, añades cosas como objetos, bloques o criaturas y rellenas formularios sencillos. La app escribe por ti todo el JSON, los manifiestos y los UUID, y exporta un .mcaddon que se abre directamente en Minecraft.

Puedes combinar las dos formas. Muchos creadores empiezan en GodCraft para tener rápido un paquete que funcione, y luego leen esta wiki para entender qué hace cada archivo.

Qué leer después

1. Herramientas que necesitas: qué instalar, o cómo hacerlo todo desde el móvil.
2. Tu primer paquete: crea las carpetas y los manifiestos.
3. JSON en 5 minutos: el formato de archivo que usan todos los complementos.
4. Exportar y jugar: mete tu paquete en el juego.