Alle documentatie
PLUGIN-WIKI

MiningRewards — Configuratie

Maak beloningen voor het delven van blokken en stel de voorwaarden en effecten in via een menu in het spel.

Plugin bekijken

Configuratie

Informatie over de huidige versie
Nieuwste versie
4.5.0
Minecraft
26.1.x, 26.2.x, 26.3.x
Platforms
Spigot, Paper, Folia, Purpur
Minimale Java-versie
25+
Versienotities
Versie 4.5.0Laatst bijgewerkt: 19-10-2026 10:39
Configuratie

Bestanden en blijvende gegevens
Config.yml bevat globale bediening en gegenereerde Safety-waarden. Messages.yml bevat chat-/consolesjablonen en schakelaars. Rewards/<reward_name>.yml is één beloning; de bestandsnaam bepaalt de naam. placedBlocks.db bewaart wereldcoördinaten van geplaatste blokken. SQLite bewaart geen definities en synchroniseert niet tussen servers.

Globale instellingen
ClaimingRewardsStatus beheert gewone verwerking; claimingrewardsbypass omzeilt alleen die schakelaar. PermissionRequired vereist wereldwijd rechten. DisabledForPlacedBlocks: true blokkeert beloningen van geregistreerde spelersblokken ondanks onduidelijk commentaar. DisabledWorlds is een optionele, eerst lege lijst. ParticleStatus/Particle en SoundStatus/Sound beheren algemene effecten. Laat CfgVersion staan.

Veiligheidslimieten
Safety wordt bij opstarten toegevoegd en ontbreekt in de kleine meegeleverde Config.yml. MaxRewardsPerBlockBreak: 1–20 (standaard 3); PlayerTriggerCooldownTicks: 0–1200 (0 schakelt uit); SkipCreativeMode: true. MaxVeinBurstBlocks: 1–256 (standaard 64). MaxExplosionPower: standaard 4, begrensd op 0–16; ExplosionBlockDamage: false. AllowUnsafeEnchantments: false. Command.MaxLength: 1–1024 (standaard 256). BlockedPrefixes bevat standaard op, deop, stop, restart en reload.

Code · Platte tekst

Safety:
  MaxRewardsPerBlockBreak: 3
  PlayerTriggerCooldownTicks: 0
  SkipCreativeMode: true
  MaxVeinBurstBlocks: 64
  MaxExplosionPower: 4.0
  ExplosionBlockDamage: false
  AllowUnsafeEnchantments: false
  Command:
    MaxLength: 256
    BlockedPrefixes:
    - op
    - deop
    - stop
    - restart
    - reload


Commandobeloningen draaien als console en vervangen %PLAYER% en %BLOCK%. Voorste schuine strepen worden verwijderd; meerdere regels geweigerd. BlockedPrefixes vergelijkt precies het eerste woord zonder hoofdletterverschil; geen algemene prefix- of rechtenfirewall. Naamruimte-aliassen moeten apart worden geblokkeerd. Geef bewerking alleen aan vertrouwde medewerkers.

Berichten en effecten
Messages.yml ondersteunt &-kleuren en &#RRGGBB-HEX. BROADCAST_REWARD_TO_PLAYER, BROADCAST_REWARD en BROADCAST_REWARD_CONSOLE zijn onafhankelijk. Typesleutels bepalen persoonlijke berichten en _BROADCAST aankondigingen. Behoud plaatsaanduidingen. UPDATE_CHECKER_ON_JOIN en miningrewards.update beheren meldingen bij inloggen. Niet alle GUI-labels worden hiermee vertaald.

Opstarten voegt ontbrekende MINING_SHIELD, MINING_SHIELD_BROADCAST, MINING_SHIELD_ABSORB, AUTO_PICKUP en AUTO_PICKUP_BROADCAST toe. Het supplement toont de standaardwaarden. Algemene ParticleStatus/SoundStatus staan los van PlayEffects/PlaySound per beloning. Niet elk type heeft een activeringsbericht; Golden Apple hier niet.

Code · Platte tekst

MINING_SHIELD: '&6[REWARD] &bMining Shield activated with &e%CHARGES% &bcharges for
  &e%DURATION%s&b from %BROKEN% (%CHANCE%%)'
