Schatztruhen erstellen

Schatztruhen ermöglichen Admins, Truhen zu erstellen, die Beute ausgeben oder einen feindlichen Mimic-Boss spawnen. Lege ihre Konfigurationsdateien in plugins/EliteMobs/customtreasurechests ab.

Deaktivierte Truhen werden vollständig übersprungen: Sie werden nicht in der Welt platziert und weder von /em place treasureChest angeboten noch akzeptiert. Setze isEnabled auf true, bevor du die Truhe platzierst.

Werte

isEnabled

Legt fest, ob eine Schatztruhe aktiviert ist.

Schlüssel	Werte	Standard
isEnabled	Boolean	true

Eine Datei ohne diesen Schlüssel wird als aktiviert geladen. Deaktivierte Truhen werden vollständig übersprungen: Sie werden nicht in der Welt platziert und von /em place treasureChest weder angeboten noch akzeptiert.

Beispiel

isEnabled: true

---

chestType

Legt das Blockmaterial fest. Verwende einen ausrichtbaren Behälter wie CHEST oder BARREL. Diese Einstellung füllt kein normales Inventar; bei der Interaktion stammt die Beute aus lootList.

Schlüssel	Werte	Standard
chestType	Material	CHEST

Beispiel

chestType: CHEST

Verwende ein gültiges Behältermaterial wie CHEST oder BARREL.

---

facing

Legt die Ausrichtung der Truhe fest.

Schlüssel	Werte	Standard
facing	Besonderheit [1]	NORTH

Beispiel

facing: NORTH

Gültige Richtungen sind NORTH, SOUTH, EAST und WEST.

Besonderheit [1]

Tabelle aufklappen

Ausrichtung
NORTH
SOUTH
WEST
EAST

---

dropStyle

Legt fest, ob die Truhe insgesamt verbraucht wird oder einen Cooldown je Spieler verwendet.

SINGLE-Truhen werden vom ersten Spieler verbraucht, der mit ihnen interagiert: Der Block wird durch Luft ersetzt, eine Wiederauffüllfrist gespeichert und nach restockTimer Minuten wieder platziert, sobald sein Chunk geladen ist. Es gibt keine spielerbezogene Auswahl; wer zuerst kommt, erhält die gesamte Truhe. Linksklick und Rechtsklick können Schatztruhen auslösen.

GROUP-Truhen werden nie aus der Welt entfernt. Stattdessen erhält jeder Spieler einen eigenen Cooldown. Außerhalb von Instanzen teilen alle Platzierungen aus derselben Konfigurationsdatei den Cooldown dieses Spielers über restockTimers. Verwende separate Dateien, wenn Platzierungen unabhängig lootbar sein sollen. In einer Instanz führt jede Laufzeittruhe ihre eigene Spielersperrliste.

Beide Modi vergeben persönliche Beute an den interagierenden Spieler. GROUP startet keine Gruppenabstimmung und belohnt nicht alle Spieler in der Nähe. Bereits von anderen Plugins abgebrochene Interaktionen werden ignoriert; normales Abbauen wird verhindert. Zum Öffnen ist kein Gildenrang erforderlich.

Schlüssel	Werte	Standard
dropStyle	SINGLE / GROUP	SINGLE

Beispiel

dropStyle: SINGLE

---

lootList

Listet die mögliche Beute auf.

Jeder zulässige Eintrag würfelt unabhängig, sodass eine Öffnung mehrere Belohnungen liefern kann. Berechtigungen, Mengen und passende Dungeon-Schwierigkeitsfilter gelten weiterhin. putLootDirectlyIntoPlayerInventory in ItemSettings.yml bestimmt, ob Gegenstände ins Inventar oder an der Truhe auf den Boden gelangen. Elite-Gegenstände, die nicht ins Inventar passen, fallen beim Spieler zu Boden und werden ihm als Besitzer zugeordnet.

Schlüssel	Werte	Standard
lootList	EM-Beutetabelle	Keine

Beispiel

lootList:
- filename=elite_scrap_tiny.yml:chance=0.90
- filename=magmaguys_toothpick.yml:chance=1.0

Liefert kein Eintrag erfolgreich eine Belohnung, erhält der Spieler treasureChestNoDropMessage aus config.yml. Das gilt für erfolglose Würfe und Einträge, die keine Belohnung erzeugen können. Der Cooldown wird trotzdem verbraucht.

---

mimicChance

Legt die Chance auf einen feindlichen Boss anstelle der Beute fest. Bei jeder zulässigen Interaktion wird vor der Beuteerzeugung gewürfelt. Ein Erfolg versucht, den Mimic zu erzeugen; es gibt nicht gleichzeitig Beute. Verwende einen Wert zwischen 0 und 1, etwa 0.5 für 50 %. Der Cooldown wird auch verbraucht, wenn der gewählte Boss fehlt oder nicht spawnen kann.

Schlüssel	Werte	Standard
mimicChance	Double	0

Beispiel

mimicChance: 0.5

