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

# Allgemeine Informationen

Willkommen in der offiziellen Dokumentation der Spigot- und Paper-Plugins von **Dyroxplays**.

Um dir die Einrichtung deiner Server-Systeme so einfach wie möglich zu machen, verwenden fast alle unsere Plugins mit grafischen Benutzeroberflächen (GUIs) dieselbe interne Code-Logik zum Zeichnen von Inventaren: das **InventoryBuilder-System**.

***

## 🧰 Das InventoryBuilder-System (Menü-Design)

Der `InventoryBuilder` liest die Layout-Vorgaben deiner Konfigurationsdateien aus und erstellt daraus dynamisch die In-Game-Menüs. Wenn du dieses System einmal verstanden hast, kannst du die GUIs **aller** Plugins im Handumdrehen anpassen.

### 1. Platzhalter & Glasscheiben (`placeholder`)

Fast jedes Menü besitzt eine Sektion namens `placeholder`. Hier kannst du leere Slots mit farbigen Glasscheiben dekorieren, um ein einheitliches Design zu erzeugen.

```yaml
placeholder:
  enable: true
  # Format ab Version 1.13+: MATERIALNAME: "Slots"
  GRAY_STAINED_GLASS_PANE: "0-8,18-26"
  LIGHT_BLUE_STAINED_GLASS_PANE: "9,17"
```

#### So definierst du Slots und Slot-Bereiche:

* **Einzelne Slots:** Trenne verschiedene Slots mit Kommas (z. B. `"9,17,25"`).
* **Slot-Bereiche:** Verwende einen Bindestrich, um einen zusammenhängenden Bereich zu füllen (z. B. `"0-8"` füllt die gesamte erste Reihe einer Truhe).
* **Mischung:** Du kannst auch beides kombinieren (z. B. `"0-8,12,18-26"`).

***

### 2. Formatierung von Gegenständen (Items)

Wenn du Gegenstände in Menüs platzierst, kannst du deren Aussehen über bestimmte Parameter steuern.

#### Format für die 1.13 und neuere Versionen:

```yaml
# Materialnamen müssen zwingend in Großbuchstaben angegeben werden (z. B. DIAMOND, GOLD_INGOT, COAL_ORE)
material: STICK
name: '&eKnockback-Stick'
amount: 1
slot: 13
lore:
  - '&7Dieses Item dient als'
  - '&7Standard-Schlagwerkzeug.'
```

#### Format für die 1.8 bis 1.12.x:

In älteren Minecraft-Versionen, in denen Sub-IDs (z. B. für gefärbte Glasscheiben oder Wolle) verwendet werden, gibt es das Feld `shortid` (oder die Sub-ID wird mit einem Semikolon an das Material gehängt):

```yaml
material: WOOL
shortid: 14   # Ergibt Rote Wolle (ID 35:14)
# Alternative Schreibweise in einigen Listen:
# - "WOOL;14;1;100" (Material;ShortID;Menge;Chance)
```

***

### 3. Liste der Plugins mit InventoryBuilder-Unterstützung

Folgende Plugins nutzen dieses System für ihre Menüs und Hintergründe:

* ⚔️ **1vs1** (Lobby- & Kit-Auswahl)
* 🎄 **Adventskalender** (24-Tage-Kalenderblatt)
* 🧱 **BuildFFA** (Shop & Perk-Auswahl)
* 🛍️ **BuyPerms** (Berechtigungs-Shop)
* 🥇 **CaseOpening** (Kisten-Animationen & Gewinne)
* 🐎 **DailyQuests** (Quest-Übersicht & Abgabe)
* 💸 **DailyRewards** (Tägliche Belohnungs-Slots)
* Livesupport (Supportticket-Verwaltung)
* 🤑 **MoneyTopList** (Bestenlisten-Köpfe)
* ✨ **Perks** (Perk-Aktivierung GUI)
* 🎰 **PlotAuction** (Auktions-Menüs)
* ⭐ **Plotbewerten** (Sterne-Menü)
* 💣 **TNTRun** (Map-Voting & Spectator-Menüs)
* 🚧 **Trichtersystem** (Verbindungs- und Filter-GUI)