MiningRewards — Plugin-Beschreibung

Mit MiningRewards belohnst du Spieler für den Abbau ausgewählter Blöcke auf Spigot- und Paper-Servern. Erstelle und passe die Belohnungen direkt im Spiel an – alle Einstellungen findest du im Menü.

Belohnungen können Gegenstände, Geld, Erfahrung, Trankeffekte und Verzauberungen vergeben. Sie können außerdem Befehle ausführen, Werkzeuge reparieren, Blöcke ersetzen oder umwandeln, zusammenhängende Erzadern abbauen und die Umgebung scannen. Mining Shield bietet vorübergehenden Schutz; Auto Pickup legt abgebaute Gegenstände direkt ins Inventar.

✅ Belohnungen erstellen und verwalten

• GUI-Verwaltung – Erstelle, bearbeite, betrachte, sortiere und entferne Belohnungen direkt in Inventarmenüs.
  
• Schrittweiser Belohnungsassistent – Konfiguriere jede Belohnung mit einem Assistenten mit getrennten Schritten für:
  
  • Belohnungsname
    
  • Belohnungstyp
    
  • Auslösende Blöcke
    
  • Belohnungsspezifische Einstellungen
    
  • Aktivierungschance
    
  • VIP-Zugriff
    
  • Deaktivierte Welten
    
  • WorldGuard-Regionen
    
  • Normale Blockdrops
    
  
  
• Separate Belohnungsdateien – Jede Belohnung wird in einer eigenen Datei im Ordner Rewards gespeichert.
  
• Sichere Belohnungsnamen – Namen werden vor dem Erstellen, Umbenennen, Laden oder Löschen von Belohnungen geprüft.
  
• Automatische Konfigurationsupdates – Fehlende Konfigurations- und Nachrichteneinträge werden bei Bedarf beim Start ergänzt.
  

✅ 20 Belohnungstypen
Diese Belohnungsarten stehen dir zur Verfügung:

• Gegenstand droppen – Gib dem Spieler einen zusätzlichen konfigurierbaren Gegenstand.
  
• Mehrfachdrop – Gib mehrere Exemplare des Gegenstands des abgebauten Blocks.
  
• Geld vergeben – Belohne den Spieler über Vault mit Serverwährung.
  
• Level vergeben – Vergib ein oder mehrere Erfahrungslevel.
  
• Erfahrung vergeben – Vergib eine konfigurierbare Menge direkter Erfahrung.
  
• Bonustruhe spawnen – Spawne eine Truhe mit konfigurierten Belohnungsgegenständen.
  
• Trankeffekt vergeben – Wende einen gewählten Trankeffekt für die konfigurierte Dauer an.
  
• Befehl – Führe bei Aktivierung einen oder mehrere Serverbefehle aus. Unterstützt Platzhalter wie %PLAYER% und %BLOCK%.
  
• Werkzeug reparieren – Repariere das zum Abbauen verwendete Werkzeug.
  
• Explosionsbelohnung – Erzeuge eine Explosion an der Position des abgebauten Blocks.
  
• Block erneuern – Ersetze den abgebauten Block durch denselben Blocktyp.
  
• Erzwechsel – Ersetze den abgebauten Block durch ein zufällig gewähltes konfiguriertes Erz.
  
• Verzauberungsbelohnung – Füge dem Abbauwerkzeug eine gewählte Verzauberung mit Level hinzu.
  
• Zufälligen Effekt vergeben – Gib dem Spieler einen zufälligen Effekt aus einer konfigurierten Liste.
  
• Erzader abbauen – Baue verbundene Erzblöcke automatisch mit konfigurierbarem Radius und Blocklimit ab.
  
• Goldener Apfel – Wende konfigurierbare Regeneration, Absorption und Nahrungsvorteile der Goldener-Apfel-Belohnung an.
  
• Erzschmelzer – Ersetze rohe Erzdrops durch Barren. Glück, Ofenerfahrung und visuelle Effekte sind konfigurierbar. Unterstützt Eisen, Gold, Kupfer und antiken Schrott.
  
• Sucherimpuls – Scanne geladenes Gelände nach gewählten Erzen und zeige dem Spieler einen privaten Partikelkompass. Radius, Dauer, Zielerzgruppen, maximale Zielzahl und ein Modus für nur verborgene Erze sind konfigurierbar.
  
