Gegenstände erstellen

Benutzerdefinierte Gegenstände erstellen

Was sind benutzerdefinierte Gegenstände?

Benutzerdefinierte Gegenstände sind Gegenstände, wie sie von EliteMobs über Konfigurationsdateien definiert werden. Du kannst mehrere Aspekte dieser Gegenstände anpassen, wie das Level des Gegenstands, die Verzauberungen, den Namen, die Lore, die Textur und mehr!

Webapp

Du kannst benutzerdefinierte Beute einfach und schnell hier erstellen!

Bevor du beginnst

Wohin kommen benutzerdefinierte Gegenstände?

Dateien für benutzerdefinierte Gegenstände kommen in den Konfigurationsordner ~/plugins/EliteMobs/customitems

Es ist möglich, Unterordner zu erstellen, wie ~/plugins/EliteMobs/customitems/myitems. Dies wird empfohlen, um die Dinge organisiert zu halten.

Dateien werden im .yml-Dateiformat gespeichert, und Notepad++ ist die empfohlene Software zur Dateibearbeitung für Konfigurationsarbeiten. Eine Datei definiert einen Boss, obwohl es möglich ist, denselben Boss mehrmals zu spawnen und sogar mehrere Spawn-Orte für dieselbe Boss-Datei festzulegen.

Es ist möglich, die Webapp zu verwenden, um schnell und einfach benutzerdefinierte Bosse und mehr zu erstellen.

Kleinstmögliche Konfiguration

Bitte beachte, dass die kleinstmögliche Konfigurationsdatei für einen benutzerdefinierten Gegenstand wie folgt aussieht:

Beachte, dass dies nur eine leere Datei ist. Dies fällt standardmäßig auf ein Holzschwert namens "Default name" zurück. Alles auf dieser Seite ist optional!

Beispiel-Gegenstand

Werfen wir einen Blick auf ein Beispiel dafür, wie eine Gegenstandsdatei aussieht.

Beispiel

isEnabled: true
material: WOODEN_AXE
name: '&4Test item'
lore:
- This is a cool item
- It has cool lore
enchantments:
- DAMAGE_ALL,4
- FLAMETHROWER,1
potionEffects:
- FAST_DIGGING,0,self,onHit
- POISON,0,target,onHit
- GLOWING,0,self,continuous
dropWeight: dynamic
scalability: scalable
itemType: custom

Einstellungen für benutzerdefinierte Gegenstände

Im Folgenden findest du eine Liste aller Dinge, die du für benutzerdefinierte Gegenstände konfigurieren kannst:

---

isEnabled

Legt fest, ob der Gegenstand aktiviert ist. Wirkt sich nicht auf bereits generierte Gegenstände aus.

Key	Werte	Standard
isEnabled	true / false	true

Beispiel

isEnabled: true

---

material

Legt das Material des Gegenstands fest.

Key	Werte	Standard
material	Wähle aus dieser Liste!	WOODEN_SWORD

Beispiel

material: DIAMOND_SWORD

---

level

Legt das Level des Gegenstands fest.

Key	Werte	Standard
level	Integer	0

Beachte, dass diese Einstellung nicht relevant ist, wenn du die scalability des Gegenstands auf scalable setzt. Wenn du sie auf limited setzt, ist dies das höchstmögliche Level des Gegenstands.

Außerdem haben Materialien ein Mindestlevel. Eisenmaterialien sind Level 6, Diamantmaterialien sind Level 7. Du kannst Gegenstände nicht auf ein niedrigeres Level als das Level des Materials zwingen.

Beispiel

level: 100

---

name

Legt den Anzeigenamen des Gegenstands fest.

Key	Werte	Standard
name	String mit color codes	"Default name"

Beispiel

name: "&2Cool item"

---

lore

Legt die Lore des Gegenstands fest.

Key	Werte	Standard
lore	Liste mit color codes	keiner

Beispiel

lore:
- "&2This is the coolest sword"
- "&2of all time!"

---

enchantments

Legt die Verzauberungen des Gegenstands fest.

Key	Werte	Standard
enchantments	Liste mit Minecraft-Verzauberungen oder benutzerdefinierten EliteMobs-Verzauberungen	keiner

Beachte, dass diese Einträge dem Format enchantmentName:enchantmentLevel folgen. Sieh dir das Beispiel unten an!

Beispiel

enchantments: 
- "DAMAGE_UNDEAD,8"
- "DURABILITY,4"
- "DAMAGE_ALL,7"
- "LOUD_STRIKES,3"

