Benutzerdefinierte Rüstung 26.2

Lerne, wie du deine eigenen Rüstungssets erstellst.

Die Rüstung bietet dem Spieler eine bessere Verteidigung gegen Angriffe von Mobs und anderen Spielern.

Eine Rüstungsmaterial Klasse erstellen

Technisch gesehen brauchst du keine eigene Klasse für dein Rüstungsmaterial, aber bei der Anzahl an statischen Felder, die du benötigst, ist es auf jeden Fall eine gute Praxis.

Für dieses Beispiel werden wir eine Klasse GuiditeArmorMaterial erstellen, um unsere statischen Felder zu speichern.

Grundhaltbarkeit

Diese Konstante wird in der Methode Item.Properties#maxDamage(int damageValue) verwendet, wenn wir unsere Rüstungsitems erstellen. Sie wird auch als Parameter im Konstruktor ArmorMaterial benötigt, wenn wir später unser ArmorMaterial-Objekt erstellen.

public static final int BASE_DURABILITY = 15;

Wenn du Schwierigkeiten hast, eine ausgewogene Grundhaltbarkeit zu bestimmen, kannst du dich an den Instanzen der Vanilla-Rüstungsmaterialien orientieren, die du in dem Interface ArmorMaterials findest.

Ausrüstungs Asset Ressourcenschlüssel

Obwohl wir unser ArmorMaterial nirgendwo registrieren müssen, sollte man generell alle Ressourcenschlüssel als Konstanten speichern, da das Spiel diese nutzen wird, um die relevanten Texturen für unsere Rüstung zu finden.

public static final ResourceKey<EquipmentAsset> GUIDITE_ARMOR_MATERIAL_KEY = ResourceKey.create(EquipmentAssets.ROOT_ID, ExampleMod.id("guidite"));

Wir werden dies später an den Konstruktor ArmorMaterial übergeben.

ArmorMaterial Instanz

Um unser Material zu erstellen, müssen wir eine neue Instanz des ArmorMaterial-Record erstellen, wobei die Grundhaltbarkeit und die Konstanten der Material-Registrierungsschlüssel hier verwendet werden.

public static final ArmorMaterial INSTANCE = new ArmorMaterial(
		BASE_DURABILITY,
		Map.of(
				ArmorType.HELMET, 3,
				ArmorType.CHESTPLATE, 8,
				ArmorType.LEGGINGS, 6,
				ArmorType.BOOTS, 3
		),
		5,
		SoundEvents.ARMOR_EQUIP_IRON,
		0.0F,
		0.0F,
		REPAIRS_GUIDITE_ARMOR,
		GUIDITE_ARMOR_MATERIAL_KEY
);

Der ArmorMaterial-Konstruktor akzeptiert die folgenden Parameter, in dieser spezifischen Reihenfolge:

Parameter	Beschreibung
durability	Sie wird bei der Berechnung der Gesamthaltbarkeit jedes einzelnen Rüstungsteils verwendet, das dieses Material verwendet. Dies sollte die Basis-Haltbarkeitskonstante sein, die Sie zuvor erstellt haben.
defense	Eine Map von EquipmentType (eine Aufzählung, die jeden Rüstungsplatz darstellt) zu einem ganzzahligen Wert, der den Verteidigungswert des Materials angibt, wenn es im entsprechenden Rüstungsplatz verwendet wird.
enchantmentValue	Die "Verzauberbarkeit" von Rüstungsitems, die dieses Material verwenden.
equipSound	Ein Registrierungsschlüssel für ein Sound-Event, das abgespielt wird, wenn man eine Rüstung aus diesem Material anlegt. Weitere Informationen zu Sounds findest du auf der Seite Custom Sounds.
toughness	Ein Float-Wert, der das Attribut "Häte" des Rüstungsmaterials darstellt - im Wesentlichen, wie gut die Rüstung Schaden absorbiert.
knockbackResistance	Ein Float-Wert, der den Grad der Rückstoßfestigkeit angibt, den das Rüstungsmaterial dem Träger gewährt.
repairIngredient	Ein Item-Tag, das alle Items repräsentiert, die zur Reparatur von Rüstungsteilen aus diesem Material in einem Amboss verwendet werden können.
assetId	Ein EquipmentAsset-Registrierungsschlüssel; dies sollte die zuvor erstellte Registrierungsschlüsselkonstante Rüstungsasset sein.

