Zum Hauptinhalt springen Zur Suche springen Zur Hauptnavigation springen

🤝 VReferral — Referral & Spielzeit Plugin

Produktinformationen "🤝 VReferral — Referral & Spielzeit Plugin"

Funktion

VReferral motiviert deine Spieler, Freunde auf den Server einzuladen. Empfehlung senden, annehmen, zusammen spielen – sobald beide genug Spielzeit haben, erhalten beide eine Belohnung.

  • 🤝 Empfehlungssystem – Spieler senden Empfehlungsanfragen an neue Spieler, die diese annehmen oder ablehnen
  •  Zeitfenster – Neue Spieler können nur innerhalb eines konfigurierbaren Zeitfensters (z.B. 30 Min Spielzeit) geworben werden – verhindert Missbrauch
  • 🎁 Spielzeit-basierte Belohnungen – Erst wenn beide (Werber und Geworbener) die konfigurierte Spielzeit erreichen (z.B. 8 Stunden), werden Rewards ausgelöst
  • 🏅 Gestaffelte Belohnungen – Bis zu 15 Belohnungsstufen mit eigenen Commands pro Tier – je mehr Spieler geworben werden, desto besser die Belohnung
  • 🎯 Konfigurierbare Rewards – Belohnungen als Console-Commands pro Tier: Items, Geld, Ränge oder beliebige andere Commands
  • 🖥️ Referral-GUI – Übersichtliches GUI-Menü mit Statistiken, ausstehenden Anfragen, Referral senden und Tier-Fortschritt
  • ⏱️ Spielzeit-Tracking – Erfasst die gesamte Spielzeit jedes Spielers in Echtzeit inklusive aktueller Session
  • 🏆 Empfehlungs-Leaderboard – Top 10 der aktivsten Werber mit Gold/Silber/Bronze-Hervorhebung
  • 📊 Spielzeit-Leaderboard – Top 10 der Spieler mit der meisten Spielzeit
  • 👁️ Spielzeit abfragen – Eigene Spielzeit und die anderer Spieler einsehen (mit Permission)
  • 💾 Automatische Speicherung – Spielerdaten werden alle 5 Minuten und beim Verlassen gespeichert
  • 🌐 Mehrsprachig – Deutsch und Englisch mitgeliefert, über Config umschaltbar (inkl. GUI-Titel)

So funktioniert es:

  1. Spieler A sendet eine Empfehlung: /referral  oder über das GUI
  2. Spieler B akzeptiert: /referral accept oder über das GUI
  3. Beide spielen auf dem Server
  4. Sobald beide die konfigurierte Spielzeit erreichen, erhalten beide automatisch ihre gestaffelte Belohnung

Voraussetzungen: Paper 1.21+ · Java 21+


Commands & GUI

Referral-GUI

Das GUI wird mit /referral (ohne Argumente) oder /referral gui geöffnet und bietet:

  • Spieler-Statistiken – Anwerbungen, abgeschlossene Referrals, Spielzeit, wer dich angeworben hat
  • Ausstehende Anfragen – Direkt annehmen oder ablehnen per Knopfdruck
  • Referral senden – Spielername im Chat eingeben, kein Command nötig
  • Tier-Fortschritt – Alle 15 Belohnungsstufen auf einen Blick (abgeschlossen, aktuell, gesperrt)

Empfehlungs-Commands

Hauptcommand: /referral · Aliase: /ref, /vreferral

CommandBeschreibungPermission
/referralReferral-GUI öffnenvrefferal.referral
/referral guiReferral-GUI öffnenvrefferal.referral
/referral Empfehlungsanfrage sendenvrefferal.referral
/referral acceptAusstehende Anfrage annehmenvrefferal.referral
/referral denyAusstehende Anfrage ablehnenvrefferal.referral
/referral topTop-10-Empfehlungs-Leaderboard anzeigenvrefferal.top
/referral helpHilfe anzeigenvrefferal.referral

Spielzeit-Commands

Hauptcommand: /playtime · Alias: /pt

CommandBeschreibungPermission
/playtimeEigene Spielzeit anzeigenvrefferal.playtime
/playtime Spielzeit eines anderen Spielers anzeigenvrefferal.playtime + vrefferal.playtime.others
/playtime topTop-10-Spielzeit-Leaderboard anzeigenvrefferal.playtime

Admin-Commands

CommandBeschreibungPermission
/rfl reloadKonfiguration und Spielerdaten neu ladenvrefferal.admin.reload

Permissions

PermissionBeschreibungStandard
vrefferal.*Alle FunktionenOP
vrefferal.referralEmpfehlungen senden, annehmen, ablehnen, GUItrue
vrefferal.playtimeEigene Spielzeit und Leaderboardtrue
vrefferal.playtime.othersSpielzeit anderer Spieler einsehentrue
vrefferal.topEmpfehlungs-Leaderboard anzeigentrue
vrefferal.admin.reloadConfig und Daten neu ladenOP
vrefferal.admin.resetSpieler-Daten zurücksetzenOP

Datenbank-Anbindung

Optionale Anbindung an MySQL, MariaDB oder PostgreSQL via HikariCP-Connection-Pool.

  • Konfigurierbar in config.yml im Abschnitt database: (ganz unten)
  • Wenn aktiviert und erreichbar, wird die Datenbank exklusiv genutzt
  • Bestehende Daten (YAML/JSON) werden beim ersten Start automatisch migriert und als .migrated umbenannt
  • Ohne DB läuft das Plugin wie bisher mit Datei-Speicherung weiter
database:
  enabled: false
  type: mysql          # mysql | mariadb | postgresql
  host: localhost
  port: 3306
  database: vrefferal
  username: root
  password: ""

0 von 0 Bewertungen

Durchschnittliche Bewertung von 0 von 5 Sternen

Bewerten Sie dieses Produkt!

Teilen Sie Ihre Erfahrungen mit anderen Kunden.