Beachte außerdem, dass Verzauberungen wie Schärfe standardmäßig zu Elite-Schärfe werden, wenn das Level die Grenzen von Vanilla-Minecraft überschreitet.

---

potionEffects

Legt die Trankeffekte fest, die der Gegenstand haben wird. Diese können auf den Spieler oder auf eine vom Spieler beschädigte Entität angewendet werden.

Key	Werte	Standard
potionEffects	Liste mit Minecraft-Trankeffekten	keiner

Außerdem verwenden Trankeffekte ein bestimmtes Format, das es Administratoren ermöglicht, auszuwählen, wer betroffen ist und wann:

Einstellung	Beschreibung	Werte	Standard
Trankeffektlevel	Legt das Level des Trankeffekts fest. Trankeffekte beginnen bei Level 0!	Integer	keiner
Betroffene Entität	Legt fest, wer vom Trankeffekt betroffen ist.	self (der Spieler) / target (die getroffene Entität)	keiner
Anwendungsmethode	Legt fest, wann der Trankeffekt angewendet wird.	onHit / continuous (wendet ständig erneut an)	keiner

Das Format für Trankeffekte ist potionEffectName,potionEffectLevel,affectedEntity,applicationMethod. Die letzten beiden Parameter (affectedEntity und applicationMethod) sind optional und fallen standardmäßig auf self und continuous zurück, wenn nicht angegeben. Sieh dir das Beispiel unten an!

Trankeffekt-Dauern:

• Kontinuierliche Effekte werden jede Sekunde aufgefrischt, während der Gegenstand gehalten oder ausgerüstet wird (jede Anwendung hält 2 Sekunden, sodass der Effekt nie ausläuft)
• Nachtsicht erhält eine besondere Dauer von 15 Sekunden
• On-Hit-Effekte verwenden Dauern basierend auf der Serverkonfiguration

Wenn du einen Gegenstand mit Trankeffekten untersuchst, siehst du Symbole, die angeben, wie der Effekt angewendet wird:

• ☠️ Totenkopf – Zielt auf Feinde.
• 🛡️ Schild – Zielt auf den Benutzer/Spieler.
• ⚔️ Schwerter – Aktiviert sich bei Treffer.
• 🔄 Wiederholungskreis – Wird kontinuierlich angewendet, während der Gegenstand getragen oder gehalten wird.

EliteMobs verfügt auch über benutzerdefinierte Gegenstände, die als Amulette funktionieren. Diese Gegenstände tun nichts anderes, als dem Spieler Trankeffekte zu verleihen, während der Gegenstand gehalten oder in einem Slot ausgerüstet wird.

WARNUNG: Die Verwendung des Trankeffekts INSTANT_DAMAGE heilt untote Mobs beim Aufprall, da dies eine Standardmechanik in Vanilla-Minecraft ist.

Beispiel

potionEffects: 
- "POISON,0,target,onHit"
- "HEAL,1,self,onHit"
- "NIGHT_VISION,0,self,continuous"

Mit diesem Satz von Trankeffekten passiert Folgendes:

Bei Treffer wird der Gift-Trankeffekt (Level 1) auf die Entität angewendet, die vom Spieler getroffen wurde. Zusätzlich wird der Spieler von einem Level-2-Sofortheilungs-Trankeffekt betroffen.

Kontinuierlich erhält der Spieler Nachtsicht. Das bedeutet, dass der Spieler Nachtsicht hat, solange er den Gegenstand trägt oder hält.

---

scalability

Legt fest, wie das Level des Gegenstands mit dem Level des Bosses wächst, der ihn fallen lässt.

Key	Werte	Standard
scalability	fixed, limited oder scalable. Sieh unten!	scalable

Sieh dir diese Liste an, um zu verstehen, was die verschiedenen Optionen bewirken!

Einstellung	Beschreibung
fixed	Das Level des Gegenstands ist immer das in der Konfigurationsdatei festgelegte Level.
limited	Das maximale Gegenstandslevel wird durch das in der Konfigurationsdatei festgelegte oder das Level des Bosses begrenzt, je nachdem, welches niedriger ist.
scalable	Das Level des Gegenstands basiert vollständig auf dem Level des Bosses, der ihn fallen lässt.

Beachte, dass Gegenstände mit einem dropWeight immer eine fixed-Skalierbarkeit haben.

Beispiel

scalability: "scalable"

---

itemType

Legt fest, woher du den Gegenstand beziehen kannst.

Key	Werte	Standard
itemType	custom, unique oder droppable. Sieh unten!	custom

Es gibt drei Gegenstandstypen:

