📑Konfiguration

Hier findest du eine detaillierte Aufschlüsselung der Konfigurationsdatei für das BuyPerms-Plugin, mit der du das Verhalten, die Permissions, Preise und die GUI-Gestaltung anpassen kannst.

---

Dateiübersicht

Das Plugin generiert nach dem ersten Serverstart folgende Hauptkonfigurationsdatei:

• plugins/BuyPerms/config.yml: Steuert alle Preise, Item-Definitionen, Sounds, MySQL-Zugänge und Plugin-Nachrichten.

---

Konfigurations-Bereiche

⚙️ Basis-Einstellungen

Globale Optionen

# Präfix vor Systemnachrichten im Chat
prefix: '&bBuyPerms &8»'

# Währungseinstellungen
usevault: false
enabletokencmd: true
starttokens: 0

• usevault: Wenn true, wird die Wirtschaft von Vault (In-Game Geld) verwendet. Wenn false, wird das integrierte Token-System genutzt.

• enabletokencmd: Aktiviert oder deaktiviert den Befehl /token.

• starttokens: Startguthaben an Tokens für Spieler bei ihrem ersten Serverbeitritt.

🗄️ MySQL

Datenbank-Optionen

MYSQL:
  host: localhost
  port: '3306'
  username: user
  database: db
  password: password123

• Trage hier deine MySQL-Zugangsdaten ein, um die Tokenbestände der Spieler über mehrere BungeeCord-Server hinweg zu synchronisieren.

🎵 Sounds & Items

Sound- & Admin-Item-Einstellungen

sound:
  openinv: BLOCK_CHEST_OPEN
  buy: ENTITY_PLAYER_LEVELUP
  cancel: BLOCK_ANVIL_BREAK

adminitems:
  accept: ARROW
  cancel: BARRIER
  placeholder: LIGHT_BLUE_STAINED_GLASS_PANE
  nopage: BARRIER
  previewpage: ARROW
  nextpage: ARROW

• sound: Bestimmt die zu spielenden Bukkit-Sounds bei GUI-Aktionen.

• adminitems: Legt die Item-Materialien fest, welche für die Steuerung im GUI (Kaufbestätigung, Navigation) angezeigt werden.

---

Berechtigungs-Systeme

Das Plugin unterstützt verschiedene Permission-Systeme. Setze das von dir genutzte System auf true und die restlichen auf false.

permissionsystem:
  permissionsex: false
  luckperms: false
  cperms_cnv2: false
  cperms_cnv3: false
  dkperms: false

Ausgeführte Befehle

Je nach dem oben ausgewählten System werden folgende Befehlsstrukturen verwendet, um Ränge/Permissions zuzuweisen:

addpermcmd: pex user %player% add %perm% %extra%
addgroupcmd: pex user %player% group add %group% %extra%
setgroupcmd: pex user %player% group set %group% %extra%

---

Verkaufs-Items (Shop-GUI)

Unter dem Key items kannst du deine verkaufbaren Berechtigungen und Ränge seiten- und slotbasiert konfigurieren.

# Der Name des Hauptmenüs (unterstützt %token% als Währungsanzeige)
invname: '&bBuyPerm %token%'

items:
  '1': # Seite 1
    '0': # Slot 0 (Erstes Slot oben links)
      name: '&6XY Permission'
      mode: addpermcmd
      perm:
      - permission.xy
      price: 10
      item: ANVIL
      lore:
      - '&7Beschreibung Zeile 1'
      - '&7Beschreibung Zeile 2'
    '1': # Slot 1
      name: '&6Gruppe: Premium'
      mode: addgroupcmd
      group: Premium
      extra: lifetime
      price: 100
      item: GOLD_INGOT
      lore:
      - '&7Kaufe den Premium-Rang'

• mode: Bestimmt die Zuweisungs-Art. Mögliche Werte: addpermcmd (Einzelne Permission) oder addgroupcmd / setgroupcmd (Gruppen & Ränge).

• price: Preis in Tokens oder Vault-Geld (je nach usevault Einstellung).

---

Systemnachrichten & GUI-Namen

# Namen des Kauf-Bestätigungsmenüs
confirminv:
  name: '&cBist du sicher?'
  accept: '&aKaufen'
  cancel: '&cAbbrechen'

# Statusanzeigen auf den Items im Verkaufs-GUI
alreadyhasperm: '&aGekauft'
hasnotperm: '&cKaufe für %price%'

# Weitere Nachrichten
messages:
  configreloaded: '&aConfig reloaded.'
  buypermusage: '&cNutze: /buyperm <Page>'
  tokenusage: '&cNutze: /token <add/set/remove> <Player> <Amount>'
  tokenadded: '&a%player% wurden %token% Tokens hinzugefügt!'
  tokenchanged: '&aDeine Tokenanzahl hat sich verändert, du hast nun %token% Tokens!'
  tokenremoved: '&a%player% wurden %token% Tokens entfernt!'
  tokensetted: '&a%player% hat nun %token% Tokens!'
  yourtokens: '&aDu hast %token% Tokens!'
  playerstokens: '&a%player% hat %token% Tokens!'
  playernotfound: '&cSpieler konnte in der Datenbank nicht gefunden werden!'
  villagerspawned: '&aVillager wurde gespawnt.'
  noperm: '&cDazu hast du keine Rechte.'
  notenoughtokens: '&cDu hast nicht genügend Tokens/Geld.'
  bought: '&aDu hast die Permission: %name% gekauft.'