MiningRewards — Pluginbeschrijving

Met MiningRewards beloon je spelers voor het delven van bepaalde blokken op Spigot- en Paper-servers. Je maakt en bewerkt beloningen vanuit een menu in het spel, met alle instellingen bij de hand.

Beloningen kunnen voorwerpen, geld, XP, toverdrankeffecten en betoveringen geven. Ze kunnen ook commando’s uitvoeren, gereedschap repareren, blokken vervangen of omvormen, aaneengesloten ertsaders delven en de omgeving scannen. Mining Shield biedt tijdelijke bescherming en Auto Pickup plaatst gedolven voorwerpen direct in de inventaris.

✅ Beloningen maken en beheren

• Beheer via GUI – Maak, bewerk, bekijk, sorteer en verwijder beloningen direct vanuit inventarismenu's.
  
• Stapsgewijze beloningsmaker – Stel elke beloning in met een begeleide maker met aparte stappen voor:
  
  • Beloningsnaam
    
  • Beloningstype
    
  • Activerende blokken
    
  • Beloningsspecifieke instellingen
    
  • Activeringskans
    
  • VIP-toegang
    
  • Uitgeschakelde werelden
    
  • WorldGuard-regio's
    
  • Normale blokdrops
    
  
  
• Aparte beloningsbestanden – Elke beloning wordt in een eigen bestand opgeslagen in de map Rewards.
  
• Veilige beloningsnamen – Namen worden gecontroleerd voordat beloningen worden gemaakt, hernoemd, geladen of verwijderd.
  
• Automatische configuratie-updates – Ontbrekende configuratie- en berichtvermeldingen worden bij opstarten waar nodig toegevoegd.
  

✅ 20 beloningstypen
Je kunt kiezen uit de volgende soorten beloningen:

• Voorwerp laten vallen – Geef de speler een extra instelbaar voorwerp.
  
• Meervoudige drop – Geef meerdere exemplaren van het voorwerp van het gemijnde blok.
  
• Geld geven – Beloon de speler met servergeld via Vault.
  
• Niveau geven – Geef één of meer ervaringsniveaus.
  
• Ervaring geven – Geef een instelbare hoeveelheid directe ervaring.
  
• Bonuskist spawnen – Spawn een kist met ingestelde beloningsvoorwerpen.
  
• Drankeffect geven – Pas een geselecteerd drankeffect toe voor de ingestelde duur.
  
• Commando – Voer bij activering één of meer servercommando's uit. Ondersteunt plaatsaanduidingen zoals %PLAYER% en %BLOCK%.
  
• Gereedschap repareren – Repareer het gereedschap waarmee het blok is gemijnd.
  
• Explosiebeloning – Maak een explosie op de plaats van het gemijnde blok.
  
• Blok vernieuwen – Vervang het gemijnde blok door hetzelfde bloktype.
  
• Erts wisselen – Vervang het gemijnde blok door een willekeurig geselecteerd ingesteld erts.
  
• Betoveringsbeloning – Voeg een gekozen betovering en niveau toe aan het mijnbouwgereedschap.
  
• Willekeurig effect geven – Geef de speler één willekeurig effect uit een ingestelde lijst.
  
• Aderuitbarsting – Mijn verbonden ertsblokken automatisch met instelbare straal en bloklimieten.
  
• Gouden appel – Pas instelbare regeneratie, absorptie en voedselvoordelen toe op basis van de goudenappelbeloning.
  
• Ertssmelter – Vervang ruwe ertsdrops door staven. Geluk, ovenervaring en visuele effecten zijn instelbaar. Ondersteunt ijzer, goud, koper en oeroud puin.
  
• Prospectorpuls – Scan geladen terrein naar gekozen ertsen en toon een privédeeltjeskompas. Straal, duur, ertsgroepen, maximaal aantal doelen en alleen-verborgenmodus zijn instelbaar.
  
• Mijnschild – Geef een tijdelijk schild met instelbare ladingen, duur, schadevermindering en visuele effecten. Herhaalde activeringen voegen ladingen toe tot een veiligheidslimiet en behouden de sterkste bescherming.
  
• Automatisch oppakken – Stuur drops van het gemijnde blok direct naar de inventaris. Verzamel optioneel blokervaring direct, kies of overtollige voorwerpen bij de speler of het blok vallen en schakel oppakeffecten in. Inclusief aparte maker- en editorinstellingen.
  

✅ Beloningsvoorwaarden en kansbeheer

• Meerdere activerende blokken – Wijs meerdere bloktypen toe aan één beloning in plaats van een aparte beloning per blok.
  
• Individuele activeringskans – Stel de kans van elke beloning apart in, van 0.01% tot 100%.
  
• Snelle kansbediening – Pas de kans direct in de GUI aan met stappen van 0.01%, 0.1%, 1% en 10%.
  
• Meerdere beloningen per blok – Wijs meerdere beloningen toe aan hetzelfde blok, elk met eigen kans en beperkingen.
  
• Normale drops beheren – Bepaal of het gemijnde blok na activering nog zijn normale voorwerp laat vallen. Auto Pickup houdt normale drops aan om ze te kunnen verzamelen.
  

✅ Globale instellingen en bescherming tegen misbruik

• Globale beloningsschakelaar – Schakel verwerking voor gewone spelers in of uit zonder ingestelde beloningen te verwijderen.
  
• Beheeruitzondering – Laat bevoegde medewerkers beloningen ontvangen terwijl de globale schakelaar uitstaat.
  
