> For the complete documentation index, see [llms.txt](https://wiki.dyroxplays.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.dyroxplays.de/caseopening/commands/case.md).

# case

Der Hauptbefehl für die Verwaltung von Cases.

## Übersicht aller Befehle

```
/case create <Name> <Slot> <DisplayName...>
/case delete <Name>
/case edit <Name> <Option> <Wert...>
/case add <Name> <Spieler|*|**> <Anzahl>
/case remove <Name> <Spieler|*|**> <Anzahl>
/case take <Name> <Spieler|*|**> <Anzahl>
/case set <Name> <Spieler|*|**> <Anzahl>
/case info <Spieler>
/case reload
```

***

## /case create \<DisplayName...>

Erstellt ein neues Case.

Parameter:

* `Name` - Eindeutiger interner Name des Cases (alphanumerisch, keine Leerzeichen)
* `Slot` - Slot-Position im Main-GUI (0-53)
* `DisplayName` - Anzeigename des Cases (Leerzeichen erlaubt, Farbcodes erlaubt)

Permission: `caseopening.case.create`

Beispiele:

```
/case create starter 10 §6Starter Case
/case create legendary 20 §c§lLegendary Case
/case create daily 13 §e§lDaily Case
```

***

## /case delete

Löscht ein existierendes Case (inkl. aller Items und Daten).

Parameter:

* `Name` - Name des zu löschenden Cases

Permission: `caseopening.case.delete`

Beispiel:

```
/case delete starter
```

⚠️ Warnung: Dieser Vorgang kann nicht rückgängig gemacht werden!

***

## /case edit\<Wert...>

Bearbeitet die Eigenschaften eines Cases.

Permission: `caseopening.case.edit`

### Verfügbare Optionen

#### displayname \<DisplayName...>

Ändert den Anzeigenamen des Cases.

```bash
/case edit starter displayname §a§lNeuer Starter Case
```

***

#### amount

Setzt die Anzahl des Items im GUI.

```bash
/case edit starter amount 1
```

***

#### limit

Setzt die maximale Anzahl, die ein Spieler besitzen kann (-1 = unbegrenzt).

```bash
/case edit starter limit 100
/case edit daily limit -1
```

***

#### price

Setzt den Preis in Kristallen.

```bash
/case edit starter price 50
/case edit premium price 500
```

***

#### crystals \<true|false>

Lightning Round: Case wird beim Öffnen gekauft (true) oder bereits besessen (false).

```bash
/case edit starter crystals false
/case edit diamond crystals true
```

***

#### material \[Shortid]

Ändert das Item-Material des Cases.

```bash
/case edit starter material CHEST
/case edit legendary material ENDER_CHEST
/case edit starter material PLAYER_HEAD 12345
```

***

#### setItemOfHand

Setzt das Item in deiner Hand als Case-Item (inkl. NBT-Tags, Enchantments etc.).

```bash
/case edit starter setItemOfHand
```

Verwendung:

{% stepper %}
{% step %}

### Schritt 1

Halte das gewünschte Item in der Hand.
{% endstep %}

{% step %}

### Schritt 2

Führe den Befehl aus.
{% endstep %}

{% step %}

### Schritt 3

Das Item wird übernommen.
{% endstep %}
{% endstepper %}

***

#### addLore \<Lore...>

Fügt eine Lore-Zeile hinzu.

```bash
/case edit starter addLore §7Enthält grundlegende Items
/case edit starter addLore §r
/case edit starter addLore §eKosten: §650 Kristalle
```

Tipp: `§r` fügt eine Leerzeile ein.

***

#### removeLoreLine

Entfernt eine Lore-Zeile (Nummerierung beginnt bei 0).

```bash
/case edit starter removeLoreLine 2
```

Ohne Parameter zeigt es eine klickbare Liste aller Lore-Zeilen.

***

#### editLoreLine \<Lore...>

Bearbeitet eine bestehende Lore-Zeile.

```bash
/case edit starter editLoreLine 0 §7Neue Beschreibung
```

***

#### lightninground \<true|false>

Aktiviert/Deaktiviert Blitz-Effekt beim Öffnen des Cases.

```bash
/case edit starter lightninground true
/case edit starter lightninground false
```

***

#### enabled \<true|false>

Aktiviert/Deaktiviert das Case (deaktivierte Cases werden nicht im GUI angezeigt).

```bash
/case edit starter enabled true
/case edit event enabled false
```

***

#### permission \<None|Permission>

Setzt eine erforderliche Permission für das Case oder entfernt sie.

```bash
/case edit vipcase permission caseopening.case.vip
/case edit starter permission none
```

***

#### lootviewable \<true|false>

Erlaubt/Verbietet die Vorschau der Belohnungen.

```bash
/case edit starter lootviewable true
/case edit mystery lootviewable false
```

***

#### slot

Ändert den Slot des Cases im Main-GUI (0-53).

```bash
/case edit starter slot 10
/case edit legendary slot 16
```

***

## /case add \<Spieler|\*|\*\*>

Fügt einem oder mehreren Spielern Cases hinzu.

Parameter:

* `Name` - Case-Name
* `Spieler` - Spielername, `*` (alle online) oder `**` (alle in DB)
* `Anzahl` - Anzahl der Cases

Permission: `caseopening.case.add`

Beispiele:

```bash
/case add starter PlayerName 5
/case add legendary * 1          # Alle online Spieler
/case add epic ** 10             # Alle Spieler in DB
```

***

## /case remove \<Spieler|\*|\*\*>

Entfernt Cases von Spielern (nur wenn genug vorhanden).

Permission: `caseopening.case.remove`

Beispiel:

```bash
/case remove starter PlayerName 3
```

Hinweis: Wenn nicht genug Cases vorhanden sind, wird nichts entfernt.

***

## /case take \<Spieler|\*|\*\*>

Nimmt Cases von Spielern, auch wenn nicht genug vorhanden (kann negativ werden).

Permission: `caseopening.case.take`

Beispiel:

```bash
/case take starter PlayerName 100
```

Unterschied zu `remove`: Funktioniert auch wenn Spieler nicht genug Cases hat.

***

## /case set \<Spieler|\*|\*\*>

Setzt die Case-Anzahl eines Spielers auf einen exakten Wert.

Permission: `caseopening.case.set`

Beispiel:

```bash
/case set starter PlayerName 50
/case set legendary * 0           # Entfernt alle von online Spielern
```

***

## /case info

Zeigt alle Cases eines Spielers an.

Permission: `caseopening.case.info`

Beispiel:

```bash
/case info PlayerName
```

Ausgabe:

```
==========================
PlayerInfo: PlayerName
starter: 5
premium: 2
legendary: 0
==========================
```

***

## /case reload

Lädt alle Konfigurationsdateien neu.

Permission: `caseopening.case.reload`

Beispiel:

```bash
/case reload
```

Neu geladen werden:

* config.yml
* Alle Case-Dateien (caseItems/\*.yml)
* items.yml
* mainGUI.yml
* previewGUI.yml
* caseShop.yml

***

## Wildcards

* `*` = Alle **online** Spieler
* `**` = Alle Spieler in der **Datenbank** (online + offline)

Beispiele:

```bash
/case add starter * 5        # Nur online Spieler
/case set legendary ** 0     # Alle Spieler in DB
```

***

## Platzhalter

In Lore und Namen können folgende Platzhalter verwendet werden:

* `%amount%` - Anzahl der Cases, die der Spieler besitzt

Beispiel:

```bash
/case edit starter addLore §eDu hast §6%amount% §eCases
```

***

{% hint style="info" %}
Tipps

* Case-Namen: Verwende aussagekräftige Namen ohne Leerzeichen (z.B. `starter`, `legendary`, `daily_reward`)
* Testing: Nach dem Erstellen mit `/case add <case> <name> 1` testen
* Slot-Layout: Vermeide Überschneidungen mit GUI-Items (z.B. Kristall-Anzeige)
* Permissions: Setze Permissions für exklusive Cases (VIP, Premium etc.)
* Reload: Nach Änderungen an Case-Eigenschaften immer `/case reload` ausführen
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.dyroxplays.de/caseopening/commands/case.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.