• Bergbauschild – Vergib einen vorübergehenden Schild mit konfigurierbaren Ladungen, Dauer, Schadensreduktion und visuellen Effekten. Wiederholte Aktivierungen ergänzen Ladungen bis zur Sicherheitsgrenze und behalten den stärkeren Schutz.
  
• Automatisches Aufheben – Leite Drops des abgebauten Blocks direkt ins Spielerinventar. Sammle optional Blockerfahrung sofort, wähle den Abwurf überschüssiger Gegenstände beim Spieler oder Block und aktiviere Aufhebeeffekte. Enthält eigene Assistenten- und Editoreinstellungen.
  

✅ Belohnungsbedingungen und Chancensteuerung

• Mehrere auslösende Blöcke – Weise einer Belohnung mehrere Blocktypen zu, statt für jeden Block eine eigene zu erstellen.
  
• Individuelle Aktivierungschance – Konfiguriere die Chance jeder Belohnung unabhängig von 0.01% bis 100%.
  
• Schnelle Chancensteuerung – Passe die Chance direkt in der GUI mit den Schrittgrößen 0.01%, 0.1%, 1% und 10% an.
  
• Mehrere Belohnungen pro Block – Weise demselben Block mehrere Belohnungen mit eigenen Chancen und Einschränkungen zu.
  
• Normale Drops steuern – Entscheide, ob der abgebaute Block nach Aktivierung weiterhin seinen normalen Gegenstand fallen lässt. Auto Pickup lässt normale Drops aktiviert, um sie sammeln zu können.
  

✅ Globale Einstellungen und Missbrauchsschutz

• Globaler Belohnungsschalter – Aktiviere oder deaktiviere Belohnungen für normale Spieler, ohne konfigurierte Belohnungen zu löschen.
  
• Administratorausnahme – Erlaube berechtigten Teammitgliedern weiterhin Belohnungen, während der globale Schalter aus ist.
  
• Schutz platzierter Blöcke – Verhindere, dass Spieler eigene Blöcke wiederholt platzieren und abbauen, um Belohnungen zu farmen.
  
• Dauerhafte Schutzdatenbank – Positionen spielerplatzierter Blöcke werden in SQLite gespeichert und bleiben nach Neustarts geschützt.
  

✅ Belohnungssicherheit und Leistungssteuerung

• Belohnungslimit pro Block – Begrenze die Belohnungen pro Blockabbau. Der Standard ist 3, konfigurierbar über Safety.MaxRewardsPerBlockBreak.
  
• Spieler-Auslöseabklingzeit – Setze optional eine Verzögerung in Ticks zwischen erfolgreichen Auslösungen pro Spieler. Standardmäßig deaktiviert.
  
• Kreativmodus-Steuerung – Überspringe standardmäßig Belohnungen für Kreativspieler, mit konfigurierbarem Schalter.
  
• Erzaderlimits – Kombiniere Radius und Blocklimit jeder Belohnung mit einem globalen Maximum abgebauter Blöcke. Zusätzliche Blöcke lösen Abbauereignisse aus, damit Schutzplugins sie abbrechen können, ohne rekursive Belohnungsketten zu starten.
  
• Explosionssteuerung – Konfiguriere maximale Explosionsstärke und ob Belohnungsexplosionen Blöcke beschädigen dürfen. Blockschaden ist standardmäßig deaktiviert.
  
• Verzauberungslimits – Verwende standardmäßig normale Levelgrenzen mit optionaler Einstellung für unsichere Verzauberungen.
  
• Befehlsbeschränkungen – Lege maximale Befehlslänge und gesperrte Befehlspräfixe für Befehlsbelohnungen fest.
  
• Belohnungsprüfung – Überspringe Belohnungen mit fehlenden oder ungültigen Pflichtwerten. Laufzeitfehler werden protokolliert und die fehlgeschlagene Belohnung übersprungen.
  

✅ Weltbeschränkungen

• Global deaktivierte Welten – Deaktiviere Abbaubelohnungen in ausgewählten Welten über die globalen Einstellungen.
  
• Pro Belohnung deaktivierte Welten – Deaktiviere einzelne Belohnungen in ausgewählten Welten über eine mehrseitige GUI.
  