Wir definieren die Referenz für die Bestandteile der Reparatur wie folgt:

public static final TagKey<Item> REPAIRS_GUIDITE_ARMOR = TagKey.create(BuiltInRegistries.ITEM.key(), ExampleMod.id("repairs_guidite_armor"));

Um festzulegen, welche Items in einem Amboss zur Reparatur dieses Materials verwendet werden können, erstellen wir ein Tag, das eine Liste von Items enthält. Lasst uns ein neues Tag zu unserer ItemTag-Provider-Klasse hinzufügen:

builder(GuiditeArmorMaterial.REPAIRS_GUIDITE_ARMOR)
		.add(ItemIds.COPPER_INGOT);

In unserem Beispiel werden wir den Kupferbarren als Reparaturmaterial für die Guidite verwenden. Wenn du stattdessen einen benutzerdefinierten Guidite-Barren erstellen möchtest, kannst du ein benutzerdefiniertes Item erstellen und dessen ID zum Tag hinzufügen.

Jetzt kannst du unsere Rüstungen an Ambossen reparieren:

Wenn du Schwierigkeiten hast, die Werte für einen der Parameter zu bestimmen, kannst du die Vanilla-Instanzen von ArmorMaterial zu Rate ziehen, die in dem Interface ArmorMaterials zu finden sind.

Rüstungsitems erstellen

Nachdem du das Material registriert hast, kannst du die Rüstungsitems in deiner Klasse ModItems erstellen:

Natürlich muss ein Rüstungsset nicht jeden Typ abdecken, man kann auch ein Set mit nur Stiefeln oder Hosen etc. haben. - Der Vanille-Schildkrötenpanzerhelm ist ein gutes Beispiel für ein Rüstungsset mit fehlenden Slots.

Im Gegensatz zu ToolMaterial speichert ArmorMaterial keine Informationen über die Haltbarkeit von Items. Aus diesem Grund muss die Grundhaltbarkeit manuell zu den Item.Properties der Rüstungsgegenstände hinzugefügt werden, wenn diese registriert werden.

Dies wird erreicht, indem die Konstante BASE_DURABILITY, die wir zuvor erstellt haben, an die Methode maxDamage in der Klasse Item.Properties übergeben wird.

public static final ResourceKey<Item> GUIDITE_HELMET = create("guidite_helmet");

public static final ResourceKey<Item> GUIDITE_CHESTPLATE = create("guidite_chestplate");

public static final ResourceKey<Item> GUIDITE_LEGGINGS = create("guidite_leggings");

public static final ResourceKey<Item> GUIDITE_BOOTS = create("guidite_boots");