MINING_SHIELD_BROADCAST: '&6[REWARD] &7%PLAYER% activated Mining Shield with %CHARGES%
  charges for %DURATION%s from %BROKEN% (%CHANCE%%)'
MINING_SHIELD_ABSORB: '&3[MINING SHIELD] &7Absorbed &b%REDUCTION%%% &7damage. &e%CHARGES%
  &7charge(s) left.'
AUTO_PICKUP: '&6[REWARD] &bAuto Pickup is active. Drops from %BROKEN% go directly
  to your inventory (%CHANCE%%)'
AUTO_PICKUP_BROADCAST: '&6[REWARD] &7%PLAYER% activated Auto Pickup from %BROKEN%
  (%CHANCE%%)'


Gemeenschappelijke velden
Hieronder staat het gemeenschappelijke schema. Broken_block is een lijst Minecraft-materialen; Chance een percentage; VIPAccess beheert rechten; Drop_broken_block normale drops waar ondersteund. DisabledWorlds is een wereldnamenlijst. WorldGuardRegion.Enabled/Disabled koppelt regio-ID's aan World. Behoud Engelse technische sleutels en identificaties.

Code · Platte tekst

Reward_type: AUTO_PICKUP
Broken_block:
- STONE
- DEEPSLATE
Chance: 25.0
VIPAccess: false
Drop_broken_block: true
DisabledWorlds: []
WorldGuardRegion:
  Enabled: {}
  Disabled: {}


Code · Platte tekst

DisabledWorlds:
- lobby
WorldGuardRegion:
  Enabled:
    mine:
      World: world
  Disabled:
    spawn:
      World: world


Namen moeten uniek zijn zonder hoofdletterverschil, niet leeg, maximaal 48 tekens, zonder spaties aan de randen, '..', besturingstekens of ongeldige bestandsnaamtekens. Systeemnamen worden geweigerd. Edit/remove vereist de opgeslagen hoofdletters. Hernoem liefst via de GUI; het afgeleide beloningsrecht verandert ook.

Typspecifieke velden
Hier staan alle 20 typen en gelezen/opgeslagen sleutels. De lijsten zijn naslag, geen volledige bestanden. Gebruik GUI-serialisatie voor Bukkit ItemStacks, kistvoorwerpen en toverdrankeffecten. Typen zonder extra velden vereisen ook het gemeenschappelijke schema.

Item_to_drop bewaart de in de GUI gekozen ItemStack. Chest_items koppelt vakken 0–26 aan geserialiseerde ItemStacks.

Multiply is het aantal kopieën; Money het Vault-bedrag; Level gegeven niveaus voor GIVE_LEVEL of betoveringsniveau voor ENCHANTMENT_REWARD; Exp directe XP-punten. Power is explosiekracht, ook globaal begrensd. Enchantment accepteert ondersteunde identificaties.

GIVE_POTION_EFFECT bewaart Potion_effect als Bukkit-object; de alternatieve vorm gebruikt Potion_effect_type, Potion_effect_duration en Potion_effect_amplifier. Die duur is ticks, geen seconden. GIVE_RANDOM_EFFECT gebruikt Effects, Duration in seconden (1–3600) en Amplifier (0–255); 0 is niveau I.

OreChances koppelt gewichten aan ondersteunde ertsen; de editor normaliseert ze. Delay is seconden (0–3600). RENEW_BLOCK en CYCLE_ORE vervangen alleen als er nog lucht is en de chunk geladen blijft. Ze onderdrukken daarbij normale drops.

Golden Apple's RegenDuration en AbsorptionDuration zijn ticks (1–72000), versterking 0–255. FeedEnabled beheert FoodPoints en Saturation (0–20); PlaySound geluiden. RespectFortune, DropExperience en PlayEffects van Ore Smelter zijn booleaans. De eigen gesmolten drops zijn niet het normale event dat Auto Pickup verzamelt.

DROP_ITEM — Voorwerp laten vallen
Code · Platte tekst

Reward_type: DROP_ITEM
Item_to_drop


MULTIPLE_DROP — Meervoudige drop
Code · Platte tekst

Reward_type: MULTIPLE_DROP
Multiply


