Minecraft-Plugin ExcellentCrates

🔌 Über ExcellentCrates

ExcellentCrates ist ein Minecraft-Plugin für Spigot/Paper-Server, das ein voll ausgestattetes Crates- (Lootbox-) System implementiert. Der Fokus liegt auf konfigurierbaren Crate-Typen, Key-Verwaltung (virtuell und physisch) und flexiblen Belohnungsdefinitionen, die Server-Administratoren hauptsächlich über einen Ingame-GUI-Editor verwalten können.

🎯 Zweck

Das Plugin löst das Problem, Crate-basierte Belohnungen auf einem Server zu erstellen, zu konfigurieren und darzustellen, ohne dass manuelle Dateiänderungen nötig sind. Es richtet sich an Server-Besitzer und Administratoren, die Belohnungs-Crates für Events, tägliche Belohnungen, monetarisierte Funktionen oder den Spielfortschritt einsetzen möchten, während Konfiguration und Vorschauen im Spiel zugänglich bleiben.

⚙️ Funktionen

• Ingame-GUI-Editor zum Erstellen und Verwalten von Crates, Keys und Belohnungen.
• Unterstützung für physische und virtuelle Keys (virtuelle Keys verhindern Handel/Weitergabe).
• Integrierte Hologramme und Partikeleffekte für Crate-Blöcke (für einige Hologramm-Funktionen können optionale Plugins erforderlich sein).
• Crate Blocks: Verknüpfe Crates mit physischen Blöcken/Zonen für Interaktionen in der Welt.
• Eigene Vorschau-GUIs und eigene Öffnungs-GUIs pro Crate.
• Belohnungstypen: Item-Belohnungen und Befehlsbelohnungen.
• Bundle-Unterstützung: mehrere Item-Stapel pro Belohnung (dokumentiertes Limit von bis zu 27 Items pro Item-Belohnung) und unbegrenzte Befehle pro Befehlsbelohnung.
• Seltenheiten und Gewichte zur Balance der Belohnungschancen.
• Meilensteine und Mass-Open-Funktion.
• Öffnungs-Cooldowns und Öffnungskosten pro Spieler (Economy-Integration wird durch die Öffnungskosten-Funktion impliziert).
• Berechtigungs- und Key-Anforderungen für Crates und Belohnungen.
• Belohnungslimits (global und pro Spieler) sowie Belohnungs-Broadcasting/Logging.
• PlaceholderAPI-Unterstützung laut offiziellen Quellen.

🧩 Für wen es gedacht ist

• Öffentliche und private Spigot/Paper-Server, die Crates für Events, Monetarisierung oder Spielerbindung verwenden.
• Server-Administratoren, die einen Ingame-Editor gegenüber manueller YAML-Bearbeitung bevorzugen.

🏗️ Beispielanwendungen

• Richte eine Crate mit Seltenheiten und gewichteten Belohnungen ein, platziere einen Crate-Block im Spawn und gib Spielern virtuelle Keys zum Öffnen.
• Erstelle Crate-Vorschauen und Hologramme, damit Spieler die Belohnungen vor dem Einsatz von Keys ansehen können.
• Nutze Mass-Open und Meilensteine, um zeitlich begrenzte Events durchzuführen oder aktive Spieler zu belohnen.

⚙️ Installation

📥 Einrichtung

• Lade die offizielle Plugin-JAR herunter und lege sie in das plugins/-Verzeichnis deines Servers auf einer bestätigten unterstützten Server-Version (Spigot oder Paper).
• Starte den Server neu und prüfe die Server-Konsole, um zu bestätigen, dass das Plugin geladen wurde.
• Wenn das Plugin die begleitende Engine-Abhängigkeit benötigt, installiere das erforderliche Abhängigkeits-Plugin (nightcore) vor oder zusammen mit ExcellentCrates.

📦 Abhängigkeiten

• Erforderlich: nightcore (Plugin-Engine), wie von den offiziellen Quellen angegeben.
• Optional: ProtocolLib oder PacketEvents für erweiterte Hologramm-Funktionalität; PlaceholderAPI wird für Platzhalter in Texten unterstützt.

🧠 Technische Hinweise

• Bestätigte unterstützte Server-Software: Spigot und Paper.
• Bestätigte minimale Server-Version: 1.21.8 oder höher (laut Projektangabe).
• Bestätigte Java-Anforderung: Java 21 oder neuer.
• Folia- und Forge-Support werden ausdrücklich nicht unterstützt.
• Das Projekt-Repository führt eine GPL-3.0-Lizenz auf.

🤝 Wann dieses Plugin nützlich ist

Wenn du für einen Spigot/Paper-Server ein im Spiel konfigurierbares Crate-System mit virtuellen/physische Keys, Hologrammen und flexiblen Belohnungsdefinitionen (Items, Befehle, Seltenheiten und Limits) brauchst, bietet ExcellentCrates diese Funktionen und einen Editor-Workflow, der den Großteil der Konfiguration ohne manuelle Dateiänderungen handhabbar macht.