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

# Konfiguration

Passe die Ranking-Methoden, die GUI-Slots der Bestenliste, die Platzhalter und die MySQL-Anbindung (für interne oder externe Datenbanken) flexibel in der `config.yml` an.

***

## Dateiübersicht

Das Plugin erstellt nach dem ersten Serverstart folgende Datei:

* **`plugins/MoneyToplist/config.yml`**: Verwaltet alle Einstellungen zur Geldberechnung, GUI-Layouts und MySQL-Datenbanken.

***

## Konfigurations-Bereiche

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

#### Allgemeine Optionen

```yaml
# Der Präfix vor Systemnachrichten
prefix: "&7[&eMoneyToplist&7] "

# Zahlenformat für Kontostände
format: "#.##"

# Externe APIs & Permissions
use_placeholderapi: true
check_luckperms_bypass: true
```

* **`check_luckperms_bypass`**: Wenn `true`, werden Spieler mit der Permission `moneytoplist.bypass` (auch offline) von der Bestenliste ausgeschlossen.
  {% endtab %}

{% tab title="🏆 Ränge & Slots" %}

#### Listen-Steuerung

```yaml
# Methode zur Geldberechnung
ranking_method: "VAULT_OFFLINE"

ranks:
  # Anzahl der angezeigten Plätze
  amount: 5
  # GUI-Slots, auf denen die Plätze platziert werden
  slots: "13, 12, 14, 10, 16"
```

* **`ranks.slots`**: Die Anzahl der angegebenen Slots muss exakt mit der `amount` übereinstimmen.
  {% endtab %}

{% tab title="🎨 GUI & Deko" %}

#### Menü-Optionen

```yaml
gui:
  name: "&8» &eMoneyToplist"
  length: 3 # Reihenanzahl (1-6)

# Dekorative Hintergrundscheiben
placeholder:
  enable: true
  GRAY_STAINED_GLASS_PANE: "0-26"
  LIGHT_BLUE_STAINED_GLASS_PANE: "1,7,19,25"
```

{% endtab %}
{% endtabs %}

***

## Ranking-Methoden (`ranking_method`)

Wähle die passende Methode, wie das Plugin die reichsten Spieler ausliest:

<table><thead><tr><th width="250">Methode</th><th>Funktionsweise</th><th>Empfohlen für</th></tr></thead><tbody><tr><td><code>VAULT_OFFLINE</code></td><td>Liest asynchron alle Offline-Spieler über Vault aus.</td><td>Kompakte, lokale Server ohne MySQL.</td></tr><tr><td><code>PLACEHOLDER_API</code></td><td>Holt sich vorgefertigte Baltop-Daten von anderen Plugins (z. B. Essentials).</td><td>Server, die Baltop bereits anderweitig berechnen lassen.</td></tr><tr><td><code>EXTERNAL_MYSQL</code></td><td>Greift direkt auf eine externe Tabelle deines Wirtschafts-Plugins zu.</td><td>Netzwerke mit zentraler MySQL-Datenbank.</td></tr><tr><td><code>JOIN_EVENT</code></td><td>Speichert Kontostände nur ab, wenn Spieler den Server betreten.</td><td>Spezifische, ressourcensparende Setups.</td></tr></tbody></table>

***

## Datenbank-Optionen

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

#### Für JOIN\_EVENT Datenspeicherung

```yaml
MySQL:
  enable: false
  host: "localhost"
  port: "3306"
  username: "root"
  database: "db12"
  password: "password239239"
```

{% endtab %}

{% tab title="🔗 Externe MySQL" %}

#### Für EXTERNAL\_MYSQL Fremddaten-Auslesung

```yaml
mode_external_mysql:
  # Spaltennamen des externen Plugins (z. B. Essentials oder CMI)
  economy_table:
    table_name: "economy"
    column_money: "balance"
    column_uuid: "uuid"
    column_name: "playername" # Leer lassen "", falls nicht vorhanden

  # Verknüpfung der UUID mit den Namen in einer separaten Tabelle
  name_mapping:
    enable: false
    table_name: "players"
    column_uuid: "uuid"
    column_name: "name"
    
  fallback_minecraft_api: true
```

{% endtab %}
{% endtabs %}

***

## Top-Einträge & Item-Lore

```yaml
# Lore der Spieler-Köpfe in der Bestenliste
lore:
  - "&7Rang: &a%rank%"
  - "&7Money: &a%money% $"

# Automatisch generierte Platzhalter-Zuordnungen (bei PLACEHOLDER_API)
top:
  '1':
    name: "%essentials_baltop_player_1%"
    money: "%essentials_baltop_balance_1%"
  '2':
    name: "%essentials_baltop_player_2%"
    money: "%essentials_baltop_balance_2%"
```