Werkzeuge und Waffen
Lerne, wie du deine eigenen Werkzeuge erstellst und deren Eigenschaften konfigurierst.
Werkzeuge sind für das Überleben und das Vorankommen unerlässlich, denn sie ermöglichen es den Spielern, Ressourcen zu sammeln, Gebäude zu bauen und sich zu verteidigen.
Ein Werkzeugmaterial erstellen
Du kannst ein Werkzeugmaterial erstellen, indem du ein neues ToolMaterial-Objekt instanziierst und es in einem Feld speicherst, das später verwendet werden kann, um die Werkzeugelemente zu erstellen, die das Material verwenden.
public static final ToolMaterial GUIDITE_TOOL_MATERIAL = new ToolMaterial(
INCORRECT_FOR_GUIDITE_TOOL, // incorrect blocks for drops
455, // durability
5.0F, // speed
1.5F, // attack damage bonus
22, // enchantment value
GuiditeArmorMaterial.REPAIRS_GUIDITE_ARMOR // repair items
);2
3
4
5
6
7
8
Der ToolMaterial-Konstruktor akzeptiert die folgenden Parameter, in dieser spezifischen Reihenfolge:
| Parameter | Beschreibung |
|---|---|
incorrectBlocksForDrops | Wenn ein Block im Tag incorrectBlocksForDrops ist, bedeutet das, dass der Block keine Gegenstände fallen lässt, wenn man ein Werkzeug aus diesem ToolMaterial zum abbauen dieses Blocks benutzt.Befindet sich ein Block im Tag incorrectBlocksForDrops, bedeutet dies, dass der Block keine Item fallen lässt, wenn du ein Werkzeug, das aus diesem ToolMaterial hergestellt wurde, auf diesen Block verwendest. |
durability | Die Haltbarkeit aller Werkzeuge, die aus diesem ToolMaterial bestehen. |
speed | Die Abbaugeschwindigkeit der Werkzeuge, die aus diesem ToolMaterial bestehen. |
attackDamageBonus | Der zusätzliche Angriffsschaden der Werkzeuge, die aus diesem ToolMaterial sind. |
enchantmentValue | Die "Verzauberbarkeit" von Werkzeugen, die aus diesem ToolMaterial bestehen. |
repairItems | Alle Gegenstände, die in diesem Tag enthalten sind, können verwendet werden, um Werkzeuge aus diesem ToolMaterial in einem Amboss zu reparieren. |
Für dieses Beispiel verwenden wir dasselbe Item Tag zur Reparatur, das wir auch für Rüstungen verwenden werden. Wir definieren die Tag-Referenz wie folgt:
public static final TagKey<Item> REPAIRS_GUIDITE_ARMOR = TagKey.create(BuiltInRegistries.ITEM.key(), ExampleMod.id("repairs_guidite_armor"));Wenn du Schwierigkeiten hast, ausgewogene Werte für einen der numerischen Parameter zu bestimmen, solltest du dir die Vanilla-Werkzeugmaterialkonstanten ansehen, wie zum Beispiel ToolMaterial.STONE oder ToolMaterial.DIAMOND.
Ein Werkzeugmaterial Tag erstellen
Für unser Tag incorrectBlocksForDrops können wir ein Tag erstellen, das zu den Vanilla Tags minecraft:incorrect_for_*_drops ähnlich ist. Diese legen fest, welche Blöcke beim Abbau mit dem jeweiligen Material nicht fallen gelassen werden. Lasst uns die Tag-Referenz wie folgt definieren:
public static final TagKey<Block> INCORRECT_FOR_GUIDITE_TOOL = TagKey.create(Registries.BLOCK,
ExampleMod.id("incorrect_for_guidite_tool"));2
Als Nächstes definieren wir den Inhalt des Tags mithilfe einer Tag JSON-Datei. Lasst uns die Guidite-Werkzeuge dieselben Blöcke abbauen wie die Holzwerkzeuge, zusätzlich zu Kupfererz und Tiefschiefer-Kupfererz:
{
"values": ["#minecraft:incorrect_for_wooden_tool"],
"fabric:remove": ["#minecraft:copper_ores"]
}2
3
4
Beachte, dass dieses Beispiel von einem schwächeren Werkzeugmaterial abgeleitet ist und Einträge entfernt, die unser stärkeres Material abbauen kann, wobei es alle anderen Blöcke erbt, die Holz nicht abbauen kann.
TIP
Wir könnten auch das umgekehrte machen: Von einem stärkeren Werkzeug erben und zusätzliche Blöcke anhängen, für die Guidite-Werkezge nicht geeignet sind.
Als Beispiel, wenn wir ein Werkzeug erstellen wollten, das wie Eisen funktioniert, aber kein Diamanterz abbauen kann, müsste values die Einträge #minecraft:incorrect_for_iron_tool und #minecraft:diamond_ores enthalten.
Wenn du möchtest, dass dein Werkzeug dieselben Blöcke abbaut wie ein bereits vorhandenes, kannst du das entsprechende Tag ohne Änderungen in die Definition deines Tags aufnehmen. Dies wird gegenüber der Übergabe des vorhandenen Tag als incorrectBlocksForDrops deines Materials empfohlen, damit Benutzer die falschen Blöcke für jedes Material unabhängig voneinander konfigurieren können.
Werkzeugitems registrieren
Du kannst deine Werkzeug-Items erstellen, indem du dieselben Klassen und Funktionen verwendest, die wir in dem Leitfaden Dein erstes Item erstellen implementiert haben:
Der float-Parameter bezieht sich jeweils auf den Angriffsschaden und die Angriffsgeschwindigkeit.
public static final ResourceKey<Item> GUIDITE_SWORD = create("guidite_sword");public static final Item GUIDITE_SWORD = register(
ModItemIds.GUIDITE_SWORD,
Item::new,
new Item.Properties().sword(GUIDITE_TOOL_MATERIAL, 1f, 1f)
);2
3
4
5
Vergiss nicht, sie zu einem Kreativtab hinzuzufügen, wenn du vom Kreativinventar aus auf sie zugreifen willst!
CreativeModeTabEvents.modifyOutputEvent(CreativeModeTabs.TOOLS_AND_UTILITIES)
.register((creativeTab) -> {
creativeTab.accept(ModItems.GUIDITE_SWORD);
creativeTab.accept(ModItems.GUIDITE_PICKAXE);
creativeTab.accept(ModItems.GUIDITE_AXE);
creativeTab.accept(ModItems.GUIDITE_SPEAR);
creativeTab.accept(ModItems.GUIDITE_HOE);
creativeTab.accept(ModItems.GUIDITE_SHOVEL);
});2
3
4
5
6
7
8
9
Du musst auch eine Textur, eine Itemübersetzung und ein Itemmodell hinzufügen. Für das Itemmodell solltest du jedoch anstelle von dem üblichen item/generated das Modell item/handheld als übergeordnetes Modell verwenden.
Assets
Du wirst auch eine Textur, eine Übersetzung, ein Client Item und ein Itemmodell hinzufügen müssen. Für das Itemmodell solltest du jedoch anstelle von dem üblichen item/generated das Modell item/handheld als übergeordnetes Modell verwenden.
INFO
Die folgenden Modelle wurden mithilfe der Datengenerierung erstellt. Weitere Informationen findest du in der Dokumentation zum Thema Erstellen von Itemmodellen.
itemModelGenerator.generateFlatItem(ModItems.GUIDITE_SWORD, ModelTemplates.FLAT_HANDHELD_ITEM);Hier sind alle in diesem Leitfaden verwendeten Beispieltexturen:
Werkzeugitems taggen
VORAUSSETZUNGEN
Weitere Informationen findest du in der Dokumentation zur Erstellung von Item Tags.
Es wird außerdem empfohlen, dein Werkzeug in den entsprechenden Item Tags einzuordnen. Werkzeuge verfügen über eigene Tags, wie beispielsweise ItemTags.SWORDS, die für die Verzauberbarkeit und andere spezifische Logik verwendet werden, beispielsweise ob ein Schwungkraft-Schaden verursacht werden soll.
Füge die folgenden Zeilen zu addTags in deinem Item Tag Provider hinzu:
builder(ItemTags.SWORDS)
.add(ModItemIds.GUIDITE_SWORD);
builder(ItemTags.PICKAXES)
.add(ModItemIds.GUIDITE_PICKAXE);
builder(ItemTags.AXES)
.add(ModItemIds.GUIDITE_AXE);
builder(ItemTags.SPEARS)
.add(ModItemIds.GUIDITE_SPEAR);
builder(ItemTags.HOES)
.add(ModItemIds.GUIDITE_HOE);
builder(ItemTags.SHOVELS)
.add(ModItemIds.GUIDITE_SHOVEL);2
3
4
5
6
7
8
9
10
11
12
Das war's dann auch schon! Im Spiel solltest du deine Werkzeuge in der Registerkarte "Tools and Utilities" im Kreativ Inventar Menü sehen.







