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

# Konfiguration

In diesem Abschnitt findest du die Erklärungen zu den Einstellungsbereichen der `config.yml` des **Abstimmung**-Plugins.

***

## Dateiübersicht

Nach dem ersten Start generiert das Plugin folgende Datei:

* **`plugins/Abstimmung/config.yml`**: Beinhaltet alle Einstellungen zu Preisen, Cooldowns, GUI-Strukturen und die Abstimmungsoptionen.

***

## Konfigurations-Bereiche

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

#### Allgemeine Einstellungen

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

# Cooldown (in Sekunden), bevor ein Spieler eine neue Umfrage starten kann
cooldownsec: 43200

# Wirtschaftsbefehle zum Hinzufügen/Entfernen von Geld (Vault-Alternative)
AddMoneyCommand: eco give %player% %money%
RemoveMoneyCommand: eco take %player% %money%
```

{% endtab %}

{% tab title="🗳️ GUI-Layout" %}

#### Abstimmungs-GUI & Knöpfe

```yaml
invname: '&aAbstimmung'
invreihen: 3

# Texte & Tooltips für Ja/Nein Knöpfe im Chat/GUI
'yes': '&aJa'
'no': '&cNein'
overyes: '&7Stimme für &aJa &7ab'
overno: '&7Stimme für &cNein &7ab'
```

{% endtab %}

{% tab title="💬 Nachrichten" %}

#### Systemnachrichten

```yaml
messages:
  result: '&eDas Ergebnis von der Abstimmung von %player% lautet:'
  fixabstimmung: '&a%player%''s Cooldown wurde aufgehoben, er kann nun eine neue Abstimmung starten.'
  finished: '&cAbstimmung bereits abgelaufen'
  voted: '&aDu hast für %vote% Abgestimmt'
  errorvoted: '&cDu hast bereits für diese Abstimmung eine Stimme abgegeben.'
  enterplayername: '&cBitte gebe einen Spielernamen an.'
  noperm: '&cDazu hast du keine Rechte.'
  notenoughmoney: '&cDu brauchst mind. %money% $, Vorgang abgebrochen.'
  notonlne: '&cDer Spieler ist nicht online, Vorgang abgebrochen.'
  success: '&aEine Abstimmung wurde gestartet.'
  error: '&cDu kannst erst wieder in %hour% Stunden, %min% Minuten und %sec% Sekunden eine Abstimmung starten!'
  usage: '&cNutze: /fixabstimmung <Spieler>'
```

{% endtab %}
{% endtabs %}

***

## Abstimmungs-Optionen erstellen (`votes`)

Unter dem Key `votes` in der Config kannst du beliebig viele Abstimmungstypen erstellen. Jeder Eintrag wird über seine Slot-Nummer definiert.

### Konfigurations-Beispiel:

```yaml
votes:
  '10': # Slot-Nummer im GUI
    material: BARRIER # Item-Material im GUI
    shortid: 0
    price: 15000 # Kosten, um die Abstimmung zu starten
    name: '&eAbstimmung starten:'
    lore:
      - '&7Wirft einen bösen Spieler &cfür 5 Minuten raus!'
      - '&7Preis: &a15000$'
    playernameneeded: true # Benötigt die Angabe eines Zielspielers
    command: '[CONSOLE]ban %player% 5min Abstimmung' # Befehl bei positivem Ausgang
    broadcast:
      start: # Chat-Broadcast beim Start der Umfrage
        - '&a============'
        - '&7%player% hat eine &eBanabstimmung für %target% gestartet'
        - '&7Soll %target% gebannt werden?'
        - '%vote%' # Platzhalter für die klickbaren Ja/Nein Knöpfe
        - '&a============'
      'no': # Chat-Broadcast bei abgelehntem Ergebnis (Mehrheit "Nein")
        - '&a============'
        - '%result%'
        - '&7Das heißt, dass %target% nicht gebannt wird'
        - '&a============'
      'yes': # Chat-Broadcast bei erfolgreichem Ergebnis (Mehrheit "Ja")
        - '&a============'
        - '%result%'
        - '&7Das heißt, dass %target% gebannt wurde.'
        - '&a============'
```

* **`command` Prefix**: Du kannst Befehle mit `[CONSOLE]` (wird über die Serverkonsole ausgeführt) oder ohne Präfix (wird als Spieler ausgeführt) definieren.
* **`playernameneeded`**: Wenn `true`, öffnet sich beim Klick ein Chat-Prompt, bei dem der Spieler erst einen Zielspielernamen eingeben muss.