# caseitem

Verwaltet die Belohnungen (Items) in Cases.

## Übersicht aller Befehle

```
/caseitem create <CaseName> <Chance> <DisplayName...>
/caseitem edit <CaseName> <ItemID> <Option> <Wert...>
/caseitem getitem <CaseName> <ItemID>
/caseitem clone <FromCase> <ItemID> <ToCase>
/caseitem delete <CaseName> <ItemID>
```

***

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

Erstellt ein neues Case-Item (Belohnung).

**Parameter:**

* `CaseName` - Name des Cases
* `Chance` - Gewinnchance in Prozent (z.B. 10.5 für 10,5%)
* `DisplayName` - Anzeigename des Items (mit Farbcodes)

**Permission:** `caseopening.caseitem.create`

**Beispiele:**

```bash
/caseitem create starter 85 §bDiamanten
/caseitem create starter 50 §6Goldbarren
/caseitem create legendary 5 §c§lEpisches Schwert
```

**Hinweis:** Das Item erhält automatisch die nächste verfügbare ID (1, 2, 3, ...).

***

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

Bearbeitet ein Case-Item.

**Permission:** `caseopening.caseitem.edit`

**Wichtig:** `<ItemID>` ist die **Zahl** des Items (1, 2, 3, ...), nicht ein Name!

### Verfügbare Optionen

#### chance

Ändert die Gewinnchance (in Prozent).

```bash
/caseitem edit starter 1 chance 10.5
/caseitem edit starter 2 chance 50
```

#### limit

Max. wie oft das Item gewonnen werden kann (-1 = unbegrenzt).

```bash
/caseitem edit starter 1 limit 5
/caseitem edit starter 2 limit -1
```

#### amount

Anzahl des Items (Stack-Size).

```bash
/caseitem edit starter 1 amount 5
/caseitem edit starter 2 amount 64
```

#### material

Ändert das Material des Items.

```bash
/caseitem edit starter 1 material DIAMOND
/caseitem edit starter 2 material NETHERITE_SWORD
```

#### setitemofhand

Setzt das Item in deiner Hand als Display-Item (nur Spieler).

```bash
/caseitem edit starter 1 setitemofhand
```

Verwendung:

1. Halte das gewünschte Item in der Hand
2. Führe den Befehl aus
3. Das Item (inkl. NBT, Enchantments) wird übernommen

#### addlore \<Lore...>

Fügt eine Lore-Zeile zum Item hinzu.

```bash
/caseitem edit starter 1 addLore §75x Diamanten
/caseitem edit starter 1 addLore §r
/caseitem edit starter 1 addLore §aSeltener Fund!
```

#### addcmd

Fügt einen Command hinzu, der beim Gewinnen ausgeführt wird.

```bash
/caseitem edit starter 1 addcmd give %player% diamond 5
/caseitem edit starter 1 addcmd eco give %player% 1000
/caseitem edit starter 1 addcmd lp user %player% parent add vip
/caseitem edit starter 1 addcmd tp %player% spawn
```

Platzhalter:

* `%player%` - Spielername

#### listcmd

Zeigt alle Commands des Items an (klickbar zum Bearbeiten/Löschen).

```bash
/caseitem edit starter 1 listcmd
```

#### removecmd confirm

Entfernt einen Command.

```bash
/caseitem edit starter 1 removecmd 0 confirm
```

#### editcmd

Bearbeitet einen bestehenden Command.

```bash
/caseitem edit starter 1 editcmd 0 give %player% emerald 10
```

#### firework \<true|false>

Aktiviert/Deaktiviert Feuerwerk beim Gewinnen.

```bash
/caseitem edit starter 1 firework true
/caseitem edit starter 2 firework false
```

#### broadcast

Setzt eine Broadcast-Nachricht für alle Spieler beim Gewinnen.

```bash
/caseitem edit starter 1 broadcast §6%player% §7hat §c§lDiamanten §7gewonnen!
/caseitem edit starter 1 broadcast none
```

Platzhalter:

* `%player%` - Spielername
* `%item%` - Item-Name

***

## /caseitem getitem

Gibt dir das Case-Item in die Hand (zum Testen).

**Permission:** `caseopening.caseitem.getitem`

