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

# Konfiguration

Passe das Aussehen des Bewertungs-Gegenstands, die MySQL-Datenbankverbindung, Mindestspielzeiten und die einzelnen GUIs des **PlotBewerten**-Plugins flexibel in der `config.yml` an.

***

## Dateiübersicht

Das Plugin erstellt nach dem ersten Serverstart folgende Datei:

* **`plugins/PlotBewerten/config.yml`**: Steuert alle globalen Einstellungen, GUI-Layouts und Nachrichten.

***

## Konfigurations-Bereiche

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

#### Allgemeine Optionen

```yaml
# Der Präfix vor allen Systemnachrichten
prefix: '&7[&6PlotBewerten&7]'

# Ermöglicht Spielern, sich durch Klick im TOP-GUI zum Plot zu teleportieren
click2teleport: true

# Mindestspielzeit in SEKUNDEN, die ein Spieler haben muss, um bewerten zu dürfen (14400 = 4 Stunden)
neededplaytime: 14400
```

{% endtab %}

{% tab title="🗄️ MySQL" %}

#### Datenbank-Optionen

> \[!WARNING] **Achtung Code-Schreibfehler:** Der Datenbank-Schlüssel in der MySQL-Sektion heißt **`datebase`** (mit "te" in der Mitte) statt `database`. Achte darauf beim Eintragen deines Datenbanknamens!

```yaml
MySQL:
  host: localhost
  port: '3306'
  username: root
  datebase: db12 # Schreibweise beachten!
  password: password239239
```

{% endtab %}

{% tab title="🏆 Top-Plots GUI" %}

#### TOP5-Menü Optionen

```yaml
topplots:
  invname: '&6PlotBewerten &bTOP5'
  lore:
  - '&7Rang: &a%rank%'
  - '&7Ø Bewertung: &e%average%'
```

{% endtab %}
{% endtabs %}

***

## Haupt-GUI anpassen (`gui`)

Du kannst das Aussehen aller Menü-Gegenstände in der GUI anpassen:

```yaml
gui:
  name: '&6PlotBewerten'
  lenght: 4 # Zeilenanzahl der GUI (1-6)
  
  # Platzhalter-Füllung (Slot-Bereich z. B. 0-36)
  placeholder:
    BLACK_STAINED_GLASS_PANE: 0-36

  items:
    # Das Informations-Item über das aktuelle Plot (Standard: Kopf des Besitzers)
    info:
      material: PLAYER_HEAD
      slot: 4
      name: '&ePlot Information'
      skullowner: '%plotowner%'
      lore:
      - '&7PlotOwner: %plotowner%'
      - '&7PlotId: &e%plotid%'
      - '&7Ranking: &e#%rank%'
      - '&7Ø Bewertung: &e%average%'
      - '&7Bewertungsanzahl: &e%raitings%'
      - '&7Deine Bewertung: &e%yourrating%'
      - '&8(0=noch nicht bewertet)'

    # Item, falls das Plot bereits vom Spieler bewertet wurde
    alreayrated:
      material: BARRIER
      name: '&cBereits bewertet'
      lore:
      - '&7Deine Bewertung: &e%yourrating%'
      
    # Bestätigungs-Button zum Absenden der Punkte
    confirm:
      material: ARROW
      name: '&aBewertung abgeben'
      slot: 17

    # Stern-Buttons 1 bis 10 (Beispiel für Stern 1)
    rate_1:
      material: NETHER_STAR
      amount: 1
      name: '&e1 &7/10 Bewertung abgeben'
      slot: 20
      lore:
      - '&7Klicke hier, um diese Bewertung anzuwählen'
      - '&7anschließend musst du noch bestätigen'
```

***

## Chat- und Systemnachrichten

```yaml
# Zusätzlicher Hover-Zustandstext im Menü
loreselected: '&aAusgewählt'

messages:
  noperm: '&cDazu hast du keine Rechte'
  rated: '&aDu hast das Plot %plotid% mit %points% Punkten bewertet.'
  notonplot: '&cDu bist auf keinem Plot, was du bewerten kannst!'
  alreayrated: '&cDu hast diesen Plot bereits bewertet!'
  notenoughplaytime: '&cDu hast noch nicht genug Onlinezeit, du benötigst noch %sec% Sekunden!'
  usage: '&cNutze: &E/abewerten <reset> <PlotID> &c=> resetet die Bewertung vom Plot auf 0 oder &e/abewerten <delete> <PlotID> <Spielername> &c=> Entfernt die Bewertung von Spielername'
  reset: '&aPlotId %plotid% wurde resettet, sofern es ein Plot ist und Bewertung hatte!'
  delete: '&aDie Bewertung von %player% für PlotId %plotid% wurde entfernt, sofern eine vorhanden gewesen war!'
```