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

# Konfiguration

Gestalte das GunGame-Scoreboard, die MySQL-Anbindung, die Level-Grenzen und die automatischen Map-Wechsel flexibel in der `config.yml`.

***

## Dateiübersicht

Das Plugin erstellt nach dem ersten Serverstart folgende Datei:

* **`plugins/GunGame/config.yml`**: Verwaltet alle Spieloptionen, Chat-Nachrichten, Map-Votings und Bestenlisten.

***

## Konfigurations-Bereiche

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

#### Allgemeine Optionen

```yaml
# Der Präfix vor Chatnachrichten
prefix: '&7[GunGame]'

# Verhindert Schaden beim Herunterfallen
disablefalldamage: false

# Sendet Kills und Tode global an alle Welten
killanddeathmessageglobal: false

# Prüft, ob Spieler in Wasser oder auf halben Blöcken stehen
checkhalfblockwater: true
```

{% 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: user
  datebase: db # Schreibweise beachten!
  password: password123
```

{% endtab %}

{% tab title="🎮 Gameplay & Maps" %}

#### Match-Optionen

```yaml
# Levelaufstieg-Wahrscheinlichkeiten
levelpercent:
  min: 1
  max: 25

# Visuelle Anzeigen
options:
  sb: true # Scoreboard aktivieren
  healthdisplay: true # Lebensanzeige über den Köpfen der Spieler

# Automatischer Mapwechsel
mapchaning: true
mapchaningminutes: 30 # Wechselt die Karte alle 30 Minuten
```

{% endtab %}

{% tab title="🗳️ Map-Voting" %}

#### Abstimmungs-Item

```yaml
mapvoting:
  enable: true
  guiname: '&bMapVoting'
  invitem:
    enable: true # Gibt Spielern ein Voting-Item ins Inventar
    sec: 30 # Dauer des Votings in Sekunden
    item: 8;MAP;&aMapvoting # Format: Slot;Material;Displayname
```

{% endtab %}
{% endtabs %}

***

## Scoreboard-Konfiguration (`sb`)

Du kannst die Sidebar des Scoreboards frei editieren und Platzhalter verwenden:

```yaml
sb:
  title: '&aDyroxplays.de'
  board:
  - '&a '
  - '&fMap:'
  - '&e%gungame_map%'
  - '&b '
  - '&fKills:'
  - '&b%gungame_kills%'
  - '&c '
  - '&fDeaths: '
  - '&c%gungame_deaths%'
  - '&d '
  - '&fLevelRekord:'
  - '&a%gungame_rekord%'
  - '&e '
```

***

## Chat- und Systemnachrichten

```yaml
# Chat-Meldungen beim Betreten/Verlassen und bei Kills
joinmessage: '&e%player% &eist gejoint'
quitmessage: '&e%player% &eist geleavt'
killmessage: '&c%player% &ewurde von &a%killer% &cgetötet'
deathmessage: '&c%player% &eist gestorben'

# Systemausgaben
messages:
  noperm: '&cDazu hast du keine Rechte.'
  newmap: '&aEs wird nun auf %map% gespielt.'
  changein: '&aMapchange in %sec% Sekunden.'
  setspawn:
    set: '&aSpawn für %map% wurde gespeichert.'
    usage: '&cNutze: /setspawn <MapName>'
  setspawnpos:
    set: '&aSpawnPos %pos% für %map% wurde gespeichert.'
    usage: '&cNutze: /spawnpos <MapName> <1/2>'
  settopwall: '&cNutze: /settopwall <kills,deaths> <1-10>'

# Ausgabe des Befehls /stats
stats:
- '&eStats von %player%'
- '&fKills: %kills%'
- '&fDeaths: %deaths%'
- '&fK/D: %kd%'
- '&fRang: %rang%'
```

***

## Statswand (Top 10 Schilder)

Konfiguriere das Layout der Schilder an der Statswand:

```yaml
topwall:
  kills:
    '1': 'Rang: %rang%'
    '2': ''
    '3': '%player%'
    '4': 'Kills: %kills%'
  deaths:
    '1': 'Rang: %rang%'
    '2': ''
    '3': '%player%'
    '4': 'Deaths: %deaths%'
```