✅ WorldGuard-Regionsunterstützung
Mit WorldEdit und WorldGuard kannst du Belohnungen auf bestimmte Regionen beschränken:

• Erlaubte Regionen – Erlaube Aktivierung nur innerhalb ausgewählter WorldGuard-Regionen.
  
• Deaktivierte Regionen – Verhindere die Aktivierung innerhalb ausgewählter Regionen.
  
• Regionsverwaltungs-GUI – Füge erlaubte oder deaktivierte Regionen direkt in Inventarmenüs hinzu, entferne sie oder setze sie zurück.
  

✅ Belohnungsberechtigungen

• Optionale VIP-Belohnungen – Markiere einzelne Belohnungen als berechtigungsgeschützt.
  
• Globale Berechtigungspflicht – Verlange eine Berechtigung für jede konfigurierte Belohnung.
  
• Berechtigung für alle Belohnungen – Gewähre Zugriff auf alle berechtigungsgeschützten Belohnungen mit miningrewards.reward.all.
  
• Einzelbelohnungsberechtigung – Gewähre Zugriff auf eine ausgewählte Belohnung mit miningrewards.reward.<reward_name>.
  
• Getrennte Verwaltungsrechte – Steuere Hauptmenü, Belohnungsliste, Vorschau, Assistent, Editor, Entfernung und globale Einstellungen unabhängig.
  

✅ Belohnungsliste und Vorschau-GUI

• Mehrseitige Belohnungsliste – Durchsuche alle konfigurierten Belohnungen in einem geordneten Inventarmenü.
  
• Detaillierte Vorschau – Betrachte Typ, Auslöseblöcke, Chance, VIP-Status, normale Drops, Regionsbeschränkungen und spezifische Werte.
  
• Sortierung – Wechsle die alphabetische Sortierung zwischen A–Z und Z–A.
  
• Schnelles Bearbeiten – Öffne den vollständigen Editor mit Linksklick.
  
• Sichere Entfernung – Entferne eine Belohnung über eine geschützte Umschalt + Rechtsklick Bestätigung.
  

✅ Vollständiger Belohnungseditor
Bearbeite bestehende Belohnungen, ohne sie neu anlegen zu müssen. Je nach Typ kannst du Folgendes ändern:

• Belohnungsname
  
• Auslösende Blöcke
  
• Aktivierungschance
  
• Belohnungsspezifische Werte
  
• VIP-Anforderung
  
• Normale Blockdrops
  
• Deaktivierte Welten
  
• WorldGuard-Regionen
  

✅ Effekte, Sounds und Nachrichten

• Aktivierungseffekte – Zeige konfigurierbare visuelle Effekte bei Aktivierung.
  
• Aktivierungssounds – Spiele nach einer erfolgreichen Belohnung einen konfigurierbaren Sound.
  
• Spielernachrichten – Sende Belohnungsinformationen an den auslösenden Spieler.
  
• Globale Ankündigungen – Kündige erfolgreiche Belohnungen anderen Spielern online an.
  
• Konsolennachrichten – Protokolliere erfolgreiche Aktivierungen in der Serverkonsole.
  
• Unabhängige Steuerung – Aktiviere Spielernachrichten, globale Ankündigungen und Konsolennachrichten getrennt.
  
• Anpassbare Nachrichten – Passe Präfixe, Nachrichten, Werte und Platzhalter an in Messages.yml.
  

✅ Befehle und Verwaltung
Öffne mit /miningrewards oder dem Alias /mr das Hauptmenü und die Verwaltungswerkzeuge:

• /miningrewards
  
• /miningrewards list
  
• /miningrewards create
  
• /miningrewards create <reward_name>
  
• /miningrewards edit <reward_name>
  
• /miningrewards remove <reward_name>
  
• /miningrewards globalsettings
  

Die Tab-Vervollständigung hilft dir bei der Eingabe der Unterbefehle.

✅ Integrationen und Kompatibilität

• Vault-Wirtschaft – Geldbelohnungen werden mit Vault und einem kompatiblen Wirtschaftsanbieter verfügbar.
  
• WorldEdit und WorldGuard – Optionale regionsbasierte Belohnungsbeschränkungen.
  
• SQLite – Dauerhafte Speicherung des Schutzes platzierter Blöcke.
  
• Spigot und Paper – Entwickelt für Server mit Spigot/Paper API 26.2 und Java 25.