🎁 JuByteCase – CaseOpening

Das CaseOpening-Plugin, das dein Server-Erlebnis auf das nächste Level hebt.

Belohne deine Spieler mit spannenden Kisten-Öffnungen im CS:GO-Stil – inklusive Animationen, Sounds, Partikeln und Feuerwerk. Erstelle und verwalte alle Cases bequem direkt im Spiel über den integrierten GUI-Editor, ganz ohne eine einzige Config-Datei anfassen zu müssen.

---

✨ Features

• 🎰 Spannende Öffnungs-Animation – konfigurierbare Geschwindigkeit, Dauer und Sounds (Öffnen, Ticken, Gewinn)
• 🖱️ In-Game GUI-Editor (/case edit) – Cases, Items, Chancen, Lore, Enchantments, Potion-Effekte, Commands u. v. m. bearbeiten, ohne den Server zu verlassen
• 💎 Seltenheits-System – eigene Seltenheiten (z. B. Gewöhnlich, Selten, Legendär) mit eigener Chance und farbigem Glas in der Animation, inkl. eigenem Rarity-Editor (/case rarity)
• 📦 CaseBlocks – binde Cases an Blöcke in der Welt; mit Partikel-Rotation um den Block, Verwaltungs-GUI und Teleport (/case setcaseblock, /case listcaseblock)
• 🏆 Flexible Gewinne – Items (inkl. Custom Heads per HeadValue), Commands, Permissions/Ränge, Potion-Effekte, Enchantments, PersistentData, Feuerwerk, Server-Broadcast, Glow-Effekt
• 🎯 Intelligente Gewinn-Logik – Gewinnchancen pro Item, limitierte Ziehungen (DrawCount), Permission-/Rang-Checks und Trostpreis-Commands, wenn ein Spieler den Gewinn bereits besitzt
• ⚙️ Settings-GUI (/case settings) – Sounds, Partikel, Timings und Rarity-Anzeige direkt im Spiel anpassen
• 📊 Case-Logs (/case log) – wer hat wann was gewonnen? Mit Pagination, pro Spieler, pro Case oder als Gesamtstatistik
• 👀 Vorschau-Menü – Spieler sehen per Rechtsklick alle möglichen Gewinne inkl. Chance und Seltenheit
• 📱 Bedrock-Support – kompatibel mit Geyser; mobile Spieler öffnen Cases über /case (steuerbar per Permission)
• 🗄️ Datenbank-Anbindung – H2 (portable, ohne Setup) oder MySQL für Netzwerke
• 🔌 Integrationen – PlaceholderAPI, Vault, McNative, CityBuildV2
• 🧩 Developer-API – eigene Erweiterungen über CaseAPI, CasePlayerAPI und CaseLogAPI
• 🌍 Vollständig anpassbare Nachrichten – alle Texte und GUI-Titel über messages.yml und inventory.yml übersetzbar

---

🖱️ Der In-Game-Editor

Vergiss YAML-Dateien: Mit dem integrierten Editor erstellst du neue Cases in Sekunden. Items hinzufügen, Chancen setzen, Seltenheiten zuweisen, Commands hinterlegen – alles per Klick und Chat-Eingabe, mit Speichern/Verwerfen.

---

💎 Seltenheits-System

Gib deinen Gewinnen mehr Bedeutung: Jede Seltenheit hat ihre eigene Chance, ihren eigenen Anzeigenamen und ihr eigenes Glas in der Animation. Spieler sehen schon während des Tickens, wie wertvoll das Item ist, an dem der Zeiger gerade vorbeiläuft.

Grün = Gewöhnlich, Blau = Selten, Orange = Legendär – frei konfigurierbar.

---

📦 CaseBlocks in der Welt

Platziere Cases als interaktive Blöcke auf deinem Server – z. B. in der Lobby. Rotierende Partikel machen den Block schon von weitem sichtbar; per GUI verwaltest du alle CaseBlocks zentral und kannst dich direkt hinteleportieren.

CaseBlock mit rotierenden Flame-Partikeln – Linksklick öffnet, Rechtsklick zeigt die Vorschau.

---

📊 Logs & Statistiken

Behalte den Überblick: Jede Öffnung wird in der Datenbank protokolliert. Frage im Spiel ab, was ein Spieler gewonnen hat, wie oft eine Case geöffnet wurde oder wie viele Kisten insgesamt geöffnet wurden.

---

⌨️ Commands & Permissions

Basis-Permission: case.use · Command-Alias: /opening (konfigurierbar)

---

🧩 Developer-API

Binde JuByteCase in deine eigenen Plugins ein:

// Cases eines Spielers abfragen oder verändern
CasePlayerAPI playerApi = CaseAPI.getPlayerAPI();
playerApi.addCase(uuid, "vote", 3);

// Öffnungs-Logs auslesen
CaseLogAPI logApi = CaseAPI.getLogAPI();
List<CaseLogEntry> entries = logApi.getEntries(uuid);

---

🚀 Installation

1. Plugin in den plugins-Ordner legen und Server neu starten
2. Optional: Datenbank in database.yml konfigurieren (Standard: H2, kein Setup nötig)
3. Mit /case edit deine erste Case erstellen
4. Mit /case setcaseblock <Material> einen CaseBlock in der Lobby platzieren
5. Fertig! 🎉

---

💬 Support

Fragen, Wünsche oder einen Bug gefunden? Melde dich auf unserem Discord oder erstelle ein Ticket – wir helfen schnell und unkompliziert weiter.