Table of Contents

Предметы

Предмет - это часть вашего инвентаря. Предмет может выполнять действия при нажатии на него, выступать в кач-ве еды или призывать сущности. Нижепредставленная документация позволит вам понять класс 'Item' и всё что с ним связано. Помимо этого, вы можете ознакомиться со статьёй Пример на практике: Создание предмета.

Настройки предмета

Конструктор Item требует передать в себя объекта типа Item.Settings. Этот класс-сборщик объясняет различные свойства вроде максимального размера в стаке, прочность и является ли предмет съедобным. Полный список методов, доступных здесь показан ниже:

Метод Аргументы Описание
food FoodComponent Меняет предмет на съедобный, основываясь на FoodComponent.
maxCount int Устанавливает максимальное кол-во предметов в стаке. Не может быть использовано вместе с прочностью.
maxDamageIfAbsent int Устанавливает максимальное значение прочности, если оно ещё не установлено.
maxDamage int Устанавливает максимальное значение прочности.
recipeRemainder Item Устанавливает уведомление о предмете, которое показывается когда игрок смастерил предмет в верстаке.
group ItemGroup Устанавливает предмету ItemGroup, что используется в меню творческого режима.
rarity Rarity Устанавливает редкость предмета, что влияет на цвет его названия.
fireproof None Помечает предмет как огнеупорный. Такие предметы не сгорают в лаве и огне.

Настройки предмета (Fabric)

API предметов Fabric предоставляет дополнительные методы, которые позволяют ещё сильнее настроить предмет. Чтобы использовать его, просто замените new Item.Settings() на new FabricItemSettings(). Ниже представлен список доп. возможностей, которые предоставляет FabricItemSettings:

Метод Аргументы Описание
equipmentSlot EquipmentSlotProvider Устанавливает EquipmentSlotProvider для предмета.
customDamage CustomDamageHandler Устанавливает CustomDamageHandler для предмета.

Еда

public Item.Settings food(FoodComponent foodComponent)

foodComponent - объект типа 'FoodComponent'. Если установлено, предмет будет конвертирован в его съедобную версию. Для большей информации ознакомьтесь с Введением в FoodComponent.


Максимальное кол-во в стаке

public Item.Settings maxCount(int maxCount)

maxCount - максимальное кол-во предметов в стаке для данного. Если maxDamage() уже было вызвано ранее, будет выброшено RuntimeException, т.к. предмет не может содержать в себе и то, и другок. Рекомендуется использовать числа ниже 64 (включительно), т.к. значения выше могут привести к непредвиденным проблемам.


Макс. прочность если не задано

public Item.Settings maxDamageIfAbsent(int maxDamage)

maxDamage - макс. прочность заданного Item в форме ItemStack.

Если maxDamage() ещё не вызывалось, будет установлено заданное значение. Это в основном используется для инструментов или брони, где прочность предмета привязана к прочности ToolMaterial и ещё не устанавливалась.


Макс. прочность

public Item.Settings maxDamage(int maxDamage)

maxDamage - макс. прочность в форме ItemStack.


Уведомление о рецепте

public Item.Settings recipeRemainder(Item recipeRemainder)

recipeRemainder - Предмет, возвращаемый в качестве остатка, когда базовый предмет используется в рецепте крафта.

Когда для предмета задан остаток рецепта, любой рецепт, использующий этот предмет, вернет остаток при крафте. Это используется для ведер (Вода, Лава, Молоко) и бутылок (Дыхание Дракона, Мед), возвращающих соответствующие пустые предметы при использовании в рецептах.


Группы

public Item.Settings group(ItemGroup group)

group - ItemGroup to add Item in.

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


Редкость

public Item.Settings rarity(Rarity rarity)

rarity - Редкость предмета

Если задан Rarity, данный элемент будет иметь пользовательский цвет имени. Редкость предмета по умолчанию равна обычной.

Редкость Цвет
Common(обычный) Белый
Uncommon(необычный) Жёлтый
Rare(редкий) Голубой
Epic(эпический) Розовый

Огнеупорность

public Item.Settings fireproof()

Помечает предмет как огнеупорный и защищает энтити предмета от огня и лавы.