**Beispiele:**

```bash
/caseitem getitem starter 1
/caseitem getitem legendary 5
```

Verwendung: Teste ob das Item korrekt konfiguriert ist, bevor Spieler es gewinnen können.

***

## /caseitem clone

Klont ein Case-Item in ein anderes Case.

**Permission:** `caseopening.caseitem.clone`

**Beispiele:**

```bash
/caseitem clone starter 1 premium
/caseitem clone legendary 5 epic
```

**Hinweis:** Das geklonte Item erhält automatisch eine neue ID im Ziel-Case.

***

## /caseitem delete confirm

Löscht ein Case-Item permanent.

**Permission:** `caseopening.caseitem.delete`

**Beispiel:**

```bash
/caseitem delete starter 1 confirm
```

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

***

## Wichtige Hinweise

<details>

<summary>ItemID ist immer eine Zahl!</summary>

❌ Falsch:

```bash
/caseitem edit starter diamanten material DIAMOND
```

✅ Richtig:

```bash
/caseitem edit starter 1 material DIAMOND
```

Die ItemID ist die Nummer, die das Item beim Erstellen automatisch erhält (1, 2, 3, 4, ...).

</details>

<details>

<summary>Gewinnchancen</summary>

Das Plugin normalisiert automatisch alle Chancen:

Beispiel:

```
Item 1: 85%
Item 2: 70%
Item 3: 55%
```

Die Summe ist egal - nur das Verhältnis zählt!

Alternative Schreibweise (gleiche Verteilung):

```
Item 1: 17
Item 2: 14
Item 3: 11
```

</details>

<details>

<summary>Commands mit Platzhaltern</summary>

Verfügbare Platzhalter:

* `%player%` - Spielername
* `%uuid%` - Spieler-UUID

Beispiel-Commands:

```bash
# Geld geben
/caseitem edit starter 1 addcmd eco give %player% 1000

# Rang geben
/caseitem edit starter 1 addcmd lp user %player% parent add vip

# Teleportieren
/caseitem edit starter 1 addcmd tp %player% spawn

# Item geben
/caseitem edit starter 1 addcmd give %player% diamond 5

# Nachricht senden
/caseitem edit starter 1 addcmd tell %player% §aGlückwunsch!

# Cases geben
/caseitem edit starter 1 addcmd case add legendary %player% 1
```

</details>

***

## Workflow: Item erstellen

{% stepper %}
{% step %}

### Item erstellen

```bash
/caseitem create starter 50 §bDiamanten
```

{% endstep %}

{% step %}

### Material setzen

```bash
/caseitem edit starter 1 material DIAMOND
```

{% endstep %}

{% step %}

### Anzahl setzen

```bash
/caseitem edit starter 1 amount 5
```

{% endstep %}

{% step %}

### Lore hinzufügen

```bash
/caseitem edit starter 1 addLore §75x Diamanten
/caseitem edit starter 1 addLore §aSeltener Fund!
```

{% endstep %}

{% step %}

### Commands hinzufügen (optional)

```bash
/caseitem edit starter 1 addcmd eco give %player% 500
```

{% endstep %}

{% step %}

### Feuerwerk aktivieren (optional)

```bash
/caseitem edit starter 1 firework true
```

{% endstep %}

{% step %}

### Broadcast setzen (optional)

```bash
/caseitem edit starter 1 broadcast §6%player% §7hat §bDiamanten §7gewonnen!
```

{% endstep %}

{% step %}

### Testen

```bash
/caseitem getitem starter 1
```

{% endstep %}
{% endstepper %}

***

## Tipps

{% hint style="info" %}

* Nutze `/caseitem getitem` um Items vor dem Konfigurieren zu testen.
* Höhere Chancen = häufiger, niedrigere = seltener. Die Summe ist egal.
* Mehrere Commands nacheinander mit `addcmd` hinzufügen.
* Broadcast nur für sehr seltene/wichtige Items aktivieren (< 10%).
* Cloning spart Zeit wenn mehrere Cases ähnliche Items haben.
* `listcmd` zeigt alle Commands mit klickbaren Edit/Delete-Buttons (nur für Spieler).
  {% endhint %}