CoreEngineWIKI
DeutschEnglish
ESC
↑ ↓ NavigierenEnter ÖffnenESC Schließen

Economy

CoreEngine bringt eine vollständige Server-Economy mit: Konten, Überweisungen, Admin-Verwaltung und Bestenliste. Chest-Shops und Jobs buchen direkt über diese Konten. Jede Transaktion wird sofort gespeichert und ist gegen gleichzeitige Buchungen abgesichert.

Commands #

CommandSyntaxPermissionDefaultBeschreibung
/balance/balance [spieler] (Alias /bal, /money)economy.balancetrueKontostand anzeigen; andere Spieler: economy.balance.others (true, auch offline)
/pay/pay <spieler> <betrag>economy.paytrueÜberweist Geld an einen Online-Spieler
/baltop/baltop [seite] (Alias /balancetop, /moneytop)economy.baltoptrueBestenliste der reichsten Spieler
/eco give/eco give <spieler> <betrag>economy.adminfalseSchreibt Geld gut (auch offline)
/eco take/eco take <spieler> <betrag>economy.adminfalseBucht Geld ab
/eco set/eco set <spieler> <betrag>economy.adminfalseSetzt den Kontostand exakt
/eco reset/eco reset <spieler>economy.adminfalseSetzt auf das Startguthaben zurück
/eco reload/eco reloadeconomy.adminfalseLädt Config und Kontostände neu
💡

Tipp: Beträge verstehen Komma und Punkt als Dezimaltrennzeichen sowie die Suffixe k und M: 1.5k = 1500. Ungültige Werte (negativ, NaN, unendlich) werden überall abgelehnt.

ℹ️

Hinweis: Die Bestenliste ist bis zu 30 Sekunden gecacht; ein frisch per /eco set gesetzter Rekord taucht also nicht sofort in /baltop auf. Rang 1 bis 3 werden mit 🥇/🥈/🥉 hervorgehoben.

Vault: eigene oder fremde Economy #

CoreEngine arbeitet mit Vault zusammen, in beide Richtungen. Der Schalter ist economy.internal in der config.yml:

  • internal: true (Standard): CoreEngine nutzt seine eigene Economy und meldet sie als Vault-Economy an. Andere Plugins (Shops, Quests, Job-Belohnungen) arbeiten dann auf denselben Konten.
  • internal: false: CoreEngine nutzt die Economy eines anderen Plugins über Vault (z. B. EssentialsX). Alle Geld-Funktionen laufen dann darüber. Ohne gefundenes Economy-Plugin bleibt die interne Economy als Fallback aktiv (Warnung im Log). /baltop ist in dem Modus technisch nicht verfügbar.

Eine Änderung von economy.internal greift erst nach einem Neustart. Auf Folia lädt das offizielle Vault derzeit nicht, dort bleibt automatisch die interne Economy aktiv.

Konten und Rundung #

Jeder Spieler bekommt beim ersten Betreten automatisch ein Konto mit dem Startguthaben. Abfragen zu Spielern ohne Konto zeigen das Startguthaben an, ohne ein Konto anzulegen. Alle Kontostände werden kaufmännisch auf zwei Nachkommastellen gerundet, damit sich Fließkomma-Fehler nie aufaddieren; dieselbe Rundung nutzt auch das Shop-System.

Konfiguration (config.yml) #

YAML
economy:
  # true = eigene Economy (und Vault-Provider). false = fremde Economy
  # über Vault nutzen. Wechsel erfordert einen Neustart.
  internal: true
  # Startguthaben jedes neuen Kontos.
  start-balance: 1000.0
  # Währungsname (Singular bei genau 1.0), Plural und Symbol.
  currency-name: "Coin"
  currency-name-plural: "Coins"
  currency-symbol: "⛃"
  # Obergrenze pro Konto und kleinster erlaubter /pay-Betrag.
  max-balance: 1000000000.0
  min-transfer: 0.01
  # Einträge pro /baltop-Seite.
  baltop-entries-per-page: 10

cooldown:
  commands:
    # Sekunden zwischen zwei /pay-Befehlen (verhindert Spam).
    pay: 1

Komplette Beispiel-Config #

YAML
economy:
  internal: true
  start-balance: 500.0
  currency-name: "Taler"
  currency-name-plural: "Taler"
  currency-symbol: "$"
  max-balance: 10000000.0
  min-transfer: 1.0
  baltop-entries-per-page: 15

cooldown:
  commands:
    pay: 3
← ZurückMob-TeleportWeiter →Chest-Shops