CrazyCrates — ein Plugin zum Hinzufügen von benutzerdefinierten Kisten und Belohnungs-Crates in Minecraft

CrazyCrates — ein Plugin zum Hinzufügen von benutzerdefinierten Kisten und Belohnungs-Crates in Minecraft

CrazyCrates ermöglicht es, einem Minecraft-Server Crates hinzuzufügen. Jede Kiste ist ein Block in der Welt oder eine Position im Menü, die der Spieler mit einem Schlüssel öffnet, um einen zufälligen Preis zu erhalten. Das Plugin bietet 11 verschiedene Animationsarten, zwei Arten von Schlüsseln — physische (Items im Inventar) und virtuelle (in der Datenbank gespeichert) — sowie ein gewichtsbasiertes Chancensystem anstelle eines prozentualen Systems. Es wird kostenlos zur Verfügung gestellt. 

Hauptmenü /crates mit Kisten als Items im Inventar 

Kistenarten 

Jede Kiste auf dem Server ist ein separates .yml-File im Ordner crates/. Die Datei enthält den Parameter CrateType, der die Öffnungsanimation bestimmt.

Beim ersten Start generiert das Plugin 6 vorgefertigte Beispiele, die 5 bestätigte Typen abdecken. Du kannst jedes davon ohne Schlüssel mit dem Befehl /crazycrates forceopen <dateiname> <nickname> testen.

Alle verfügbaren Basiskisten 

Scroll - im Inventar erscheint ein horizontales Band von Items, das scrollt, allmählich langsamer wird und auf dem Gewinn-Item in der Mitte stoppt. Dieser Typ wird von zwei Beispielen verwendet — CrateExample.yml und AdvancedExample.yml.

CrateExample Ausführung — ein horizontales Band von Items scrollt und stoppt auf dem Gewinn

Cosmic — im Inventar erscheinen mehrere Preise zur Auswahl. Der Spieler klickt auf den Preis, den er nehmen möchte. Wenn nach 10 Sekunden nichts ausgewählt wird, vergibt das Plugin automatisch einen Preis. Casino — eine Kiste mit Stufen (tiers). Zuerst bestimmt die Animation die Stufe, dann darin — den spezifischen Preis. 

QuadCrate — beim Öffnen spawnen vier physische Kistenblöcke um den Spieler herum in der Welt. Der Spieler nähert sich jedem und öffnet sie nacheinander — jeder gibt einen separaten Preis. 

Wonder — es erscheint ein Fenster mit vollem Inventar, aus dem nach und nach Items verschwinden; das verbleibende Item wird der Preis.

Schlüssel

Jede Kiste verwendet ihren eigenen Schlüssel. Ein physischer Schlüssel ist ein gewöhnliches Item mit individuellem Aussehen, Namen und Beschreibung (Lore), das der Spieler im Inventar hält. Ein virtueller Schlüssel nimmt keinen Platz ein — er wird in der Datenbank des Plugins gespeichert und ist mit dem Account des Spielers verknüpft.

Standardmäßig akzeptiert ein physischer Kistenblock beide Arten. Das Verhalten kann in config.yml für jede Kombination separat geändert werden.

Wenn das Inventar des Spielers beim Erhalt eines Schlüssels voll ist, wandelt das Plugin ihn entweder in einen virtuellen Schlüssel um oder wirft ihn auf den Boden — je nach Einstellungen. Der Versuch, eine Kiste ohne Schlüssel zu öffnen, stößt den Spieler zurück.

Administratoren können Schlüssel vergeben und wegnehmen, selbst bei Offline-Spielern, Schlüssel mit einem Befehl gleichzeitig an alle Online-Spieler verteilen oder einen zufälligen Schlüssel aus allen verfügbaren Kisten vergeben. Spieler mit entsprechender Berechtigung können ihre virtuellen Schlüssel an andere übertragen.

Physischer Schlüssel für eine Kiste — ein Item mit benutzerdefinierter Beschreibung

Chancensystem 

Die Wahrscheinlichkeit für jeden Preis wird nicht durch Prozente, sondern durch Gewicht (Weight-Parameter) in der Kistendatei bestimmt. Je höher das Gewicht, desto öfter fällt der Preis; je niedriger — desto seltener.

