🥇Setup Guide

Eine Schritt-für-Schritt-Anleitung zur Einrichtung des CaseOpening-Plugins.

Voraussetzungen

Bevor du startest, stelle sicher, dass folgendes vorhanden ist:

✅ Erforderlich

Minecraft Server (Spigot, Paper, oder kompatibel)
- Version: 1.8.8 bis neueste Version
- Dyroxplays Updategarantie
Vault Plugin
- Download: https://www.spigotmc.org/resources/vault.34315/
Economy Plugin (z.B. EssentialsX)
- Für Kristall-Shop und Belohnungen
MySQL Datenbank
- Für große Server empfohlen

📦 Optional

PlaceholderAPI
- Download: https://www.spigotmc.org/resources/placeholderapi.6245/
- Für erweiterte Platzhalter
PlotSquared
- Für Plot-Integration
- Download: https://www.spigotmc.org/resources/plotsquared-v7.77506/
ItemEdit
- Für bessere Items bearbeiten (Name etc.)
- Download: https://www.spigotmc.org/resources/itemedit-1-8-x-1-21-x.40993/

Installation — Schritt-für-Schritt

Plugin herunterladen

Lade die neueste Version der CaseOpeningherunter [https://panel.dyroxplays.de/downloads]
In der Zip findest du 2 jars:
1. Eine mit "1.13+" im Namen, diese Version nutzt du für alle Serverversionen, AB der 1.13 (und auch NUR diese jar nutzen, nicht beide!). D.h. auch für zB 1.21.10 nutzt du die "1.13+" jar.
2. Für Server, die älter als 1.13 sind, also 1.8.8 - 1.12.2, nutzt du die Jar OHNE "1.13+" im Namen (und auch NUR diese jar nutzen, nicht beide!).

Plugin installieren

Stoppe deinen Server
Platziere die richtige Jar im plugins/ Ordner
Stelle sicher, dass Vault installiert ist (+ vaultfähiges Economy System)
Starte den Server

Erste Überprüfung

Prüfe die Console auf Fehler
Gib /plugins ein - CaseOpening sollte grün sein
Im plugins/CaseOpening/ Ordner wurden Config-Dateien erstellt

Beispiel-Meldungen in der Console:

[✓] CaseOpening v1.0 has been enabled!
[✓] Vault found and hooked!
[✓] PlaceholderAPI found and hooked!

Premade-Konfigurationen (Optional)

💡 Schnellstart mit fertigen Konfigurationen

Anstatt alles manuell zu konfigurieren, kannst du fertige Premade-Konfigurationen verwenden:

Download: Lade die Premades für deine Server-Version herunter
Installation:
- Stoppe den Server
- Kopiere die heruntergeladenen Dateien in plugins/CaseOpening/
- Überschreibe die vorhandenen Config-Dateien
- Starte den Server neu
Fertig! Alle Cases, Items und der Shop sind bereits konfiguriert

Hinweis: Die Premades enthalten 6 verschiedene Cases (Starter, Bronze, Silber, Gold, Diamant, Smaragd) mit vollständig konfigurierten Belohnungen und einem funktionierenden Shop-System.

Grundkonfiguration — Basis-Einstellungen anpassen

Öffne plugins/CaseOpening/config.yml und passe an:

# Passe das Präfix an
prefix: "§8[§6CaseOpening§8] §7"
# Hex-Farben (1.16+)

Grundkonfiguration — Nachrichten anpassen (Optional)

Öffne plugins/CaseOpening/messages.yml und passe Nachrichten an:

prefix: "§8[§6§lCASE§8] §7"
case:
  opened: "%prefix%§aDu hast ein §e%case% §ageöffnet!"
  won: "%prefix%§aGlückwunsch! Du hast §e%item% §agewonnen!"

Grundkonfiguration — Reload ausführen

Führe folgenden Befehl aus:

/case reload

Erstes Case erstellen — Case anlegen

Erstelle ein "Starter Case":

/case create starter 13 §6§lStarter Case

starter = interner Name (keine Leerzeichen)
13 = Slot im GUI (Mitte)
§6§lStarter Case = Anzeigename

Erstes Case erstellen — Case konfigurieren

/case edit starter price 50
/case edit starter maxAmount 100
/case edit starter material CHEST
/case edit starter addLore §7Ein einfaches Starter-Case
/case edit starter addLore §7mit grundlegenden Belohnungen
/case edit starter lootviewable true

Erstes Case erstellen — Belohnungen hinzufügen

Item 1: Diamant (selten)

/caseitem create starter diamond 10 §bDiamanten
/caseitem edit starter diamond amount 5
/caseitem edit starter diamond material DIAMOND
/caseitem edit starter diamond addLore §75x Diamanten
/caseitem edit starter diamond firework true

Item 2: Gold (mittel)

/caseitem create starter gold 25 §6Goldbarren
/caseitem edit starter gold amount 16
/caseitem edit starter gold material GOLD_INGOT
/caseitem edit starter gold addLore §716x Goldbarren

Item 3: Eisen (häufig)

/caseitem create starter iron 65 §7Eisenbarren
/caseitem edit starter iron amount 32
/caseitem edit starter iron material IRON_INGOT
/caseitem edit starter iron addLore §732x Eisenbarren

Erstes Case erstellen — Case testen

Gib dir Cases zum Testen:

/case add starter <DeinName> 10

Öffne das GUI:

/givemobilecaseopening

Rechtsklick mit dem Item → Öffne das Case!

Case-Blöcke einrichten — Block platzieren

Baue einen schönen Bereich für deine Cases:

□ □ □
□ ■ □  ← Platziere hier einen besonderen Block
□ □ □

Tipp: Nutze dekorative Blöcke wie:

Ender Chest
Chest
Beacon
Glowstone

Case-Blöcke einrichten — Block registrieren

Führe aus:

/registercaseblock

Klicke auf den Block → Wähle "starter" Case aus dem GUI

Erfolgsmeldung:

§aCase-Block wurde erfolgreich registriert!

Case-Blöcke einrichten — Testen

Klicke auf den Block → Main-GUI öffnet sich!

Case-Blöcke einrichten — Weitere Blöcke hinzufügen

Wiederhole die Schritte für weitere Cases:

/registercaseblock
→ Klicke auf Block A → Wähle "starter"
 /registercaseblock
→ Klicke auf Block B → Wähle "legendary"

Block entfernen

Falls du einen Fehler gemacht hast:

/unregistercaseblock
→ Klicke auf den Block

GUI anpassen

Main-GUI personalisieren

Öffne plugins/CaseOpening/mainGUI.yml:

# GUI-Größe ändern
size: 54

# Titel anpassen
title: "§6§l▶ §e§lCase Opening §6§l◀"

# Kristall-Anzeige Position
items:
  crystals:
    slot: 49
    item:
      displayname: "§b§l⬥ Deine Kristalle ⬥"
      lore:
        - "§7Du besitzt §b%crystals% §7Kristalle"
        - ""
        - "§eLinksklick §8» §7Kristall-Shop öffnen"

# Füllitems für besseres Design
fillitems:
  enabled: true
  item:
    material: GRAY_STAINED_GLASS_PANE
    displayname: " "

Preview-GUI anpassen

Öffne plugins/CaseOpening/previewGUI.yml:

title: "§e§l⚡ Vorschau: %case% ⚡"

# Öffnen-Button
open:
  slot: 53
  item:
    material: LIME_CONCRETE
    displayname: "§a§l✓ Case öffnen"
    lore:
      - "§7Klicke um das Case zu öffnen"
      - ""
      - "§eKosten: §6%price% §eKristalle"
      - "§7Dein Kontostand: §b%crystals% §7Kristalle"

Nach Änderungen:

/case reload

Erweiterte Features

Belohnungen mit Commands

Du kannst Items mit zusätzlichen Commands versehen:

/caseitem edit starter <ItemID> givecommands add lp user %player% parent add vip
/caseitem edit starter <ItemID> givecommands add eco give %player% 1000
/caseitem edit starter <ItemID> givecommands add tp %player% spawn

Hinweis: <ItemID> ist die Zahl des Items (1, 2, 3, ...)

Broadcast für seltene Items

/caseitem edit starter <ItemID> broadcast §6§l★ §e%player% §7hat §c§l%item% §7gewonnen! §6§l★

Alle Spieler sehen diese Nachricht beim Gewinnen!

Gruppen-Belohnungen

Öffne plugins/CaseOpening/caseGroupRewards.yml:

groups:
  vip:
    commands:
      give:
        - "case add starter %player% 5"
        - "crystals add %player% 100"
      already-have:
        - "tell %player% §cDu bist bereits VIP!"

Verwendung:

/casegroupadd <Spieler> vip

Permission-Belohnungen

Ähnlich wie Gruppen-Belohnungen in casePermRewards.yml.

MySQL einrichten (Optional) — Datenbank erstellen

Verbinde dich mit deinem MySQL-Server:

CREATE DATABASE caseopening;
CREATE USER 'caseopening'@'localhost' IDENTIFIED BY 'sicheres_passwort';
GRANT ALL PRIVILEGES ON caseopening.* TO 'caseopening'@'localhost';
FLUSH PRIVILEGES;

MySQL einrichten (Optional) — Config anpassen

Öffne config.yml und passe an:

storage:
  type: mysql
  
  mysql:
    host: localhost
    port: 3306
    database: caseopening
    username: caseopening
    password: sicheres_passwort
    useSSL: false

MySQL einrichten (Optional) — Server neu starten

/stop

Starte den Server → Tabellen werden automatisch erstellt!

MySQL einrichten (Optional) — Überprüfung

Prüfe in deiner MySQL-Datenbank:

USE caseopening;
SHOW TABLES;

Sollte zeigen:

+------------------------+
| Tables_in_caseopening  |
+------------------------+
| caseopening_players    |
| caseopening_cases      |
| caseopening_crystals   |
+------------------------+

Permissions einrichten

Spieler-Gruppe

Gib allen Spielern Zugriff auf das Case-System:

Mit LuckPerms:

/lp group default permission set caseopening.gui.main true
/lp group default permission set caseopening.gui.preview true
/lp group default permission set caseopening.shop.use true

Admin-Gruppe

Gib Admins volle Rechte:

/lp group admin permission set caseopening.* true

VIP-Cases

Erstelle exklusive Cases für VIPs:

/case create vipcase 14 §d§lVIP Case
/case edit vipcase permission caseopening.case.vipcase
/lp group vip permission set caseopening.case.vipcase true

Troubleshooting

Problem: Plugin lädt nicht

Lösungen:

Prüfe ob Vault installiert ist: /plugins
Schaue in die Console nach Fehlern
Prüfe Server-Version (1.8.8 bis neueste)

Problem: Cases öffnen sich nicht

Lösungen:

Prüfe Permission: caseopening.gui.main
Prüfe Console-Logs auf Fehlermeldungen
Prüfe ob Case aktiviert ist: /case edit <name> enable true

Problem: Keine Belohnungen

Lösungen:

Prüfe ob Items definiert sind: Öffne casesItem.yml
Prüfe Chancen: Summe sollte > 0 sein
Teste mit /caseitem getitem <case> <item>

Problem: MySQL-Verbindung fehlgeschlagen

Lösungen:

Prüfe MySQL-Server Status
Teste Verbindungsdaten
Prüfe Firewall-Einstellungen

Nächste Schritte

✅ Setup abgeschlossen! Hier sind weitere Ideen:

Mehr Cases erstellen
- Daily Case (täglich 1 gratis)
- Event Cases (zeitlich begrenzt)
- Legendary Cases (sehr selten)
Shop einrichten
- Kristalle gegen Geld verkaufen
- Cases direkt kaufen
Belohnungen erweitern
- Ränge als Belohnung
- Teleports zu speziellen Orten
- Custom Items mit Commands
Community einbinden
- Events mit speziellen Cases
- Wettbewerbe (wer öffnet die meisten?)
- Vote-Belohnungen mit Kristallen

Schnell-Referenz

Wichtigste Befehle

# Case erstellen
/case create <name> <slot> <displayname>

# Item hinzufügen
/caseitem create <case> <itemid> <chance> <name>

# Cases vergeben
/case add <case> <spieler> <anzahl>

# Kristalle vergeben
/crystals add <spieler> <anzahl>

# Block registrieren
/registercaseblock

# Reload
/case reload

Wichtigste Dateien

config.yml        → Haupteinstellungen & Nachrichten
caseshop.yml      → CaseShop-GUI
items.yml         → Allgemeine Items
previewgui.yml    → Preview-GUI-Layout
maingui.yml       → Main-GUI-Layout

casegroupadd.yml  → Alternative Commands für vorhandenem Rang-Vergabe
casepermadd.yml   → Alternative Coomands für vorhandenem Permission-Vergabe

Support

Bei Fragen:

Prüfe diese Dokumentation
Aktiviere Debug-Modus
Prüfe Console-Logs
Kontaktiere den Support mit Logs

Viel Erfolg mit deinem Case-Opening-System! 🎁

VorherigeBeschreibung NächsteKonfiguration

Zuletzt aktualisiert vor 4 Monaten