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()
Помечает предмет как огнеупорный и защищает энтити предмета от огня и лавы.