Items sind die Teile, die in deinem Inventar sind. Sie können Aktionen ausführen, wenn du klickst, als Nahrung fungieren oder Wesen (Entitys) erschaffen. Die folgende Dokumentation gibt dir einen Überblick über die gesamte Item-Klasse und alles, was damit zusammenhängt.
Der Item-Konstruktor benötigt eine Item.Settings-Instance. Diese Builder-Klasse definiert Verhalten wie Stapelgröße (stack size), Haltbarkeit (durability) und ob das Element essbar ist. Eine vollständige Tabelle der verfügbaren Builder-Methoden ist unten dargestellt:
| Methode | Argumente | Beschreibung |
|---|---|---|
| food | FoodComponent | Macht das Item essbar, basierend auf der angegebenen FoodComponent. |
| maxCount | int | Legt die max. Stapelzahl des Itmes fest. Kann nich in Kombination mit Schaden verwendet werden. |
| maxDamageIfAbsent | int | Legt die maximale Schadensanzahl des Items fest, falls dies noch nicht geschehen ist. |
| maxDamage | int | Legt die maximale Haltbarkeit des Items fest. |
| recipeRemainder | Item | Legt den Überbleib des Gegenstands fest, der an den Spieler zurückgegeben wird, nachdem der Gegenstand in einem Rezept verwendet wurde. |
| group | ItemGroup | Legt die Item-Gruppe des Items fest, die für Kreative-Tabs verwendet wird. |
| rarity | Rarity | Setzt die Rarität des Items fest, welches Farbe des Namens ändert. |
| fireproof | None | Macht das Item feuerfest. Verhindert die Zerstörung durch Lava und Feuer. |
Die Fabic Item API bietet zusätzliche Methoden, um noch mehr Attribute festzulegen. Um es zu verwenden, ersetze einfach new Item.Settings() durch new FabricItemSettings(). Hier eine Liste mit den zusätzlichen Funktionen:
| Methode | Argumente | Beschreibung |
|---|---|---|
| equipmentSlot | EquipmentSlotProvider | Legt den Ausrüstungsplatzanbieter des Items fest. |
| customDamage | CustomDamageHandler | Legt die benutzerdefinierten Schadens-Aktion des Gegenstands fest. |
public Item.Settings food(FoodComponent foodComponent)
foodComponent- Instanz von FoodComponent. Wenn gesetzt, ist das Item basierend auf den FoodComponent-Builder bereitgestellten Einstellungen essbar. Eine ausführliche Erklärung der vorhandenen Optionen findest du in der FoodComponent-Übersicht.
public Item.Settings maxCount(int maxCount)
maxCount - Die maximale Anzahl von einem Item-Stack für ein Item. Wenn maxDamage() schon aufgerufen wurde, wird eine RuntimeExeption geworfen, da ein Item nicht beides, Schaden und Anzahl, haben kann. Es ist empfohlen, die max. Stapelgröße bei 64 oder niedriger zu halten, da jeder Wert darüber zu verschiedenen Problemen führen kann.
public Item.Settings maxDamageIfAbsent(int maxDamage)
maxDamage - maximale Haltbarkeit eines Items wenn es in Form eines ItemStacks ist.
Wenn maxDamage() noch nicht aufgerufen wurde, wird die maximale Haltarkeit des Items auf den übergeordneten Wert gesetzt. Dies wird für Fälle wie wie Werkzeuge und Rüstungen verwendet, bei denen die Haltbarkeit des Items nur auf die Haltbarkeit des Werkzeugmaterials gesetzt wird, wenn dies noch nicht festgelegt wurde.
public Item.Settings maxDamage(int maxDamage)
maxDamage - die maximale Haltbarkeit des gegebenen Items in ItemStack-Form.
public Item.Settings recipeRemainder(Item recipeRemainder)
recipeRemainder - Item, das als Rest in einem Rezept nach dem herstellen im Slot überbleibt.
Wenn ein Rezeptrückstand auf ein Item gesetzt wird, gibt jedes Rezept, das dieses Item verwendet, den Rezeptrückstand zurück. z.B. Milch-, Lava und Wassereimer hinterlassen leere Eimer und Flaschen (Drachenatem, Honig).
public Item.Settings group(ItemGroup group)
group - Die ItemGroup, in die das Item hinzugefügt werden soll.
Jede ItemGroup erscheint als Registerkarte im Creative-Inventar. Wenn du dieser Gruppe ein Item hinzufügst, wird es der Registerkarte hinzugefügt. Die Reihenfolge der Gruppe basiert auf der Registrierungsreihenfolge. Weitere Informationen zum Erstellen einer Gruppe finden Sie auf der Seite ItemGroups.
public Item.Settings rarity(Rarity rarity)
rarity - Die seltenheit des gegebenen Items.
Wenn die Rarität gesetzt wird, hat das Item eine benutzerdefinierte Farbe des Namens.
| Seltenheit | Farbe |
|---|---|
| Gewöhnlich | Weiß |
| Ungewöhnlich | Gelb |
| Selten | Aqua |
| Episch | helles Lila |
—-
public Item.Settings fireproof()
Markiert den Gegenstand als feuerfest und schützt das ItemEntity, die das Item enthält, vor Feuer und Lava.