Предмет - это часть вашего инвентаря. Предмет может выполнять действия при нажатии на него, выступать в кач-ве еды или призывать сущности. Нижепредставленная документация позволит вам понять класс 'Item' и всё что с ним связано. Помимо этого, вы можете ознакомиться со статьёй Пример на практике: Создание предмета.
Конструктор Item требует передать в себя объекта типа Item.Settings. Этот класс-сборщик объясняет различные свойства вроде максимального размера в стаке, прочность и является ли предмет съедобным. Полный список методов, доступных здесь показан ниже:
| Метод | Аргументы | Описание |
|---|---|---|
| food | FoodComponent | Меняет предмет на съедобный, основываясь на FoodComponent. |
| maxCount | int | Устанавливает максимальное кол-во предметов в стаке. Не может быть использовано вместе с прочностью. |
| maxDamageIfAbsent | int | Устанавливает максимальное значение прочности, если оно ещё не установлено. |
| maxDamage | int | Устанавливает максимальное значение прочности. |
| recipeRemainder | Item | Устанавливает уведомление о предмете, которое показывается когда игрок смастерил предмет в верстаке. |
| group | ItemGroup | Устанавливает предмету ItemGroup, что используется в меню творческого режима. |
| rarity | Rarity | Устанавливает редкость предмета, что влияет на цвет его названия. |
| fireproof | None | Помечает предмет как огнеупорный. Такие предметы не сгорают в лаве и огне. |
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()
Помечает предмет как огнеупорный и защищает энтити предмета от огня и лавы.