GIVE_MONEY — Geld geven
Code · Platte tekst

Reward_type: GIVE_MONEY
Money


GIVE_LEVEL — Niveau geven
Code · Platte tekst

Reward_type: GIVE_LEVEL
Level


GIVE_EXPERIENCE — Ervaring geven
Code · Platte tekst

Reward_type: GIVE_EXPERIENCE
Exp


SPAWN_BONUS_CHEST — Bonuskist spawnen
Code · Platte tekst

Reward_type: SPAWN_BONUS_CHEST
Chest_items


GIVE_POTION_EFFECT — Drankeffect geven
Code · Platte tekst

Reward_type: GIVE_POTION_EFFECT
Potion_effect
Potion_effect_type
Potion_effect_duration
Potion_effect_amplifier


COMMAND — Commando
Code · Platte tekst

Reward_type: COMMAND
Command


REPAIR_TOOL — Gereedschap repareren
Code · Platte tekst

Reward_type: REPAIR_TOOL


EXPLOSION_REWARD — Explosiebeloning
Code · Platte tekst

Reward_type: EXPLOSION_REWARD
Power


RENEW_BLOCK — Blok vernieuwen
Code · Platte tekst

Reward_type: RENEW_BLOCK


CYCLE_ORE — Erts wisselen
Code · Platte tekst

Reward_type: CYCLE_ORE
OreChances
Delay


ENCHANTMENT_REWARD — Betoveringsbeloning
Code · Platte tekst

Reward_type: ENCHANTMENT_REWARD
Enchantment
Level


GIVE_RANDOM_EFFECT — Willekeurig effect geven
Code · Platte tekst

Reward_type: GIVE_RANDOM_EFFECT
Effects
Duration
Amplifier


VEIN_BURST — Aderuitbarsting
Code · Platte tekst

Reward_type: VEIN_BURST
Radius
MaxBlocks


GOLDEN_APPLE — Gouden appel
Code · Platte tekst

Reward_type: GOLDEN_APPLE
RegenAmplifier
RegenDuration
AbsorptionAmplifier
AbsorptionDuration
FeedEnabled
FoodPoints
Saturation
PlaySound


ORE_SMELTER — Ertssmelter
Code · Platte tekst

Reward_type: ORE_SMELTER
RespectFortune
DropExperience
PlayEffects


PROSPECTOR_PULSE — Prospectorpuls
Code · Platte tekst

Reward_type: PROSPECTOR_PULSE
ScanRadius
MaxTargets
DurationSeconds
HiddenOnly
TargetOres


MINING_SHIELD — Mijnschild
Code · Platte tekst

Reward_type: MINING_SHIELD
Charges
DurationSeconds
DamageReductionPercent
PlayEffects


AUTO_PICKUP — Automatisch oppakken
Code · Platte tekst

Reward_type: AUTO_PICKUP
CollectExperience
OverflowAtPlayer
PlayEffects


Beloningsvoorbeelden
Dit zijn volledige voorbeelden onder de getoonde naam in Rewards/. Geen automatisch gemaakte standaardbeloningen. Herstart na handmatig wijzigen; er is geen eigen reload-subcommando. De GUI slaat bestanden direct op.

Rewards/pickup_stone.yml

Code · Platte tekst

Reward_type: AUTO_PICKUP
Broken_block:
- STONE
- DEEPSLATE
Chance: 100.0
VIPAccess: false
Drop_broken_block: true
DisabledWorlds: []
CollectExperience: true
OverflowAtPlayer: true
PlayEffects: true



Rewards/miner_shield.yml

Code · Platte tekst

Reward_type: MINING_SHIELD
Broken_block:
- IRON_ORE
- DEEPSLATE_IRON_ORE
Chance: 5.0
VIPAccess: false
Drop_broken_block: true
DisabledWorlds: []
Charges: 3
DurationSeconds: 60
DamageReductionPercent: 100
PlayEffects: true



Rewards/find_diamonds.yml

Code · Platte tekst

Reward_type: PROSPECTOR_PULSE
Broken_block:
- STONE
- DEEPSLATE
Chance: 1.0
VIPAccess: false
Drop_broken_block: true
DisabledWorlds: []
ScanRadius: 12
MaxTargets: 3
DurationSeconds: 8
HiddenOnly: true
TargetOres:
- DIAMOND
- EMERALD