---

mimicCustomBossesList

Listet die verfügbaren feindlichen Bosse auf. Daraus wird ein Boss zufällig gewählt.

Mit Gewichten kannst du bestimmte Bosse häufiger auswählen lassen.

Schlüssel	Werte	Standard
mimicCustomBossesList	Zeichenkettenliste	Keine

Beispiel

mimicCustomBossesList:
- my_cool_mimic_boss.yml
- weak_mimic_boss.yml

Verwende für Gewichte dieses Format:

mimicCustomBossesList:
- my_cool_mimic_boss.yml:60
- weak_mimic_boss.yml:40

Hier wird my_cool_mimic_boss.yml häufiger ausgewählt als weak_mimic_boss.yml.

Fehlt ein Gewicht oder lässt es sich nicht als Zahl lesen, gilt 1.

Verwende unterschiedliche Dateinamen und endliche, positive Gewichte. Ein wiederholter Dateiname ersetzt sein bisheriges Gewicht, statt einen weiteren Eintrag hinzuzufügen. Negative oder nicht endliche Gewichte werden nicht geprüft. Die Bosse müssen aktiviert sein und spawnen können.

Mit welcher Stufe erscheint der Mimic?

Die Bossdatei bestimmt die Berechnung. Feste numerische Bossstufen werden durch die Berechnung anhand der Truhenstufe ersetzt:

level des Mimic-Bosses	Spawnstufe
Feste Zahl	chestTier × 10 plus zufällig 0–10
dynamic (-1) in einem dynamischen Dungeon	Gewählte Dungeon-Stufe, ±1
dynamic (-1) an anderen Orten	Natürliche Spawnstufe des öffnenden Spielers, ±1

Fehlt die Bossdatei, erscheint kein Mimic und eine Warnung wird protokolliert. Der Spieler erhält auch keine Ersatzbeute.

Die ±1-Berechnungen ergeben mindestens Stufe 1. Fehlen außerhalb eines dynamischen Dungeons die Inventardaten des Spielers, verwendet der dynamische Mimic den normalen Spawnablauf des Bosses. In Dungeons erzeugte Mimics gehören zur jeweiligen Begegnung.

---

restockTimer

Legt die Wartezeit bis zum Wiederauffüllen in Minuten fest.

Schlüssel	Werte	Standard
restockTimer	Ganzzahl	0

Außerhalb von Instanzen stellt SINGLE den Block nach diesem Zeitraum in einem geladenen Chunk wieder her. Bei GROUP gilt der Zeitraum je Spieler. Die Fristen überstehen Neustarts. Die Besonderheiten für Instanzen stehen unter instanced.

Mit dem Standardwert 0 gibt es praktisch keinen Cooldown; die Truhe lässt sich wiederholt plündern. Wähle für wertvolle Beute einen positiven Zeitraum.

Beispiel

restockTimer: 30

---

effects

Die Einstellung hat derzeit keine Wirkung. Der Konfigurationslader liest sie, aber die Schatztruhe verwendet ihren Wert nicht. Sie erzeugt keine Partikel.

Erzeuge gewünschte Partikel vorerst über eine andere Quelle.

Schlüssel	Werte	Standard
effects	Zeichenkettenliste	Keine

---

locations

Legt die Standorte der Schatztruhen fest.

Führe /em place treasureChest <treasurechestfilename.yml> am gewünschten Block aus. Dafür sind ein Spieler mit elitemobs.place.admin und eine geladene, aktivierte Truhenkonfiguration nötig. Der Befehl speichert die Blockkoordinaten in der Datei und platziert die Truhe sofort. Führst du ihn an einem bereits eingetragenen Block aus, wird die Wiederauffüllfrist dieser Platzierung zurückgesetzt, statt einen zweiten Eintrag hinzuzufügen.

Schlüssel	Werte	Standard
locations	Zeichenkettenliste	Keine

Einträge verwenden worldName,x,y,z,yaw,pitch. Auch worldName,x,y,z ist möglich; yaw und pitch sind dann 0.

Der optionale Suffix :unixTimestamp speichert die Wiederauffüllfrist dieser Platzierung in Unix-Sekunden. EliteMobs schreibt ihn beim Plündern einer SINGLE-Truhe. Stoppe den Server, bevor du ihn manuell entfernst. Die Änderung wirkt beim Laden der Konfiguration und setzt keine bereits aktive Truhe zurück.

Eine Datei kann mehrere Standorte enthalten. SINGLE-Platzierungen haben unabhängige Fristen; GROUP-Platzierungen außerhalb von Instanzen teilen die Cooldown-Liste je Spieler.

Koordinaten mit Nachkommastellen werden auf den Block abgerundet, in dem sie liegen. Kombiniere das alte location nicht mit locations: Der Lader bevorzugt location, während Fristen in eine nicht leere locations-Liste geschrieben werden. Das Entfernen einer Truhe mit /em remove löscht nur die angeklickte Platzierung aus der Datei und lässt die übrigen Platzierungen bestehen.

