====== Agregando objetos ======

==== Introducción ====

Agregando un objeto básico es uno de los primeros pasos para modding. Necesitarás crear un objeto de ''<yarn class_1792>'', registrarlo y darle una textura. Para darle un comportamiento más complejo a tu objeto, necesitarás tu propia clase de <yarn class_1792>. En este tutorial, el nombre genérico “tutorial” será usado como un nombre de relleno. Si tienes un modid diferente, puedes usar ese.

==== Registrando un Objeto ====

Primero, crea una instancia de <yarn class_1792> y guardala en una variable final estática. El inicializador del objeto toma una instancia de ''<yarn class_1792>.<yarn class_1793>'' (o un ''FabricItemSettings''), el cual es usado para inicializar las propiedades del objeto como la durabilidad, y la cantidad de items en un stack. 

<yarncode java [enable_line_numbers="true"]>
public class ExampleMod implements ModInitializer {

    // una instancia de nuestro nuevo objeto
    public static final class_1792 CUSTOM_ITEM = new class_1792(new FabricItemSettings());
    [...]
}
</yarncode>

Usarás el sistema de registros vanilla para registrar nuestro nuevo contenido. La sintaxis básica es ''<yarn class_2378>#<yarn method_10230>(Registry Type, <yarn class_2960>, Content)''. Los tipos de registros (Registry Types) son guardados en variables finales estáticas en la clase ''<yarn class_7923>'' o ''<yarn class_2378>'', y el identificador (identifier) es lo que la da un nombre a tu contenido. El contenido (Content) is una instancia de lo que sea que estés agregando. Esta acción puede ser llamada en cualquier lugar con tal de que sea durante la initialización del mod.

<yarncode java [enable_line_numbers="true"]>
public class ExampleMod implements ModInitializer {

    // una instancia de nuestro nuevo objeto
    public static final class_1792 CUSTOM_ITEM = new class_1792(new FabricItemSettings());

    @Override
    public void onInitialize() {
        class_2378.method_10230(class_7923.field_41178, new class_2960("tutorial", "objeto_custom"), CUSTOM_ITEM);
    }
}
</yarncode>
Tu nuevo objeto ahora ha sido agregado a Minecraft. Corre la configuración de Gradle ''Minecraft Client'' o ''runClient'' para verlo en acción, ejecuta el comando ''/give @s tutorial:objeto_custom'' en un mundo.

{{:tutorial:2019-02-17_16.50.44.png?400|}}

Puedes simplificar el código de la siguiente manera:
<yarncode java [enable_line_numbers="true"]>
public class ExampleMod implements ModInitializer {

    // una instancia de nuestro nuevo objeto
    public static final class_1792 CUSTOM_ITEM =
      class_2378.method_10230(class_7923.field_41178, new class_2960("tutorial", "custom_item"),
        new class_1792(new FabricItemSettings()));

    @Override
    public void onInitialize() {
    }
}
</yarncode>

==== Añadiendo texturas a objetos ====

Para registrar una textura para un objeto, requieres de un archivo json con el modelo del objeto, y una imágen para la textura. La dirección de los archivos para cada uno es:

    Item model: .../resources/assets/tutorial/models/item/custom_item.json
    Item texture: .../resources/assets/tutorial/textures/item/custom_item.png

Puedes encontrar nuestro ejemplo [[https://i.imgur.com/CqLSMEQ.png|aquí]].

Si has registrado tu objeto correctamente en el primer paso, tu juego te dirá que falta un archivo de textura de una forma similar a esta:

    [Server-Worker-1/WARN]: Unable to load model: 'tutorial:custom_item#inventory' referenced from: tutorial:custom_item#inventory: java.io.FileNotFoundException: tutorial:models/item/custom_item.json
Convenientemente te dice donde el juego espera que tus recursos estén- cuando estés en duda, verifica los logs.

Una plantilla básica para el modelo de un objeto es:
<code JavaScript>
{
  "parent": "item/generated",
  "textures": {
    "layer0": "tutorial:item/objeto_custom"
  }
}
</code>
El "parent" de tu objeto cambia como es renderizado en la mano y es útil para cosas como objetos bloque en el inventario. "item/handheld" es usado para herramientas que son agarradas desde la esquina inferior izquierda de la textura.

Resultado final:

{{:tutorial:item_texture.png?400|}}

==== Creando una clase Item ====

Para añadir comportamiento adicional a nuestro objeto, tendremos que hacer una clase Item. El constructor por defecto requiere una instancia de Item.Settings.
<yarncode java [enable_line_numbers="true"]>
public class CustomItem extends class_1792 {

    public CustomItem(class_1793 settings) {
        super(settings);
    }
}
</yarncode>

Un uso práctico para una clase Item custom sería hacer que el objeto produzca un sonido cuando lo uses:
<yarncode java [enable_line_numbers="true"]>
public class CustomItem extends class_1792 {

    public CustomItem(class_1793 settings) {
        super(settings);
    }

    @Override
    public class_1271<class_1799> method_7836(class_1937 world, class_1657 playerEntity, class_1268 hand) {
        playerEntity.method_5783(class_3417.field_14983, 1.0F, 1.0F);
        return class_1271.method_22427(playerEntity.method_5998(hand));
    }
}
</yarncode>

Reemplaza el viejo objeto <yarn class_1792> con una instancia de tu nueva clase Item:
<yarncode java [enable_line_numbers="true"]>
public class ExampleMod implements ModInitializer {

    // una instancia de nuestro nuevo objeto
    public static final CustomItem CUSTOM_ITEM = new CustomItem(new FabricItemSettings());
    [...]
}
</yarncode>
Si has hecho todo correctamente, tu objeto ahora debería producir un sonido.

==== ¿Que tal si quiero cambiar el tamaño del stack de mi item? ====
Para esto puedes usar ''<yarn method_7889>(int size)'' el cual está en ''FabricItemSettings'' para especificar el tamaño máximo del stack de tu objeto. Ten en cuenta que si tu item puede tomar daño no puedes especificar un tamaño máximo del stack de tu objeto, o si no el juego arrojará un RuntimeException.
<yarncode java [enable_line_numbers="true"]>
public class ExampleMod implements ModInitializer {

    // Una instancia de nuestro nuevo objeto, en donde el tamaño máximo del stack del objeto es 16
    public static final CustomItem CUSTOM_ITEM = new CustomItem(new FabricItemSettings().method_7889(16));
    [...]
}
</yarncode>

==== Has que tu objeto sea combustible o compostable ====

Si quieres que tu objeto pueda ser usado como combustible, puedes usar ''FuelRegistry'', por ejemplo:
<code java>
public class ExampleMod implements ModInitializer {
    [...]
    
    @Override
    public void onInitialize() {
        [...]
        FuelRegistry.INSTANCE.add(CUSTOM_ITEM, 300)
    }
}
</code>

De forma similar, puedes usar ''CompostingChanceRegistry'' para hacerlo compostable en una compostadora.
==== Siguientes Pasos ====
[[tutorial:itemgroup|Agrega tu objeto a su propio ItemGroup]].