Создание вашего первого предмета

Узнайте, как зарегистрировать предмет, добавить текстуру, модель и название.

WARNING

Эта страница написана для версии 1.21.10. Документация для более старых версий может быть неполной.

На этой странице вы познакомитесь с некоторыми ключевыми концепциями, касающимися предметов, а также с тем, как их регистрировать, задавать текстуры, моделировать и давать названия.

Если вы не знали, то все в Майнкрафте хранится в реестрах, и предметы не стали исключением.

Подготовка класса вашего предмета

Для упрощения регистрации предметов вы можете создать метод, принимающий строковый идентификатор, некоторые настройки предмета и фабрику для создания экземпляра Item.

Этот метод будет создавать предмет с данным идентификатором и регистрировать его с помощью реестра предметов игры.

Вы можете поместить этот метод в класс под именем ModItems (или как вы его назовете).

Mojang уже сделали это со своими предметами! Загляните в класс Items для вдохновения.

java

public class ModItems {
	public static <T extends Item> T register(String name, Function<Item.Properties, T> itemFactory, Item.Properties settings) {
		// Create the item key.
		ResourceKey<Item> itemKey = ResourceKey.create(Registries.ITEM, ResourceLocation.fromNamespaceAndPath(ExampleMod.MOD_ID, name));

		// Create the item instance.
		T item = itemFactory.apply(settings.setId(itemKey));

		// Register the item.
		Registry.register(BuiltInRegistries.ITEM, itemKey, item);

		return item;
	}

}

Обратите внимание на использование интерфейса Function в качестве фабрики, которая позже позволит нам указать, как мы хотим создать наш предмет из настроек с помощью Item::new.

Регистрация предмета

Теперь вы можете зарегистрировать предмет, используя метод.

Метод регистрации принимает экземпляр класса Item.Properties в качестве параметра. Этот класс позволяет вам настраивать свойства предмета через различные методы.

TIP

If you want to change your item's stack size, you can use the maxStackSize method in the Item.Properties class.

Это не сработает, если вы пометили предмет как повреждаемый, потому что размер для повреждаемых предметов всегда равен 1, для предотвращения эксплойтов дублирования.

java

public static final Item SUSPICIOUS_SUBSTANCE = register("suspicious_substance", Item::new, new Item.Properties());

Item::new говорит функции регистрации создать экземпляр Item из Item.Properties, вызывая конструктор Item (new Item(...)), принимающий Item.Properties в качестве параметра.

Однако, если вы сейчас попытаетесь запустить измененный клиент, то увидите, что наш предмет еще не существует в игре! Это происходит потому, что вы не инициализировали класс статически.

Чтобы сделать это, вы можете добавить в свой класс общедоступный статический метод инициализации и вызвать его из вашего класса инициализатор мода. На данный момент этот метод может остаться пустым.

java

public static void initialize() {
}

java

public class ExampleModItems implements ModInitializer {
	@Override
	public void onInitialize() {
		ModItems.initialize();
	}
}

Вызов метода класса статически инициализирует его, если он не был ранее загружен — это означает, что оцениваются все статические поля. Вот для чего нужен этот фиктивный метод initialize.

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

INFO

Если вы хотите добавить предмет в собственную CreativeModeTab, ознакомьтесь со страницей Собственные группы предмета для получения дополнительной информации.

Для примера мы добавим этот элемент в CreativeModeTab "ингредиенты", вам нужно будет использовать события групп предметов из Fabric API, а именно ItemGroupEvents.modifyEntriesEvent

Это может быть сделано в методе initialize вашего класса.

java

// Get the event for modifying entries in the ingredients group.
// And register an event handler that adds our suspicious item to the ingredients group.
ItemGroupEvents.modifyEntriesEvent(CreativeModeTabs.INGREDIENTS)
		.register((itemGroup) -> itemGroup.accept(ModItems.SUSPICIOUS_SUBSTANCE));

Запустив игру, вы можете увидеть, что наш предмет зарегистрирован и находится в категории предметов "ингредиенты":

Однако, не хватает следующего:

Модель предмета
Текстура
Перевод(название)

Наименование предмета

Сейчас у предмета нет перевода, поэтому вам необходимо его добавить. Ключ перевода уже предоставлен Minecraft: item.example-mod.suspicious_substance.

Создайте новый файл JSON: src/main/resources/assets/example-mod/lang/en_us.json и введите ключ перевода, а также его значение:

json

{
  "item.example-mod.suspicious_substance": "Suspicious Substance"
}

Вы можете перезапустить игру или создать свой мод и нажать F3+T, чтобы применить изменения.

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

Чтобы задать вашему предмету текстуру и модель, просто создайте изображение текстуры 16x16 для вашего предмета и сохраните его по адресуassets/example-mod/textures/item. Назовите файл текстуры, так же как предмет, но c расширением .png.

В качестве примера вы можете использовать этот пример текстуры для suspicious_substance.png

