> 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/caseitem.md).

# 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 %}


---

# 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/caseitem.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.