Armas y herramientas

En esta guía vas a crear dos cosas con rubíes: una espada de rubí que golpea más fuerte que el hierro y un pico de rubí que mina piedra y minerales rápidamente. Por el camino aprenderás los componentes que usan todas las armas y herramientas: daño, durabilidad, encantamientos, reparación y excavación.

Esta guía parte de Tu primer objeto personalizado. Los pasos del icono, la textura y el nombre funcionan igual, así que nos centraremos en lo nuevo.

La forma rápida: GodCraft

GodCraft tiene objetos de Espada y Herramienta ya preparados. Tú eliges los números y la app escribe los componentes y las etiquetas.

1. Abre el Taller y añade una Espada o una Herramienta a tu complemento.
2. Dibújala en el editor de píxeles (en diagonal, con el mango abajo a la izquierda, como las herramientas del juego base).
3. Ajusta el daño, la durabilidad, los objetos de reparación y los encantamientos.
4. Toca Exportar y pruébala con el zombi más cercano.

Así es como se hace a mano.

A mano: la espada

Usamos el espacio de nombres myname. Cámbialo por el tuyo en todas partes.

{
  "format_version": "1.26.30",
  "minecraft:item": {
    "description": {
      "identifier": "myname:ruby_sword",
      "menu_category": {
        "category": "equipment",
        "group": "minecraft:itemGroup.name.sword"
      }
    },
    "components": {
      "minecraft:icon": {
        "textures": {
          "default": "myname_ruby_sword"
        }
      },
      "minecraft:display_name": {
        "value": "item.myname:ruby_sword.name"
      },
      "minecraft:max_stack_size": 1,
      "minecraft:hand_equipped": true,
      "minecraft:damage": 7,
      "minecraft:durability": {
        "max_durability": 900
      },
      "minecraft:enchantable": {
        "slot": "sword",
        "value": 14
      },
      "minecraft:repairable": {
        "repair_items": [
          {
            "items": ["myname:ruby"],
            "repair_amount": "query.max_durability * 0.25"
          },
          {
            "items": ["myname:ruby_sword"],
            "repair_amount": "context.other->query.remaining_durability"
          }
        ]
      },
      "minecraft:tags": {
        "tags": ["minecraft:is_sword"]
      }
    }
  }
}

Qué hace cada parte

1. menu_category pone la espada en la pestaña Equipo, dentro de la misma carpeta que las espadas del juego base.
2. minecraft:max_stack_size vale 1, porque las armas no se apilan.
3. minecraft:hand_equipped hace que el jugador la sostenga como una herramienta, apuntando hacia delante, en lugar de como un objeto plano.
4. minecraft:damage es cuánto daño añade el objeto cuando atacas con él. Cuanto más alto, más fuerte. Empieza con unos 7 para una espada parecida a la de diamante, pruébala con algunas criaturas y ajústala.
5. minecraft:durability es cuánto desgaste aguanta el objeto antes de romperse. Las herramientas de hierro tienen 250 y las de diamante 1561. También puedes añadir damage_chance con un porcentaje min y max, si quieres que solo pierda durabilidad algunas veces.
6. minecraft:enchantable decide qué encantamientos le sirven. slot es el tipo de objeto (aquí sword) y value indica lo buenos que son los encantamientos en una mesa: el oro es muy alto, la piedra es bajo, y 14 es un término medio sólido.
7. minecraft:repairable indica con qué se puede reparar en un yunque. Cada entrada tiene los items y un repair_amount, que es una pequeña fórmula de Molang. La primera entrada devuelve un cuarto de la durabilidad por cada rubí. La segunda permite a los jugadores combinar dos espadas dañadas.
8. minecraft:tags con minecraft:is_sword le dice al juego y a otros complementos que esto es una espada.

Textura y nombre

Guarda un PNG de 16x16 en RP/textures/items/ruby_sword.png, añádelo a tu item_texture.json (dentro de texture_data) y pon el nombre en tu archivo de idioma:

"myname_ruby_sword": {
  "textures": "textures/items/ruby_sword"
}

item.myname:ruby_sword.name=Ruby Sword
item.myname:ruby_pickaxe.name=Ruby Pickaxe

A mano: el pico

Una herramienta es un arma con un trabajo más: romper bloques rápido. Ese trabajo le corresponde a minecraft:digger.

{
  "format_version": "1.26.30",
  "minecraft:item": {
    "description": {
      "identifier": "myname:ruby_pickaxe",
      "menu_category": {
        "category": "equipment",
        "group": "minecraft:itemGroup.name.pickaxe"
      }
    },
    "components": {
      "minecraft:icon": {
        "textures": {
          "default": "myname_ruby_pickaxe"
        }
      },
      "minecraft:display_name": {
        "value": "item.myname:ruby_pickaxe.name"
      },
      "minecraft:max_stack_size": 1,
      "minecraft:hand_equipped": true,
      "minecraft:damage": 5,
      "minecraft:durability": {
        "max_durability": 900
      },
      "minecraft:enchantable": {
        "slot": "pickaxe",
        "value": 14
      },
      "minecraft:repairable": {
        "repair_items": [
          {
            "items": ["myname:ruby"],
            "repair_amount": "query.max_durability * 0.25"
          }
        ]
      },
      "minecraft:digger": {
        "use_efficiency": true,
        "destroy_speeds": [
          {
            "block": {
              "tags": "query.any_tag('stone', 'metal')"
            },
            "speed": 7
          },
          {
            "block": "minecraft:obsidian",
            "speed": 7
          }
        ]
      },
      "minecraft:tags": {
        "tags": ["minecraft:is_pickaxe", "minecraft:is_tool", "minecraft:diamond_tier"]
      }
    }
  }
}

Cómo funciona la excavación

• destroy_speeds es una lista. Cada entrada dice qué bloques y a qué velocidad.
• block puede ser un ID de bloque, como "minecraft:obsidian", o un objeto con tags y una consulta de Molang. query.any_tag('stone', 'metal') coincide con todos los bloques que tengan al menos una de esas etiquetas, así que no tienes que poner cientos de bloques en la lista.
• speed es lo rápido que rompe esos bloques. Para hacerte una idea: las herramientas de madera son 2, las de piedra 4, las de hierro 6, las de diamante 8, las de netherita 9 y las de oro 12.
• use_efficiency en true permite que el encantamiento Eficiencia la haga aún más rápida.

Etiquetas para herramientas

Las etiquetas le dicen a Minecraft qué tipo de herramienta es. minecraft:is_pickaxe y minecraft:is_tool dicen "esto es un pico". Una etiqueta de nivel como minecraft:iron_tier o minecraft:diamond_tier dice lo fuerte que es, las mismas etiquetas que usan las herramientas del juego base. Otros tipos de herramienta usan minecraft:is_axe, minecraft:is_shovel o minecraft:is_hoe.

Pruébalo

1. Carga tus paquetes en un mundo nuevo (consulta Exportar e instalar).
2. Date los dos objetos con /give:

/give @s myname:ruby_sword
/give @s myname:ruby_pickaxe

3. Golpea a una criatura, mina algo de piedra e intenta encantar los dos en una mesa.
4. Desgástalos un poco y luego pon uno en un yunque con un rubí para probar la reparación.

Ranuras de encantamiento que puedes usar

Cuando algo sale mal

Tienes más soluciones en Solución de problemas. Para que los jugadores puedan fabricarlos, lee Recetas de crafteo y de horno, y para la armadura a juego, consulta Armadura personalizada.