Download 'Текстура'

При перезапуске/перезагрузке игры вы должны увидеть, что у предмета по-прежнему нет текстуры, это потому, что вам нужно будет добавить модель, использующую эту текстуру.

Вы собираетесь создать простую модель «item/generated», которая принимает на входе только текстуру и ничего больше.

Создайте модель JSON в папке assets/example-mod/models/item с тем же именем, что и у элемента; suspicious_substance.json

json

{
  "parent": "minecraft:item/generated",
  "textures": {
    "layer0": "example-mod:item/suspicious_substance"
  }
}

Разбор модели JSON

parent: Это родительская модель, от которой будет унаследована данная модель. В данном случае это модель item/generated.
textures: Здесь вы определяете текстуры для модели. Ключ layer0 — это текстура, которую будет использовать модель.

Большинство элементов будут использовать модель item/generated в качестве родительской, поскольку это простая модель, которая просто отображает текстуру.

Существуют альтернативы, такие как item/handheld, которые используются для предметов, которые "удерживаются" в руке игрока, таких как инструменты.

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

Minecraft автоматически не узнает, где можно найти файлы модели вашего предмета, вам нужно предоставить описание модели предмета.

Создайте JSON-файл описания предмета в assets/example-mod/items с тем же именем файла, что и идентификатор предмета: suspicious_substance.json.

json

{
  "model": {
    "type": "minecraft:model",
    "model": "example-mod:item/suspicious_substance"
  }
}

Разбивка описания модели предмета JSON

model: это свойство, содержащее ссылку на нашу модель.
- type: это тип нашей модели. Для большинства предметов это должно быть minecraft:model
- model: это идентификатор модели. Он должен иметь следующую форму: example-mod:item/item_name

Теперь ваш предмет в игре должен выглядеть так:

Сделать предмет компостируемым или топливом

API Fabric предоставляет различные реестры, которые можно использовать для добавления дополнительных свойств к вашему элементу.

Например, если вы хотите сделать свой предмет компостируемым, то вы можете использовать CompostableItemRegistry:

java

// Add the suspicious substance to the composting registry with a 30% chance of increasing the composter's level.
CompostingChanceRegistry.INSTANCE.add(ModItems.SUSPICIOUS_SUBSTANCE, 0.3f);

В качестве альтернативы, если вы хотите превратить свой предмет в топливо, вы можете использовать событие FuelRegistryEvents.BUILD:

java

// Add the suspicious substance to the registry of fuels, with a burn time of 30 seconds.
// Remember, Minecraft deals with logical based-time using ticks.
// 20 ticks = 1 second.
FuelRegistryEvents.BUILD.register((builder, context) -> {
	builder.add(ModItems.SUSPICIOUS_SUBSTANCE, 30 * 20);
});

Добавление рецепта создания

Если вы хотите добавить рецепт создания вашего предмета, вам необходимо поместить JSON-файл рецепта в папку data/example-mod/recipe.

Для получения дополнительной информации о формате рецепта, посетите эти ресурсы:

Пользовательские подсказки

Если вы хотите, чтобы у вашего элемента была настраиваемая подсказка, вам нужно будет создать класс, расширяющий Item, и переопределить метод appendHoverText.

INFO

В этом примере используется класс LightningStick, созданный на странице Взаимодействия пользовательских элементов.

java

@Override
public void appendHoverText(ItemStack stack, TooltipContext context, TooltipDisplay displayComponent, Consumer<Component> textConsumer, TooltipFlag type) {
	textConsumer.accept(Component.translatable("itemTooltip.example-mod.lightning_stick").withStyle(ChatFormatting.GOLD));
}

Каждый вызов add() добавляет одну строку в подсказку.

Creating Your First Item

Block Entities

Интерфейсы и экраны

Частицы

Client Resources

Server Resources

Migrating Mappings

Авторы страницы

Ссылки на файлы

Авторы страницы

Создание вашего первого предмета

Подготовка класса вашего предмета

Регистрация предмета

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

Наименование предмета

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

Разбор модели JSON

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

Разбивка описания модели предмета JSON

Сделать предмет компостируемым или топливом

Добавление рецепта создания

Пользовательские подсказки

Авторы страницы

Ссылки на файлы

Авторы страницы

Создание вашего первого предмета ​

Подготовка класса вашего предмета ​

Регистрация предмета ​

Добавление предмета к группе предметов ​

Наименование предмета ​

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

Разбор модели JSON ​

Создание описания модели предмета ​

Разбивка описания модели предмета JSON ​

Сделать предмет компостируемым или топливом ​

Добавление рецепта создания ​

Пользовательские подсказки ​

Создание вашего первого предмета

Подготовка класса вашего предмета

Регистрация предмета

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

Наименование предмета

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

Разбор модели JSON

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

Разбивка описания модели предмета JSON

Сделать предмет компостируемым или топливом

Добавление рецепта создания

Пользовательские подсказки