Rewards/announce_diamond.yml

Code · Platte tekst

Reward_type: COMMAND
Broken_block:
- DIAMOND_ORE
- DEEPSLATE_DIAMOND_ORE
Chance: 10.0
VIPAccess: false
Drop_broken_block: true
DisabledWorlds: []
Command:
- say %PLAYER% mined %BLOCK%!



Volledige meegeleverde bestanden
Deze blokken zijn de exacte meegeleverde Config.yml en Messages.yml. Safety en het supplement komen bij opstarten erbij. Voeg samen met bestaande secties zonder dubbele sleutels en behoud Rewards/ en de blokdatabase.

Config.yml

Code · Platte tekst

#Messages version
#DO NOT CHANGE IT MANUALLY!
CfgVersion: 1.4

#Status of the claim rewards
#Default: true
ClaimingRewardsStatus: true

# Requires permission for all rewards.
# If set to TRUE, it overrides and ignores the absence of permission requirements in the reward settings.
# Default: false
PermissionRequired: false

#Allow claiming rewards from placed blocks by players.
#Default: true
DisabledForPlacedBlocks: true

ParticleStatus: true
Particle: FLAME

SoundStatus: true
Sound: entity.firework_rocket.blast





Messages.yml

Code · Platte tekst

#Messages version
#DO NOT CHANGE IT MANUALLY!
CfgVersion: 2.2

UPDATE_CHECKER_ON_JOIN: true

BROADCAST_REWARD_TO_PLAYER: true

DROP_ITEM: '&6[REWARD] &7Dropped %ITEM% from %BROKEN% (%CHANCE%%)'
GIVE_MONEY: '&6[REWARD] &7You just got +%MONEY%$ from %BROKEN% (%CHANCE%%)'
MULTIPLE_DROP: '&6[REWARD] &7Multiplied %BROKEN% %AMOUNT%x (%CHANCE%%)'
GIVE_LEVEL: '&6[REWARD] &7You just got +%LVL% to level from %BROKEN% (%CHANCE%%)'
GIVE_EXPERIENCE: '&6[REWARD] &7You just got +%EXP% experience from %BROKEN% (%CHANCE%%)'
SPAWN_BONUS_CHEST: '&6[REWARD] &7Bonus chest was spawned from %BROKEN% (%CHANCE%%)'
GIVE_POTION_EFFECT: '&6[REWARD] &7You just got %EFFECT% | %DURATION%sec. from %BROKEN% (%CHANCE%%)'
COMMAND: '&6[REWARD] &7You just received command (/%COMMAND%) from %BROKEN% (%CHANCE%%)'
REPAIR_TOOL: '&6[REWARD] &7Your tool has been repaired from %BROKEN% (%CHANCE%%)'
EXPLOSION_REWARD: '&6[REWARD] &7Your tool has triggered an explosion at %BROKEN% (%CHANCE%%)'
RENEW_BLOCK: '&6[REWARD] &7The block was renewed from %BROKEN% (%CHANCE%%)'
CYCLE_ORE: '&6[REWARD] &7The ore was cycled to a new type from %BROKEN% (%CHANCE%%)'
ENCHANTMENT_REWARD: '&6[REWARD] &7Your tool was enchanted with %EFFECT% (Level %LEVEL%) from %BROKEN% (%CHANCE%%)'
GIVE_RANDOM_EFFECT: "&6[REWARD] &aYou've received a random effect: &e%EFFECT% &afor &e%DURATION%s &awith amplifier &e%AMPLIFIER%&a! (%CHANCE%%)"
VEIN_BURST: "&6[REWARD] &aVein Burst! &7You mined extra blocks from %BROKEN% (%CHANCE%%)"
ORE_SMELTER: '&6[REWARD] &7Smelted %BROKEN% into %ITEM% (%CHANCE%%)'
PROSPECTOR_PULSE: '&6[REWARD] &bProspector Pulse detected &e%TARGETS% &bore targets within &e%RADIUS% &bblocks. Follow the beam! (%CHANCE%%)'


BROADCAST_REWARD: true
BROADCAST_REWARD_CONSOLE: true

