Fabric Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Добавление предмета ======

==== Введение ====

Добавление простого предмета - один из первых шагов в создании модов. Вы собираетесь создать объект ''Item'', зарегистрировать его и дать ему текстуру. Чтобы добавить дополнительное поведение предмету, вам необходимо сделать ваш собственный класс предмета. В этом и следующих туториалах имена “tutorial” используются как образец, Если у Вас есть отдельное modid - не стесняйтесь использовать его вместо “tutorial”.
==== Регистрация предмета ====

Для начала создайте экземпляр предмета. Мы поместим его на верх нашего класса инициализатора. Конструктор принимает в себя образец ''Item.Settings'' (или ''FabricItemSettings''), который используется для задания свойств предмета, таких как категория (в творческом меню), прочность и размер стака.

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

    // экземпляр нашего нового предмета
    public static final Item FABRIC_ITEM = new Item(new FabricItemSettings().group(ItemGroup.MISC));
    [...]
}
</code>
Вы будете использовать классическую систему регистрации нового контента. Вот базовый синтаксис ''Registry#register(Registry Type, Identifier, Content)''. Типы регистрации хранятся как статические типы в классе ''Registry'', и идентификатор обозначает ваш контент. Контент - это экземпляр всего, что вы добавляете. Он может быть вызван в любой момент во время инициализации.
<code java [enable_line_numbers="true"]>
public class ExampleMod implements ModInitializer {

    // экземпляр нашего нового предмета
    public static final Item FABRIC_ITEM = new Item(new FabricItemSettings().group(ItemGroup.MISC));
      
    @Override
    public void onInitialize() {
        Registry.register(Registry.ITEM, new Identifier("tutorial", "fabric_item"), FABRIC_ITEM);
    } 
}
</code>
Теперь Ваш предмет добавлен в Minecraft. Нажмите задачу Gradle ''runClient'', чтобы увидеть его в действии

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

==== Добавление предмету текстуры ====

Для регистрации текстуры необходимы .json файл модели и изображение с самой текстурой. Вам нужно поместить их в папку с ресурсами тут:

    Модель предмета: .../resources/assets/tutorial/models/item/fabric_item.json
    Текстура предмета: .../resources/assets/tutorial/textures/item/fabric_item.png
Примеры наших текстур находятся [[https://i.imgur.com/CqLSMEQ.png|здесь]].

Если Вы зарегистрировали Ваш предмет правильно в начале, игра сообщит Вам о том, что не может найти текстуру подобным образом:

    [Server-Worker-1/WARN]: Unable to load model: 'tutorial:fabric_item#inventory' referenced from: tutorial:fabric_item#inventory: java.io.FileNotFoundException: tutorial:models/item/fabric_item.json

Он удобно сообщает вам, где именно, как он ожидает, будут найдены ваши текстуры -- если вы сомневаетесь, проверьте логи.

Базовым шаблоном модели предмета является:
<code JavaScript>
{
  "parent": "item/generated",
  "textures": {
    "layer0": "tutorial:item/fabric_item"
  }
}
</code>
''Parent'' указывает, как предмет должен отображаться в руке, это полезно для таких вещей, как предметы блоков в инвентаре. ''item/handheld'' используется для инструментов, которые держатся за нижний левый угол текстуры. ''textures/layer0'' это расположение файла с картинкой.

Конечный текстурированный результат:

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

==== Создание класса предмета ====

Чтобы добавить дополнительное поведение к предмету, вам нужно будет создать класс предмета. Конструктору по умолчанию требуется объект ''Item.Settings''.
<code java [enable_line_numbers="true"]>
public class FabricItem extends Item {

    public FabricItem(Settings settings) {
        super(settings);
    }
}
</code>

Практическим вариантом использования класса предмета было бы заставить предмет воспроизводить звук, когда вы его используете:
<code java [enable_line_numbers="true"]>
public class FabricItem extends Item {

    public FabricItem(Settings settings) {
        super(settings);
    }
      
    @Override
    public TypedActionResult<ItemStack> use(World world, PlayerEntity playerEntity, Hand hand) {
        playerEntity.playSound(SoundEvents.BLOCK_WOOL_BREAK, 1.0F, 1.0F);
        return TypedActionResult.success(playerEntity.getStackInHand(hand));
    }
}
</code>

Замените старый объект Item экземпляром вашего нового класса предмета:
<code java [enable_line_numbers="true"]>
public class ExampleMod implements ModInitializer {

    // экземпляр нашего нового предмета
    public static final FabricItem FABRIC_ITEM = new FabricItem(new FabricItemSettings().group(ItemGroup.MISC));
    [...]
}
</code>
Если вы все сделали правильно, то при использовании предмета теперь должен воспроизводиться звук.

==== Что делать, если я хочу изменить размер стака моего предмета? ====

Для этого вы должны использовать ''maxCount(int size)'' внутри ''FabricItemSettings'', чтобы указать максимальный размер стека. Обратите внимание, что если ваш предмет может быть поврежден, вы не можете указать максимальный размер стека, иначе игра выдаст исключение RuntimeException.
<code java [enable_line_numbers="true"]>
public class ExampleMod implements ModInitializer {

    // Экземпляр нашего нового предмета, где стак предметов это 16
    public static final FabricItem FABRIC_ITEM = new FabricItem(new FabricItemSettings().group(ItemGroup.MISC).maxCount(16));
    [...]
}
</code>
==== Следующие шаги ====
[[ru:tutorial:itemgroup|Добавьте свой предмет в свою собственную группу предметов]].