Table of Contents

アイテム

アイテムは、インベントリに表示されるコンテンツの一部です。クリックしたときにアクションを実行したり、食べたり、エンティティをスポーンしたりできます。次のドキュメントでは、 Item クラス全体とそれに関連するすべての概要を説明します。従うことができるチュートリアルについては、実用的な例:アイテムの追加 を参照してください。

アイテム設定

Item コンストラクターには Item.Settings インスタンスが必要です。このビルダークラスは、スタックサイズ、耐久性、アイテムが食べられるかどうかなどの動作を定義します。利用可能なビルダーメソッドの完全な表を以下に示します。

メソッド 引数 説明
food FoodComponent 指定された FoodComponent に基づいて、アイテムを食べられるように変更します。
maxCount int アイテムの最大スタック数を設定します。耐久度との併用はできません。
maxDamageIfAbsent int まだ設定されていない場合、アイテムの最大耐久度を設定します。
maxDamage int アイテムの最大耐久度を設定します。
recipeRemainder Item アイテムがレシピで使用された後にプレイヤーに返される、アイテムのレシピの残りを設定します。
group ItemGroup クリエイティブタブに使用される Item の ItemGroup を設定します。
rarity Rarity アイテムの希少度を設定し、名前の色を変更します。
fireproof None アイテムが耐火性であることを示します。アイテムが溶岩や火によって破壊されるのを防ぎます。

Fabric のアイテム設定

Fabric Item API は、さらに多くの属性を設定する追加のメソッドを提供します。 これを使用するには、 new Item.Settings()new FabricItemSettings() に置き換えるだけです:

メソッド 引数 説明
equipmentSlot EquipmentSlotProvider アイテムの装備スロットプロバイダーを設定します。
customDamage CustomDamageHandler アイテムのカスタムダメージハンドラーを設定します。

食料

public Item.Settings food(FoodComponent foodComponent)

foodComponent - FoodComponent のインスタンス。設定すると、 FoodComponent ビルダーによって提供される設定に基づいて、アイテムが食べられるようになります。利用可能なオプションの詳細な説明については、 FoodComponent の概要ページをご覧ください。


最大スタック数

public Item.Settings maxCount(int maxCount)

maxCount - 指定されたアイテムの ItemStack の最大数。 maxDamage() が既に呼び出されている場合、 Item はダメージとカウントの両方を持つことができないため、 RuntimeException がスローされます。最大数を 64 以下に保つことをお勧めします。これを超える値はさまざまな問題につながる可能性があります。


未設定の最大耐久度

public Item.Settings maxDamageIfAbsent(int maxDamage)

maxDamage - ItemStack 形式の場合の、指定された Item の最大耐久度。

maxDamage() がまだ呼び出されていない場合、アイテムの最大耐久度は渡された値に設定されます。これは、アイテムの耐久度がまだ設定されていない場合にのみ、 ToolMaterial の耐久度に設定されるツールや防具などの場合に使用されます。


最大耐久度

public Item.Settings maxDamage(int maxDamage)

maxDamage - ItemStack 形式の場合の、指定された Item の最大耐久度。


レシピの残り

public Item.Settings recipeRemainder(Item recipeRemainder)

recipeRemainder - 元のアイテムがクラフトレシピで使用されたときに残りとして返されるアイテム。

アイテムにレシピの残りが設定されている場合、そのアイテムを使用するすべてのレシピはクラフトの残りを返します。これは、バケツ(水、溶岩、ミルク)とボトル(ドラゴンブレス、ハニー)がレシピで使用されたときにそれぞれの空のアイテムを返すために使用されます。


グループ

public Item.Settings group(ItemGroup group)

group - アイテムを追加する ItemGroup。

各 ItemGroup は、クリエイティブインベントリのタブとして表示されます。このグループにアイテムを追加すると、タブに追加されます。グループの順序は、レジストリの順序に基づいています。グループの作成の詳細については、 ItemGroups を参照してください。


希少度

public Item.Settings rarity(Rarity rarity)

rarity - 指定されたアイテムの希少性。

希少度が設定されている場合、指定されたアイテムにはカスタムの名前の色が付けられます。アイテムの希少度はデフォルトで Common に設定されています。

希少度
Common 白色
Uncommon 黄色
Rare 青緑色
Epic 赤紫色

Fireproof

public Item.Settings fireproof()

アイテムを耐火性としてマークし、アイテムを含むアイテムエンティティを火と溶岩から保護します。