📑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

⚙️ Basis-Einstellungen

Allgemeine Optionen

# 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.

🏆 Ränge & Slots

Listen-Steuerung

# 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.

🎨 GUI & Deko

Menü-Optionen

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"

---

Ranking-Methoden (ranking_method)

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

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

---

Datenbank-Optionen

🗄️ Interne MySQL

Für JOIN_EVENT Datenspeicherung

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

🔗 Externe MySQL

Für EXTERNAL_MYSQL Fremddaten-Auslesung

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

---

Top-Einträge & Item-Lore

# 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%"