Beispiel

locations:
- my_world,10,50,10,0,0
- my_nether_world,12,58,12,0,0
- my_world,80,64,-30,0,0:1707394380

---

chestTier

Legt die Truhenstufe fest. Der Ausgangswert für die Beutestufe ist chestTier * 10.

Schlüssel	Werte	Standard
chestTier	Ganzzahl	0

Die Wirkung hängt vom Standort und der Art des Gegenstands ab:

Situation	Übergebene Beutestufe
Außerhalb aller Instanzen	scalable-Elite-Gegenstände verwenden die natürliche Spawnstufe des öffnenden Spielers, ±1. Alles andere verwendet chestTier * 10.
In einem dynamischen Dungeon	Die gewählte Dungeon-Stufe gilt für alles, bei scalable-Elite-Gegenständen mit ±1. chestTier wird ignoriert.
In einer anderen Instanz	chestTier * 10 für alles.

Diese Stufen werden an die Gegenstandserzeugung übergeben. fixed-Gegenstände behalten ihre definierten Werte und limited-Gegenstände beachten ihre konfigurierte Obergrenze. Die Truhe ersetzt diese Skalierungsregeln nicht. In einer normalen Survival-Welt folgen scalable-Gegenstände dem öffnenden Spieler. Mimics verwenden eine andere Formel, siehe mimicCustomBossesList.

Die ±1-Berechnungen ergeben mindestens Stufe 1. Fehlen außerhalb einer Instanz die Inventardaten des Spielers, gilt chestTier * 10.

Der Standardwert 0 ergibt die Ausgangsstufe 0.

Beispiel

chestTier: 3

---

instanced

Legt fest, ob die Truhe zu einer Instanz gehört. Nach dem Plündern wird kein normales Wiederauffüllen geplant: SINGLE entfernt den Block und GROUP erlaubt jedem Spieler diese Truhe einmal. Gleichzeitige Instanzen haben getrennte Zustände.

Bei SINGLE gibt es eine Einschränkung: Entladen und erneutes Laden des Chunks plant anhand der aktuellen Frist erneut das Wiederauffüllen. Die Truhe kann nach diesem Zeitpunkt in derselben Instanz wieder erscheinen. Verwende GROUP, wenn die Beschränkung auf eine Öffnung je Spieler während der gesamten Instanz gelten soll.

DIESEN WERT NICHT MANUELL SETZEN.

Schlüssel	Werte	Standard
instanced	Boolean	false

Beispiel

instanced: true

---

restockTime

Das Plugin schreibt diesen Schlüssel nach dem Plündern zur Speicherung der Wiederauffüllfrist.

Er gehört zum alten Format mit einem einzelnen location-Eintrag statt der Liste locations. Sobald locations Einträge enthält, wird die Frist als :unixTimestamp am passenden Listeneintrag gespeichert; dieser Schlüssel bleibt unverändert.

DIESEN WERT NICHT MANUELL SETZEN.

Schlüssel	Werte	Standard
restockTime	Unix-Zeitstempel in Sekunden	0

Beispiel

restockTime: 1707394380

---

restockTimers

Speichert die Cooldowns je Spieler für GROUP. Das Plugin schreibt diese Liste automatisch, wenn ein Spieler die Truhe plündert, und entfernt bei jedem Schreiben abgelaufene Einträge. Der Cooldown wird gespeichert, bevor Beute ausgegeben wird; schlägt das Speichern fehl, wird der Spieler gebeten, es später erneut zu versuchen, und erhält nichts.

Instanztruhen verwenden diese Liste nicht. Ihre Spielersperre bleibt nur für die Lebensdauer der Instanz im Speicher.

DIESEN WERT NICHT MANUELL SETZEN.

Schlüssel	Werte	Standard
restockTimers	Zeichenkettenliste	Keine

Beispiel

restockTimers:
- '12345678-abcd-4ef0-8123-123456789012:1707394380'
- '09876543-abcd-4ef0-8123-098765432109:1707395000'

Jeder Eintrag enthält eine Spieler-UUID und einen Unix-Zeitstempel in Sekunden, getrennt durch einen Doppelpunkt.

---

Beispiel einer Schatztruhenkonfiguration

isEnabled: true
chestType: CHEST
facing: NORTH
chestTier: 3
dropStyle: GROUP
lootList:
- filename=elite_scrap_tiny.yml:chance=0.90
- filename=magmaguys_toothpick.yml:chance=0.95
mimicChance: 0.50
mimicCustomBossesList:
- balrog.yml
- killer_rabbit_of_caerbannog.yml
restockTimer: 1
locations:
- world,0.0,-60.0,-14.0,0.0,0.0

Jeder Beuteeintrag verwendet oben filename=. Ohne dieses Präfix würde magmaguys_toothpick.yml:chance=0.95 als altes Format filename.yml:chance gelesen. Da chance=0.95 keine Zahl ist, würde bei jedem Start eine Warnung zur Auswertung erscheinen.