DROP_ITEM_BROADCAST: '&6[REWARD] &7%PLAYER% just dropped %ITEM% from %BROKEN% (%CHANCE%%)'
GIVE_MONEY_BROADCAST: '&6[REWARD] &7%PLAYER% just got +%MONEY%$ from %BROKEN% (%CHANCE%%)'
MULTIPLE_DROP_BROADCAST: '&6[REWARD] &7%PLAYER% multiplied %BROKEN% %AMOUNT%x (%CHANCE%%)'
GIVE_LEVEL_BROADCAST: '&6[REWARD] &7%PLAYER% just got +%LVL%lvl from %BROKEN% (%CHANCE%%)'
GIVE_EXPERIENCE_BROADCAST: '&6[REWARD] &7%PLAYER% just got +%EXP%exp from %BROKEN% (%CHANCE%%)'
SPAWN_BONUS_CHEST_BROADCAST: '&6[REWARD] &7%PLAYER% spawned bonus chest from %BROKEN% (%CHANCE%%)'
GIVE_POTION_EFFECT_BROADCAST: '&6[REWARD] &7%PLAYER% just got %EFFECT% | %DURATION%sec. from %BROKEN% (%CHANCE%%)'
COMMAND_BROADCAST: '&6[REWARD] &7%PLAYER% executed command (/%COMMAND%) from %BROKEN% (%CHANCE%%)'
REPAIR_TOOL_BROADCAST: '&6[REWARD] &7%PLAYER% repaired their tool from %BROKEN% (%CHANCE%%)'
EXPLOSION_REWARD_BROADCAST: '&6[REWARD] &7%PLAYER% triggered an explosion at %BROKEN% (%CHANCE%%)'
RENEW_BLOCK_BROADCAST: '&6[REWARD] &7%PLAYER% renewed a block from %BROKEN% (%CHANCE%%)'
CYCLE_ORE_BROADCAST: '&6[REWARD] &7%PLAYER% cycled the ore at %BROKEN% to a new type (%CHANCE%%)'
ENCHANTMENT_REWARD_BROADCAST: '&6[REWARD] &7%PLAYER% received %EFFECT% (Level %LEVEL%) from %BROKEN% (%CHANCE%%)'
GIVE_RANDOM_EFFECT_BROADCAST: "&6[REWARD] &6%PLAYER% &7received a random effect &b%EFFECT% &7while mining &a%BROKEN%&7 (%CHANCE%%)."
VEIN_BURST_BROADCAST: "&6[REWARD] &6%PLAYER% &7triggered Vein Burst from %BROKEN% (%CHANCE%%)"
ORE_SMELTER_BROADCAST: '&6[REWARD] &7%PLAYER% smelted %BROKEN% into %ITEM% (%CHANCE%%)'
PROSPECTOR_PULSE_BROADCAST: '&6[REWARD] &7%PLAYER% activated Prospector Pulse and detected %TARGETS% ore targets within %RADIUS% blocks (%CHANCE%%)'


CREATED_REWARD: '&c[SETTINGS] &7Created reward'
REMOVED_REWARD: '&c[SETTINGS] &7Removed reward'
NAME_CHANGED: '&c[SETTINGS] &7Name was changed'

WRONG_VALUE: '&c[SETTINGS] &7WRONG VALUE!'
ORE_SMELTER_WRONG_BLOCK: '&c[ORE SMELTER] &7Use only iron, gold or copper ore, or ancient debris.'
PROSPECTOR_PULSE_NOTHING: '&3[PROSPECTOR PULSE] &7No configured ore was found in loaded terrain within %RADIUS% blocks.'
PROSPECTOR_PULSE_TARGET_REQUIRED: '&c[PROSPECTOR PULSE] &7At least one ore group must remain enabled.'
WRONG_NAME: '&c[SETTINGS] &7WRONG NAME!'
NO_PERMISSION: '&c[SETTINGS] &7NO PERMISSION!'



Welkom — taal en privacy

Noodzakelijke cookies beveiligen het inloggen en onthouden uw keuzes. Optionele statistieken en YouTube blijven uit totdat u toestemming geeft. U kunt dit onderaan de pagina wijzigen. Privacy