public static final Item GUIDITE_HELMET = register(
		ModItemIds.GUIDITE_HELMET,
		Item::new,
		new Item.Properties().humanoidArmor(GuiditeArmorMaterial.INSTANCE, ArmorType.HELMET)
				.durability(ArmorType.HELMET.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);
public static final Item GUIDITE_CHESTPLATE = register(
		ModItemIds.GUIDITE_CHESTPLATE,
		Item::new,
		new Item.Properties().humanoidArmor(GuiditeArmorMaterial.INSTANCE, ArmorType.CHESTPLATE)
				.durability(ArmorType.CHESTPLATE.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);

public static final Item GUIDITE_LEGGINGS = register(
		ModItemIds.GUIDITE_LEGGINGS,
		Item::new,
		new Item.Properties().humanoidArmor(GuiditeArmorMaterial.INSTANCE, ArmorType.LEGGINGS)
				.durability(ArmorType.LEGGINGS.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);

public static final Item GUIDITE_BOOTS = register(
		ModItemIds.GUIDITE_BOOTS,
		Item::new,
		new Item.Properties().humanoidArmor(GuiditeArmorMaterial.INSTANCE, ArmorType.BOOTS)
				.durability(ArmorType.BOOTS.getDurability(GuiditeArmorMaterial.BASE_DURABILITY))
);

Außerdem musst du die Items einem Kreativtab hinzufügen, wenn du möchtest, dass sie über das Inventar zugänglich sind.

Wie bei allen Items solltest du auch für diese Übersetzungsschlüssel erstellen.

Texturen und Modelle

Benutzerdefinierte Rüstung

Itemtexturen und Modell

Diese Texturen unterscheiden sich nicht von anderen Items - Du musst die Texturen erstellen und ein generisches Itemmodell erstellen, was in der Anleitung Erstellen des ersten Items behandelt wurde.

Als Beispiel dient das folgende Textur- und Modell-JSON als Referenz.

Item Texturen herunterladen

INFO

Du benötigst JSON-Modelldateien für alle Gegenstände, nicht nur für den Helm. Es ist das gleiche Prinzip wie bei anderen Itemmodellen.

{
  "parent": "minecraft:item/generated",
  "textures": {
    "layer0": "example-mod:item/guidite_helmet"
  }
}

Wie du sehen kannst, sollten die Rüstungsitems im Spiel geeignete Modelle haben:

Rüstungstexturen

Wenn eine Entität deine Rüstung trägt, wird nichts angezeigt. Das liegt daran, dass dir die Texturen und die Definitionen der Rüstungsmodelle fehlen.

INFO

Beachte, dass die Rüstungstextur für Baby-Humanoide seit Version 26.1 nicht mehr eine verkleinerte Version der Textur für erwachsene Humanoide ist. Stattdessen handelt es sich um eine Textur, die getrennt bereitgestellt werden muss.

Es gibt drei Schichten für die Rüstungstextur, die vorhanden sein müssen.

Zuvor haben wir eine Konstante ResourceKey<EquipmentAsset> mit dem Namen GUIDITE_ARMOR_MATERIAL_KEY erstellt, die wir an unseren ArmorMaterial-Konstruktor übergeben haben. Es wird empfohlen, die Textur ähnlich zu benennen, in unserem Fall also guidite.png

• assets/example-mod/textures/entity/equipment/humanoid/guidite.png - Enthält Oberkörper- und Stiefeltexturen.
• assets/example-mod/textures/entity/equipment/humanoid_leggings/guidite.png - Enthält Hosentexturen.
• assets/example-mod/textures/entity/equipment/humanoid_baby/guidite.png - Enthält die Textur für den Baby-Humanoid.

Guidite Rüstungsmodell-Texturen herunterladen

Als Nächstes musst du eine Definition für ein zugehöriges Ausrüstungsmodell erstellen. Diese gehören in den Ordner /assets/example-mod/equipment/.

Die Konstante ResourceKey<EquipmentAsset>, die wir zuvor erstellt haben, bestimmt den Namen der JSON-Datei. In diesem Fall wird es guidite.json sein.

Da wir nur "Humanoide" Rüstungsteile (Helm, Brustpanzer, Hose, Stiefel usw.) hinzufügen wollen , werden die Definitionen der Ausrüstungsmodelle wie folgt aussehen:

{
  "layers": {
    "humanoid": [
      {
        "texture": "example-mod:guidite"
      }
    ],
    "humanoid_baby": [
      {
        "texture": "example-mod:guidite"
      }
    ],
    "humanoid_leggings": [
      {
        "texture": "example-mod:guidite"
      }
    ]
  }
}

Wenn die Texturen und die Definition des Rüstungsmodell vorhanden sind, solltest du in der Lage sein, deine Rüstung auf den Entitäten zu sehen, die sie tragen:

Rüstungsitems taggen

VORAUSSETZUNGEN

Weitere Informationen findest du in der Dokumentation zur Erstellung von Item Tags.

Es wird außerdem empfohlen, deine Rüstung in den entsprechenden Item Tags einzuordnen. Rüstungsteile haben eigene Tags, wie beispielsweise ItemTags.CHEST_ARMOR, die für die Verzauberbarkeit verwendet werden.

Füge die folgenden Zeilen zu addTags in deinem Item Tag Provider hinzu:

builder(ItemTags.HEAD_ARMOR)
		.add(ModItemIds.GUIDITE_HELMET);
builder(ItemTags.CHEST_ARMOR)
		.add(ModItemIds.GUIDITE_CHESTPLATE);
builder(ItemTags.LEG_ARMOR)
		.add(ModItemIds.GUIDITE_LEGGINGS);
builder(ItemTags.FOOT_ARMOR)
		.add(ModItemIds.GUIDITE_BOOTS);