Moneyflow – Das ultimative Eco-System für deinen Server
Version: 1.1.0
Kernkompatibilität: Paper/Spigot 1.20+
Abhängigkeiten: Vault, PlaceholderAPI

Was ist Moneyflow?
Moneyflow ist ein vollständig integriertes wirtschaftliches Eco-System, das Spielerinteraktion, Belohnungen, Statistiken und visuelle Feedback-Elemente auf deinem Server miteinander verbindet. Es wurde entwickelt, um Serverbesitzern maximale Flexibilität zu bieten – sei es für Minigames, eine Citybuild-Welt oder ein RPG-Szenario.

Das Plugin funktioniert modular: Jede Funktion kann über die Konfiguration ein- oder ausgeschaltet werden. Im Kern geht es darum, Spielerwirtschaft (über Vault) zu verwalten, Statistiken zu erfassen und diese Informationen dynamisch sowohl im Chat als auch in der Welt sichtbar zu machen.

Anders als bei reinen Auto-Belohnungs-Systemen legt Moneyflow den Fokus auf manuelle Steuerung, Abfragen und visuelle Darstellung – du entscheidest, wann und wie Wirtschaft bewegt wird.

⚙️ Wie funktioniert das Plugin?
1️⃣ Wirtschaftsverwaltung über Vault
Das Plugin dient als zentrale Schnittstelle für alle wirtschaftlichen Abfragen und Aktionen. Es greift dabei vollständig auf Vault zu – das bedeutet:

• ✅ Du kannst Guthaben abfragen, überweisen, hinzufügen oder abziehen – entweder über Befehle oder über die API.
  
  
• ✅ Alle Änderungen werden sofort in Vault gespeichert und sind damit für alle anderen Plugins sichtbar, die Vault nutzen.
  
  
• ✅ Das Plugin fügt keine automatischen Geldeinnahmen hinzu – alles läuft über gezielte Admin-Aktionen, externe Plugins oder manuelle Spielertransfers.

2️⃣ Platzhalter (PlaceholderAPI-Integration)
Das Plugin registriert eigene Platzhalter, die du überall verwenden kannst, wo PlaceholderAPI unterstützt wird – z. B. in TabLists, Scoreboards, Chat-Formaten oder in Nachrichten.

Beispiele für eigene Platzhalter (du kannst sie beliebig erweitern):



Platzhalter Beschreibung
%moneyflow_balance% Aktuelles Guthaben des Spielers (über Vault)
%moneyflow_balance_formatted% Guthaben mit Währungsname (z.B. "1500.50 Coins")
%moneyflow_currency% Währungsname aus der Config
%moneyflow_symbol% Währungssymbol aus der Config
%moneyflow_earned% Gesamtverdienst des Spielers (2 Dezimalstellen)
%moneyflow_earned_formatted% Gesamtverdienst mit Währungsname
%moneyflow_spent% Gesamtausgaben des Spielers (2 Dezimalstellen)
%moneyflow_spent_formatted% Gesamtausgaben mit Währungsname
%moneyflow_transactions% Anzahl der Transaktionen des Spielers
%moneyflow_rank_balance% Rangplatz des Spielers nach Guthaben (Top 100)
%moneyflow_rank_earned% Rangplatz des Spielers nach Verdienst (Top 100)
%moneyflow_rank_spent% Rangplatz des Spielers nach Ausgaben (Top 100)
%moneyflow_top_balance_1% bis %moneyflow_top_balance_5% Namen der Top 5 im Balance-Ranking
%moneyflow_top_earned_1% bis %moneyflow_top_earned_5% Namen der Top 5 im Earned-Ranking
%moneyflow_top_spent_1% bis %moneyflow_top_spent_5% Namen der Top 5 im Spent-Ranking
3️⃣ Visuelle Darstellung – Hologramme
Mit Moneyflow kannst du dynamische Hologramme erstellen, die sich automatisch aktualisieren, sobald sich Spielerstatistiken ändern.

Einsatzmöglichkeiten:

• Top-10-Ranking als Hologramm an der Spawn-Säule
  
  
• Anzeige von Verdienst und Ausgaben für jeden Spieler

Du kannst Hologramme mit folgendem Befehl erstellen:

/money hologram create BALANCE|EARNED|SPENT
4️⃣ Vault – die wirtschaftliche Basis
Ohne Vault funktioniert das Plugin nicht. Es wird genutzt für:

• Abfragen und Ändern von Spielerguthaben
  
  
• Wirtschaftstransaktionen (zahlen, abziehen, setzen)
  
  
• Integration mit anderen Plugins (z. B. Shop-Plugins, Lootboxen, Rängen)

Du kannst in der config.yml einstellen, ob das Plugin nur Vault oder ein eigenes internes Wirtschaftssystem (optional) nutzen soll.

Wichtige Befehle (Überblick)
Hier sind die wichtigsten Admin- und Spielerbefehle:



Befehl Beschreibung Berechtigung
/money help Zeigt alle verfügbaren Befehle an moneyflow.use
/money [Spieler] Zeigt das Guthaben an (eigenes oder von anderen) moneyflow.use
/pay <Spieler> <Betrag> Überweist Geld an einen anderen Spieler moneyflow.pay
Weitere Admin-Befehle wie /money give, /money set, /money take und /money reload sind in der vollständigen Dokumentation aufgeführt.

⚠️ Wichtige Hinweise für Admins

• Stelle sicher, dass Vault und PlaceholderAPI korrekt installiert und aktuell sind.
  
  
• Alle Nachrichten, Zahlenwerte und Schwellenwerte sind in der config.yml und den messages.yml-Dateien anpassbar.
  
  
• Bei Problemen oder Fragen zur Installation nutze bitte unseren Discord-Server (siehe unten).

Support & Kontakt
Alle wichtigen Kanäle rund um Moneyflow findest du auf unserem Discord-Server:



Bereich Beschreibung
Support-Anfragen Hilfe bei Installation, Konfiguration oder Nutzung des Plugins
Bug-Reports Fehler und Probleme melden – bitte mit latest.log und config.yml
Updates & Ankündigungen Erfahre als Erster von neuen Versionen und wichtigen Änderungen
Community Austausch mit anderen Serverbetreibern, Tipps und Tricks
Tritt uns bei: https://discord.gg/ZmjmwBbrgR

Viel Erfolg mit Moneyflow auf deinem Server!
Wir freuen uns auf dich in unserer Community!