Custom Loot Table

Universelles Beuteformat. Wird von EliteMobs an mehreren verschiedenen Stellen verwendet.

Bitte beachte, dass dies das neueste Format ist und dasjenige, dessen Verwendung empfohlen wird, aber es existieren einige alternative ältere Formate.

Hinweis: Die Unterstützung des Legacy-Formats ist mit der durch Doppelpunkte getrennten Syntax weiterhin verfügbar: filename.yml:chance:permission. Für neue Konfigurationen wird jedoch das unten gezeigte moderne Format empfohlen.

In dieser Legacy-Syntax ist die Chance verpflichtend. Ein nacktes filename.yml ohne weitere Angaben droppt das Item zwar weiterhin zu 100 %, protokolliert aber bei jedem Start eine Warnung Failed to parse entry ... due to invalid: chance — bevorzuge daher filename.yml:1.0 oder das moderne Format.

Achte darauf, deine Beutetabellen mit uniqueLootList: zu beginnen, bevor du irgendwelche Einstellungen hinzufügst, andernfalls erzeugt die .yml-Konfiguration einen Fehler.

Elite-Items droppen:

Key	Details	Values	Default
filename	Legt den Dateinamen des zu verwendenden Custom Items fest.	Filename	none

Beispiel

uniqueLootList:
  - filename: magmaguys_toothpick.yml

Dadurch lässt der Mob 1x MagmaGuy's Toothpick mit einer Drop-Chance von 100 % fallen.

Allgemeine Einstellungen:

Key	Details	Values	Default
chance	Legt die Chance fest, dass die Beute droppt, wobei 1.0 100 % entspricht.	Double	1.0
amount	Legt die Menge fest, die von diesem Beuteeintrag gedroppt wird. Wird von Währungseinträgen ignoriert — verwende dafür currencyAmount.	Integer	1
permission	Legt den Permission-Node fest, der erforderlich ist, damit Spieler diese Beute erhalten. Wird von Elite-Item-, Währungs- und Befehlseinträgen unterstützt. Vanilla-Item-Einträge lesen ihn in keinem der beiden Formate aus.	String	none

Beispiel

uniqueLootList:
  - filename: magmaguys_toothpick.yml
    chance: 0.5
    amount: 10
    permission: elitemobs.loot.rare

Dadurch lässt der Mob 10x MagmaGuy's Toothpick mit einer Drop-Chance von 50 % fallen, aber nur für Spieler mit der Permission elitemobs.loot.rare.

Elite-Coins droppen:

Key	Details	Values	Default
currencyAmount	Legt die Menge an Münzen fest, die gedroppt wird.	Integer	none

Beachte, dass der gemeinsame amount-Schlüssel bei Währungseinträgen nichts bewirkt — die Münzauszahlung stammt allein aus currencyAmount. Nur im durch Doppelpunkte getrennten String-Format wird ein Eintrag, der bei einem currencyAmount von 0 landet, mit einer Warnung abgelehnt statt registriert.

Beispiel

uniqueLootList:
  - currencyAmount: 344
    chance: 0.5

Dadurch lässt der Mob 344 Elite Coins mit einer Drop-Chance von 50 % fallen.

Vanilla-Items droppen:

Key	Details	Values	Default
material	Legt das Material des gedroppten Items fest. Akzeptiert Minecraft-Materialnamen (ohne Beachtung der Groß-/Kleinschreibung). Du kannst auch type anstelle von material verwenden.	Material	none

Beispiel

uniqueLootList:
  - material: APPLE
    chance: 0.3
    amount: 5

Dadurch lässt der Mob 5 Äpfel mit einer Drop-Chance von 30 % fallen.

Befehle beim Beute-Drop ausführen:

Du kannst Konsolenbefehle ausführen, wenn Beute droppt. Dies ist nützlich, um mit anderen Plugins zu integrieren oder benutzerdefinierte Belohnungen bereitzustellen. Befehlseinträge verwenden ausschließlich das durch Doppelpunkte getrennte String-Format.

Key	Details	Values	Default
command	Legt den auszuführenden Konsolenbefehl fest. Verwende %player% als Platzhalter für den Namen des Spielers.	String	none

Der Befehl selbst darf weder ein : noch ein zweites = enthalten, weil der Eintrag beim Parsen an beiden Zeichen aufgeteilt wird.

How chance behaves for commands

Befehlseinträge würfeln chance zweimal, und der zweite Wurf ist invertiert, sodass der Befehl tatsächlich in chance × (1 - chance) der Fälle ausgeführt wird:

• chance=1.0 (der Standard, wenn du es weglässt) bedeutet, dass der Befehl überhaupt nie ausgeführt wird.
• chance=0.5 ergibt die höchste erreichbare Rate, 25 %.
• chance=0.9 ergibt 9 %.

Setze bei Befehlseinträgen immer eine explizite chance unter 1.0 und rechne damit, dass die tatsächliche Auslöserate niedriger ist als die von dir geschriebene Zahl.

Beispiel

uniqueLootList:
  - command=give %player% diamond 1:chance=0.5:amount=1:permission=elitemobs.loot.command

Dadurch wird der Befehl give <player> diamond 1 von der Konsole aus ausgeführt, wenn der Mob getötet wird, und zwar in etwa 25 % der Fälle (siehe die Warnung oben). Der Platzhalter %player% wird durch den tatsächlichen Namen des Spielers ersetzt. Nur Spieler mit der Permission elitemobs.loot.command lösen diesen Befehl aus.

Arena-Belohnungen:

Wenn du Arena-Beutetabellen erstellst, achte bitte darauf, deine Beutetabelle mit rawArenaReward: anstatt mit uniqueLootList: zu beginnen.

Key	Details	Values	Default
wave	Legt die Welle fest, bei der dieser Beuteeintrag droppt. Nur für die Verwendung in Arenen. Wird im Map-Format für Vanilla-Item-Einträge unterstützt, aber nur im String-Format für Elite-Item-Einträge (filename).	Integer	-1
itemLevel	Legt das Level des Beute-Drops fest. Nur für die Verwendung in Arenen und wird nur für Elite-Item-Einträge (filename) ausgelesen. Nur im String-Format verfügbar, nicht im Map-Format.	Integer	1

Both of these have traps

• Nur Einträge mit einem wave-Wert von 1 oder höher werden überhaupt als Wellenbelohnungen registriert. Ein Arena-Belohnungseintrag ohne wave wird zwar geparst und akzeptiert, aber keine Welle wird ihn jemals ausgeben.
• itemLevel hat den Standardwert 1, nicht das Arena- oder Spielerlevel. Ein scalable-Elite-Item, das von einer Arena ohne explizites itemLevel vergeben wird, droppt daher als Item auf Level 1.

Beispiel

rawArenaReward:
  - material: BREAD
    wave: 1
    amount: 10
    chance: 0.5
  - filename=magmaguys_toothpick.yml:wave=1:itemLevel=2

Wenn die Spieler die erste Welle besiegen, lässt die Arena dadurch 10 Brot mit einer Drop-Chance von 50 % und 1x MagmaGuy's Toothpick auf Level 2 mit einer Drop-Chance von 100 % fallen.

Beachte, dass der Elite-Item-Eintrag (filename) hier das String-Format verwendet, da wave und itemLevel für Elite-Item-Einträge nur im String-Format ausgewertet werden. Vanilla-Item-Einträge (wie der material: BREAD-Eintrag oben) akzeptieren wave im Map-Format.

Instanced Dungeons:

Key	Details	Values	Default
difficultyID	Legt fest, für welchen Schwierigkeitsgrad eines Instanced Dungeons diese Beute droppt. Nur für die Verwendung in Instanced Dungeons.	String	none

difficultyID wird nur für Elite-Item-Einträge (filename) im unten gezeigten Map-Format ausgelesen. Es wird im durch Doppelpunkte getrennten String-Format nicht geparst und für Vanilla-, Währungs- oder Befehlseinträge nicht gelesen.

Es wirkt außerdem nur auf Custom-Boss-Beute. Beute aus Schatztruhen, Quests und Arenen wertet es nie aus.

Innerhalb eines Instanced Dungeons verhält sich der Eintrag wie folgt:

• Der Dungeon-Schwierigkeitsgrad passt zur difficultyID: Das Item wandert in die gemeinsame Gruppen-Beutetabelle des Bosses, statt direkt an den Killer ausgegeben zu werden, sodass die ganze Gruppe daraus wählen kann.
• Der Dungeon-Schwierigkeitsgrad passt nicht: Der Eintrag wird übersprungen.
• Der Spieler befindet sich überhaupt nicht in einem Instanced Dungeon: Die difficultyID wird ignoriert und das Item droppt normal.

Beispiel

uniqueLootList:
  - filename: magmaguys_toothpick.yml
    chance: 0.5
    difficultyID: 1

Dadurch lässt der Mob 1x MagmaGuy's Toothpick mit einer Drop-Chance von 50 % fallen, wenn die Spieler den Boss auf Schwierigkeitsgrad 1 besiegt haben.