Der maximale Bereich ist die Summe aller Gewichte in der Kiste. Wenn drei Preise die Gewichte 10, 15 und 25 haben, ist der Bereich 50. Die Chance des ersten ist 20%, des zweiten — 30%, des dritten — 50%.

Der Vorteil dieses Ansatzes gegenüber Prozenten: Man muss nicht darauf achten, dass die Summe 100 nicht überschreitet. Man kann einfach relative Werte festlegen und neue Preise hinzufügen, ohne den Rest neu zu berechnen.

Befehle

Der Hauptbefehl des Plugins lautet /crazycrates, mit den Aliasen /crates und /cc. Spielern stehen nur /keys (eigene Schlüssel ansehen) und /crates (Menü öffnen) zur Verfügung.

Admin-Befehle:

• /crazycrates give und /crazycrates take — einen Schlüssel an einen bestimmten Spieler geben oder wegnehmen, einschließlich Offline-Spieler.

• /crazycrates giveall — gleichzeitig an alle Online-Spieler einen Schlüssel verteilen.

• /crazycrates forceopen — eine Kiste für einen Spieler kostenlos, ohne Schlüssel, öffnen.

• /crazycrates editor — Kisten-Platzierungsmodus in der Welt: Man zeigt auf einen Block und bindet eine Kiste daran.

• /crazycrates debug — alle Preise einer Kiste auf einmal erhalten, um die Einstellungen zu testen.

• /crazycrates mass-open — massenhaftes Öffnen einer bestimmten Anzahl von Kisten auf einmal.

• /crazycrates reload — alle Konfigurationen ohne Serverneustart neu laden.

• /crazycrates migrate — Kisten aus anderen Plugins importieren oder das veraltete Dateiformat konvertieren.

Die Berechtigungen sind in drei Wildcards unterteilt: crazycrates.players.* für Spieler, crazycrates.admin.* für Admins, crazycrates.schematic.* für das Arbeiten mit Schematics. Ein Spieler kann von einer Massenverteilung /giveall durch eine separate Berechtigung ausgeschlossen werden.

Konfiguration

Alle Plugin-Dateien befinden sich im Ordner plugins/CrazyCrates/. Die wichtigste ist config.yml, wo globale Servereinstellungen konzentriert sind. Kisten werden im Unterordner crates/ gespeichert — jede als separate Datei. Der Ordner examples/ enthält Beispiele der Entwickler, aber du solltest sie nicht bearbeiten: Er wird bei jedem /crazycrates reload vollständig überschrieben. Alle Nachrichtentexte sind in messages.yml ausgelagert und werden separat bearbeitet.

In config.yml solltest du auf ein paar Dinge achten. Hologramme über Kisten erscheinen automatisch, wenn DecentHolograms, FancyHolograms oder CMI auf dem Server installiert ist — das Plugin übernimmt sie selbst. Wenn keines vorhanden ist, wird es einfach keine Hologramme geben. Nachrichten an Spieler können entweder an den Chat oder an die Action Bar gesendet werden — je nachdem, wie der Server eingerichtet ist. Die Protokollierung von Aktionen mit Schlüsseln und Kisten wird separat für die Konsole und die Datei aktiviert; Dateiprotokolle werden beim Neustart in eine Zip-Datei archiviert.

Jede Kiste wird in einer eigenen Datei konfiguriert. Neben der Animationsart und der Preisliste wird dort das Aussehen des physischen Schlüssels, der Hologrammtext über dem Block, die Größe und Gestaltung des Vorschaufensters, die Sounds während des Scrollens und nach Abschluss sowie die Möglichkeit festgelegt, den Preis erneut zu rollen, wenn das Ergebnis nicht zufriedenstellend war.

Fazit

CrazyCrates fügt Animationssysteme sowohl für den Spenden-Shop als auch für den Spiel-Fortschritt im Survival-Modus hinzu. Das gewichtsbasierte Chancensystem ist bei aktivem Bearbeiten bequemer als das prozentuale — man muss nicht jedes Mal die gesamte Liste neu berechnen.

Für PvP- und Survival-Server mit Spenden-System ist CrazyCrates eine gute Wahl. Für einen einfachen Server, auf dem nur eine Kiste ohne Animationen benötigt wird, reichen QuickCrate und eine minimale Konfiguration aus.