• Bescherming van geplaatste blokken – Voorkom dat spelers eigen blokken herhaald plaatsen en breken om beloningen te verzamelen.
  
• Blijvende beschermingsdatabase – Locaties van door spelers geplaatste blokken worden in SQLite opgeslagen en blijven na herstart beschermd.
  

✅ Beloningsveiligheid en prestatiebeheer

• Beloningslimiet per blok – Beperk hoeveel beloningen per gebroken blok activeren. Standaard is dit 3, instelbaar via Safety.MaxRewardsPerBlockBreak.
  
• Wachttijd per speler – Stel optioneel een vertraging in ticks in tussen succesvolle activeringen per speler. Standaard uitgeschakeld.
  
• Creatievemodusbeheer – Sla beloningen voor Creative-spelers standaard over, met een instelbare schakelaar.
  
• Aderuitbarstingslimieten – Combineer straal en bloklimiet van elke beloning met een globaal maximum gemijnde blokken. Extra blokken geven breekevents die beschermingsplugins kunnen annuleren, zonder recursieve beloningsketens.
  
• Explosiebeheer – Stel maximale explosiekracht en blokschade door beloningsexplosies in. Blokschade staat standaard uit.
  
• Betoveringslimieten – Gebruik standaard normale niveaugrenzen met een optie voor onveilige betoveringen.
  
• Commandobeperkingen – Stel maximale commandolengte en geblokkeerde commandoprefixen in voor commandobeloningen.
  
• Beloningsvalidatie – Sla beloningen met ontbrekende of ongeldige vereiste waarden over. Uitvoeringsfouten worden gelogd en de mislukte beloning wordt overgeslagen.
  

✅ Wereldbeperkingen

• Globaal uitgeschakelde werelden – Schakel beloningen voor het delven van blokken uit in gekozen werelden via de globale instellingen.
  
• Werelden per beloning uitschakelen – Schakel één beloning uit in gekozen werelden via een GUI met pagina's.
  

✅ WorldGuard-regio-ondersteuning
Met WorldEdit en WorldGuard kun je beloningen per regio beperken:

• Toegestane regio's – Sta activering alleen toe binnen geselecteerde WorldGuard-regio's.
  
• Uitgeschakelde regio's – Voorkom activering binnen geselecteerde regio's.
  
• Regiobeheer-GUI – Voeg toegestane of uitgeschakelde regio's toe, verwijder of reset ze direct in inventarismenu's.
  

✅ Beloningsrechten

• Optionele VIP-beloningen – Markeer individuele beloningen als beschermd door rechten.
  
• Globale rechtenvereiste – Vereis een recht voor elke ingestelde beloning.
  
• Recht voor alle beloningen – Geef toegang tot alle beschermde beloningen met miningrewards.reward.all.
  
• Individueel beloningsrecht – Geef toegang tot één gekozen beloning met miningrewards.reward.<reward_name>.
  
• Aparte beheerrechten – Beheer toegang tot hoofdmenu, lijst, voorbeeld, maker, editor, verwijdering en globale instellingen afzonderlijk.
  

✅ Beloningslijst en voorbeeld-GUI

• Beloningslijst met pagina's – Bekijk alle ingestelde beloningen in een geordend inventarismenu.
  
• Gedetailleerd voorbeeld – Bekijk type, blokken, kans, VIP, normale drops, regiobeperkingen en specifieke waarden.
  
• Sorteren – Wissel de alfabetische volgorde tussen A–Z en Z–A.
  
• Snel bewerken – Open de volledige editor met Linksklik.
  
• Veilig verwijderen – Verwijder een beloning via een beschermde bevestiging met Shift + rechtsklik.
  

✅ Volledige beloningseditor
Bewerk bestaande beloningen zonder ze opnieuw te maken. Afhankelijk van het type kun je het volgende aanpassen:

• Beloningsnaam
  
• Activerende blokken
  
• Activeringskans
  
• Beloningsspecifieke waarden
  
• VIP-vereiste
  
• Normale blokdrops
  
• Uitgeschakelde werelden
  
• WorldGuard-regio's
  

✅ Effecten, geluiden en berichten

• Activeringseffecten – Toon instelbare visuele effecten bij activering.
  
• Activeringsgeluiden – Speel een instelbaar geluid na een succesvolle beloning.
  
• Spelerberichten – Stuur beloningsinformatie naar de speler die deze activeerde.
  
• Globale aankondigingen – Kondig succesvolle beloningen aan bij andere online spelers.
  
• Consoleberichten – Log succesvolle activeringen in de serverconsole.
  
• Onafhankelijke bediening – Schakel spelerberichten, globale aankondigingen en consoleberichten afzonderlijk in of uit.
  
• Bewerkbare berichten – Pas prefixen, berichten, waarden en plaatsaanduidingen aan in Messages.yml.
  

✅ Commando's en beheer
Open met /miningrewards of de alias /mr het hoofdmenu en de beheertools:

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

Tabaanvulling helpt je bij het invoeren van de subcommando’s.

✅ Integraties en compatibiliteit

• Vault-economie – Geldbeloningen zijn beschikbaar met Vault en een compatibele economieprovider.
  
• WorldEdit en WorldGuard – Optionele regiogebonden beloningsbeperkingen.
  
• SQLite – Blijvende opslag voor bescherming van geplaatste blokken.
  
• Spigot en Paper – Ontworpen voor servers met Spigot/Paper API 26.2 en Java 25.