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

# Konfiguration

Passe die Shop-Kategorien, die Kauf- und Verkaufspreise, das GUI-Design sowie alle In-Game-Nachrichten des **AdminShop**-Plugins flexibel in der `config.yml` an.

***

## Dateiübersicht

Das Plugin erstellt nach dem ersten Serverstart folgende Datei:

* **`plugins/AdminShop/config.yml`**: Verwaltet alle Shop-Kategorien, Preise, Menü-Designs und Systemnachrichten.

***

## Konfigurations-Bereiche

{% tabs %}
{% tab title="⚙️ Basis-Einstellungen" %}

#### Allgemeine Optionen

```yaml
# Der Präfix vor Systemnachrichten im Chat
prefix: '&7[&cAdminShop&7]'

# Name der Haupt-Shop-GUI
invname: '&cAdminShop'
```

{% endtab %}

{% tab title="💰 Alles verkaufen" %}

#### Schnellverkauf-Option

```yaml
# Richtet ein Item ein, um das gesamte Inventar auf einmal zu verkaufen
sellallitems:
  material: COAL_ORE
  shortid: 0
  slot: 8
  name: '&7Alle Items verkaufen'
  lore:
  - '&aVerkaufe alle möglichen Items'
  - '&aaus deinem Inventar'
  - '&8(Zum Deaktivieren den Slot auf -1 setzen!)'
```

{% endtab %}

{% tab title="🎨 Platzhalter" %}

#### GUI-Design

```yaml
# Füllt leere Slotbereiche mit Glas
placeholder:
  material: GRAY_STAINED_GLASS_PANE
  shortid: 0
```

{% endtab %}
{% endtabs %}

***

## Kategorien & Verkaufs-Items (`categories` & `gui`)

Der Shop ist in Kategorien unterteilt. Spieler klicken auf eine Kategorie in der Haupt-GUI, um in das jeweilige Untermenü mit den Waren zu gelangen.

### Konfigurations-Beispiel:

```yaml
# Definition der Kategorien in der Haupt-GUI
categories:
  erze:
    material: COAL_ORE
    shortid: 0
    slot: 3
    name: '&7Erze'
    lore:
    - '&aHier findest du die ganzen Erze!'
  werkzeug:
    material: STONE_PICKAXE
    shortid: 0
    slot: 5
    name: '&7Werkzeug'
    lore:
    - '&7Rüste dich aus!'

# Definition der Items innerhalb der jeweiligen Kategorie
gui:
  erze:
    '30': # Slotnummer in der Kategorie-GUI
      material: COAL_ORE
      shortid: 0
      amount: 5 # Verkaufs-Menge
      buyprice: 100 # Kaufpreis (0 = nicht kaufbar)
      sellprice: 100 # Verkaufspreis (0 = nicht verkaufbar)
    '31':
      material: DIAMOND_ORE
      shortid: 0
      amount: 5
      buyprice: 500
      sellprice: 300
      name: '&cCustom Diamanten-Erz Name'
      lore:
      - '&7Eine spezielle Beschreibung'
      - '%HIDE%&aDieser Lore-Eintrag wird beim Klick versteckt'
```

* **`%HIDE%`**: Zeilen mit dem Präfix `%HIDE%` werden dem Käufer nicht auf dem endgültigen Item im Inventar angezeigt, sondern dienen nur zur Information im Shop-Menü.

***

## Systemnachrichten

```yaml
messages:
  noperm: '&cDazu hast du keine Rechte.'
  success:
    bought: '&aDu hast dir was für %money% gekauft!'
    sold: '&aDu hast was für %money% verkauft!'
  error: '&cDu brauchst mindestens %money%!'
  notsellable: '&cDu kannst das Item nicht verkaufen!'
  notbuyable: '&cDu kannst das Item nicht kaufen!'
  itemnotininv: '&cDu hast das Item nicht vorrätig in deinem Inventar!'
  invfull: '&cDein Inventar ist voll!'
```
