アイテムは、インベントリに表示されるコンテンツの一部です。クリックしたときにアクションを実行したり、食べたり、エンティティをスポーンしたりできます。次のドキュメントでは、 Item
クラス全体とそれに関連するすべての概要を説明します。従うことができるチュートリアルについては、実用的な例:アイテムの追加 を参照してください。
Item
コンストラクターには Item.Settings
インスタンスが必要です。このビルダークラスは、スタックサイズ、耐久性、アイテムが食べられるかどうかなどの動作を定義します。利用可能なビルダーメソッドの完全な表を以下に示します。
メソッド | 引数 | 説明 |
---|---|---|
food | FoodComponent | 指定された FoodComponent に基づいて、アイテムを食べられるように変更します。 |
maxCount | int | アイテムの最大スタック数を設定します。耐久度との併用はできません。 |
maxDamageIfAbsent | int | まだ設定されていない場合、アイテムの最大耐久度を設定します。 |
maxDamage | int | アイテムの最大耐久度を設定します。 |
recipeRemainder | Item | アイテムがレシピで使用された後にプレイヤーに返される、アイテムのレシピの残りを設定します。 |
group | ItemGroup | クリエイティブタブに使用される Item の ItemGroup を設定します。 |
rarity | Rarity | アイテムの希少度を設定し、名前の色を変更します。 |
fireproof | None | アイテムが耐火性であることを示します。アイテムが溶岩や火によって破壊されるのを防ぎます。 |
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 | 赤紫色 |
public Item.Settings fireproof()
アイテムを耐火性としてマークし、アイテムを含むアイテムエンティティを火と溶岩から保護します。