This is an old revision of the document!
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
- Item to return as a remainder when the base Item is used in a crafting recipe.
When a recipe remainder is set on an Item, any recipe using that Item will return the remainder on craft. This is used for buckets (Water, Lava, Milk) and bottles (Dragon Breath, Honey) returning their respective empty items when used in recipes.
Group
public Item.Settings group(ItemGroup group)
group
- ItemGroup to add Item in.
Each ItemGroup appears as a tab in the creative inventory. Adding an Item to this group will add it to the tab. The order of the group is based on registry order. For more information on creating a group, see the ItemGroups page.
Rarity
public Item.Settings rarity(Rarity rarity)
rarity
- Rarity of the given Item.
If Rarity is set, the given Item will have a custom name color. An Item's Rarity defaults to common.
Rarity | Color |
---|---|
Common | White |
Uncommon | Yellow |
Rare | Aqua |
Epic | Light Purple |
Fireproof
public Item.Settings fireproof()
Marks the item as being fireproof, and protects the item entity that contains the item from fire and lava.