Einstellung	Beschreibung
custom	Der Gegenstand kann von jedem EliteMobs-Mob fallen gelassen werden, der Beute fallen lassen kann, und ist im benutzerdefinierten Shop.
unique	Der Gegenstand wird von keinem Boss fallen gelassen und ist nicht im benutzerdefinierten Shop. Die einzige Möglichkeit, ihn zu erhalten, besteht darin, einen benutzerdefinierten Boss so zu konfigurieren, dass er ihn über seine uniqueLootList fallen lässt!
droppable	Der Gegenstand gelangt genau wie custom in den zufälligen Elite-Drop-Pool, ist aber von Shops ausgeschlossen — Spieler können ihn als normalen Elite-Drop finden, aber niemals einfach kaufen. Nützlich für Gegenstände, die sich verdient anfühlen sollen, aber nicht an einen bestimmten Boss gebunden sein müssen.

Beispiel

itemType: "unique"

---

dropWeight

Legt die Loot-Tabelle fest, in die der Gegenstand passt.

Key	Werte	Standard
dropWeight	dynamic oder ein Double-Wert.	dynamic

EliteMobs hat 5 verschiedene Loot-Tabellen für benutzerdefinierte Gegenstände, ausgenommen diejenigen, die direkt konfiguriert werden, wie die uniqueLootList bei benutzerdefinierten Bossen.

Diese sind wie folgt:

Loot-Tabelle	Beschreibung	Standardgewicht
Prozedural generierte Gegenstände	Gegenstände, die zufällig basierend auf Server-Konfigurationsdateien generiert werden	90.0
Gewichtete Gegenstände	Gegenstände, die ein anderes Gewicht als dynamic haben	1.0
Feste Gegenstände	Gegenstände, die eine feste Skalierbarkeit haben	10.0
Begrenzte Gegenstände	Gegenstände, die eine begrenzte Skalierbarkeit haben	3.0
Skalierbare Gegenstände	Gegenstände, die skalierbar sind	6.0

Wenn ein Boss stirbt, wird ein Gegenstand aus diesen Tabellen basierend auf der Konfigurationsdatei ItemSettings.yml ausgewählt. Die Standardwerte für die Gewichte sind oben unter Standardgewicht aufgeführt. Je höher das Gewicht, desto wahrscheinlicher fällt ein Gegenstand.

Gewichtete Gegenstände haben ein kleines Standardgewicht, was bedeutet, dass sie nicht sehr oft fallen. Gegenstände mit einem dropWeight, das nicht dynamic ist, sollen selten sein und werden nur in den Standardwerten für die Amulette verwendet, die Bosse fallen lassen - Gegenstände, die nicht direkt für den Kampf verwendet werden, sondern um Spieler mit Trankeffekten zu verstärken.

Das dropWeight, das du hier festlegst, legt die Chance fest, dass ein bestimmter gewichteter Gegenstand aus der Liste der gewichteten Gegenstände fällt. Es erhöht nicht die Chance, dass gewichtete Gegenstände fallen.

Wenn du verwirrt bist und einfach nur Waffen und Rüstung erstellen möchtest, überspringe diese Einstellung, da sie korrekt standardmäßig auf dynamic gesetzt ist.

Gewichtete Gegenstände haben in der Regel ein Gewicht von 1.0.

Beispiel

dropWeight: "dynamic"

---

customModelID

Hinweis: Diese Einstellung wurde entfernt. Sie wird nicht mehr aus Konfigurationsdateien ausgelesen. Verwende stattdessen customModelV2, die einzige Modell-ID-Einstellung, die seit Minecraft 1.21.4+ (EliteMobs 9.1.13+) erkannt wird. Alle vorhandenen customModelID-Einträge in deinen Konfigurationsdateien werden ignoriert.

Legt die Textur des Gegenstands fest. Erfordert die Verwendung einer gültigen Textur aus dem Resource-Pack!

Key	Werte	Standard
customModelID	Integer	keiner

Beispiel (nicht mehr funktionsfähig)

material: DIAMOND_SWORD
customModelID: 1

Diese Einstellung funktioniert nicht mehr. Migriere stattdessen zu customModelV2.

---

customModelV2

Ab Minecraft-Version 1.21.4 (EM 9.1.13) ist dies die neue erforderliche Einstellung zum Konfigurieren benutzerdefinierter Gegenstands-Modell-IDs. Legt die Textur des Gegenstands fest. Erfordert die Verwendung einer gültigen Textur aus dem Resource-Pack!

Key	Werte	Standard
customModelV2	String	keiner

Beispiel

customModelV2: elitemobs:equipment/magmaguys_toothpick

Diese Einstellung weist einem Gegenstand eine bestimmte Textur zu. So funktioniert es:

• elitemobs: ist das Hauptverzeichnis im Ordner assets des Resource-Packs.
• equipment ist ein Unterverzeichnis innerhalb von assets/elitemobs/models.
• magmaguys_toothpick ist die Modelldatei, die sich in assets/elitemobs/models/equipment im Resource-Pack befindet.

Der vollständige Pfad zur Modelldatei in diesem Beispiel wäre: \.minecraft\resourcepacks\elitemobs_resource_pack\assets\elitemobs\models\equipment\magmaguys_toothpick.json

Dies verwendet die benutzerdefinierte Textur magmaguys_toothpick aus dem EliteMobs-Resource-Pack, das der Spieler verwendet. Es wird empfohlen, deinen Server so einzurichten, dass er den Spielern beim Anmelden Resource-Packs gibt, wenn du dieses Feature korrekt verwenden möchtest.

---

equipmentModelID

Legt ein separates Modell für den Gegenstand fest, wenn er ausgerüstet oder getragen wird. Erfordert die Verwendung einer gültigen Textur aus dem Resource-Pack!

Key	Werte	Standard
equipmentModelID	String	keiner

Beispiel

equipmentModelID: elitemobs:equipment/helmet_texture

Dies legt eine bestimmte Textur fest, die erscheint, wenn der Gegenstand getragen wird, getrennt vom Inventar-Erscheinungsbild des Gegenstands.

---

scriptedItem

Verknüpft den Gegenstand mit einem FreeMinecraftModels-Skript-Gegenstand. Wenn gesetzt, erhält der Gegenstand das 3D-Modell und das Lua-Skript-Verhalten von FMM, während alle Namens-, Lore-, Verzauberungs-, Level- und Seelenbindungssysteme von EliteMobs beibehalten werden.

Dies erfordert, dass FreeMinecraftModels auf dem Server installiert ist. Wenn FMM nicht installiert ist, wird diese Einstellung stillschweigend ignoriert und der Gegenstand funktioniert normal ohne Modell oder Skript.

Der Wert ist die FMM-Gegenstands-ID — der Dateiname der YML-Konfiguration des Modells im models-Ordner von FMM, ohne die Endung .yml. Wenn FMM beispielsweise eine Modell-Konfiguration unter plugins/FreeMinecraftModels/models/flame_blade.yml mit material: IRON_SWORD und scripts: [flame_blade.lua] hat, würdest du sie als flame_blade referenzieren.

Wenn scriptedItem gesetzt ist, hat es Vorrang vor customModelV2 und equipmentModelID — EliteMobs überspringt sein eigenes Modellsystem und verwendet stattdessen das Modell von FMM.

Key	Werte	Standard
scriptedItem	String (FMM-Gegenstands-ID)	keiner

Beispiel

material: IRON_SWORD
name: "&cFlame Blade"
lore:
- "&7Burns with eternal fire"
enchantments:
- "FIRE_ASPECT,2"
- "DAMAGE_ALL,5"
scalability: scalable
scriptedItem: flame_blade

In diesem Beispiel:

• EliteMobs steuert den Gegenstandsnamen, die Lore, die Verzauberungen, die Level-Skalierung und das Seelenbindungsverhalten
• FMM stellt das 3D-Gegenstandsmodell bereit und führt das Skript flame_blade.lua aus (z. B. Partikeleffekte beim Ausrüsten, benutzerdefiniertes Angriffsverhalten)
• Das material: IRON_SWORD wird von EliteMobs als Basis-Gegenstandstyp verwendet

---

showSource

Legt fest, ob der Gegenstand seine Quellen- oder Herkunftsinformationen in der Lore anzeigt.

Key	Werte	Standard
showSource	Boolean	true

Beispiel

showSource: false

Wenn dies auf false gesetzt ist, zeigt der Gegenstand nicht an, woher er stammt.

---

permission

Legt die Berechtigung fest, die erforderlich ist, um den Gegenstand zu erhalten.

Key	Werte	Standard
permission	String	keiner

Du benötigst ein Plugin zur Berechtigungsverwaltung, um Spielern Berechtigungen zu geben. Dies funktioniert nur korrekt, wenn du die Seelenbindungs-Verzauberung nicht deaktiviert hast.

Beispiel

permission: "elitemobs.cool.permission"

Mit diesem Setup können nur Spieler mit der Berechtigung elitemobs.cool.permission diesen Gegenstand erhalten.

---

soulbound

Legt fest, ob der Gegenstand beim Drop seelengebunden sein soll.

Key	Werte	Standard
soulbound	Boolean	true

Beispiel

soulbound: true