Toda a documentação
WIKI DO PLUGIN

MiningRewards — Configuração

Cria recompensas de mineração e ajusta as condições e os efeitos num menu dentro do jogo.

Ver plugin

Configuração

Informações da versão atual
Versão mais recente
4.5.0
Minecraft
26.1.x, 26.2.x, 26.3.x
Plataformas
Spigot, Paper, Folia, Purpur
Versão mínima do Java
25+
Notas de versão
Versão 4.5.0Última atualização: 19/10/2026 10:39
Configuração

Ficheiros e persistência
Config.yml contém controlos globais e Safety gerado. Messages.yml contém modelos de chat/consola e interruptores. Rewards/<reward_name>.yml é uma recompensa; o nome do ficheiro é o seu nome. placedBlocks.db guarda coordenadas de blocos colocados. SQLite não guarda definições nem sincroniza recompensas entre servidores.

Definições globais
ClaimingRewardsStatus controla o processamento normal; claimingrewardsbypass só ignora esse interruptor. PermissionRequired exige permissões globalmente. DisabledForPlacedBlocks: true bloqueia recompensas de blocos registados de jogadores apesar do comentário ambíguo. DisabledWorlds é uma lista opcional inicialmente vazia. ParticleStatus/Particle e SoundStatus/Sound controlam efeitos gerais. Não alteres CfgVersion.

Limites de segurança
Safety é adicionado no arranque e falta no pequeno Config.yml incluído. MaxRewardsPerBlockBreak: 1–20 (predefinição 3); PlayerTriggerCooldownTicks: 0–1200 (0 desativa); SkipCreativeMode: true. MaxVeinBurstBlocks: 1–256 (predefinição 64). MaxExplosionPower: predefinição 4, limitado a 0–16; ExplosionBlockDamage: false. AllowUnsafeEnchantments: false. Command.MaxLength: 1–1024 (predefinição 256). BlockedPrefixes inclui op, deop, stop, restart e reload por predefinição.

Código · Texto simples

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


Comandos de recompensa correm como consola, substituindo %PLAYER% e %BLOCK%. Barras iniciais são removidas e várias linhas rejeitadas. BlockedPrefixes compara a primeira palavra exata sem distinguir maiúsculas; não é uma barreira geral de prefixos ou permissões. Aliases com espaço de nomes devem ser bloqueados separadamente. Reserva a edição a pessoal de confiança.

Mensagens e efeitos
Messages.yml suporta cores & e HEX &#RRGGBB. BROADCAST_REWARD_TO_PLAYER, BROADCAST_REWARD e BROADCAST_REWARD_CONSOLE são independentes. As chaves de tipo definem mensagens pessoais; _BROADCAST define anúncios. Preserva marcadores. UPDATE_CHECKER_ON_JOIN e miningrewards.update controlam avisos ao entrar. Este ficheiro não traduz todas as etiquetas GUI.

O arranque adiciona MINING_SHIELD, MINING_SHIELD_BROADCAST, MINING_SHIELD_ABSORB, AUTO_PICKUP e AUTO_PICKUP_BROADCAST se faltarem. O suplemento reproduz as predefinições. ParticleStatus/SoundStatus gerais são separados de PlayEffects/PlaySound da recompensa. Nem todos os tipos têm mensagem de ativação; Golden Apple não tem nesta versão.

Código · Texto simples

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%%)'


Campos comuns
Abaixo está o esquema comum. Broken_block é uma lista de materiais Minecraft; Chance uma percentagem; VIPAccess controla permissões; Drop_broken_block os drops normais onde suportado. DisabledWorlds é uma lista de mundos. WorldGuardRegion.Enabled/Disabled associa IDs de região a World. Mantém chaves técnicas e identificadores em inglês.

Código · Texto simples

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


Código · Texto simples

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


Nomes devem ser únicos ignorando maiúsculas, não vazios, até 48 caracteres, sem espaços nas extremidades, '..', controlos ou caracteres inválidos de ficheiro. Nomes reservados do sistema são rejeitados. Edit/remove exige as maiúsculas guardadas. Renomeia pela GUI quando possível; muda também a permissão derivada do nome.

Campos específicos do tipo
Seguem os 20 tipos e as chaves lidas ou guardadas. São referência, não ficheiros completos. Usa a GUI para serializar ItemStack Bukkit, itens de baú e efeitos de poção. Tipos sem campos extra também precisam do esquema comum.

Item_to_drop guarda o ItemStack escolhido na GUI. Chest_items associa espaços 0–26 a ItemStacks serializados.

Multiply é número de cópias; Money quantia Vault; Level níveis concedidos em GIVE_LEVEL ou nível de encantamento em ENCHANTMENT_REWARD; Exp pontos XP diretos. Power é potência explosiva também limitada globalmente. Enchantment aceita um identificador compatível.

GIVE_POTION_EFFECT guarda Potion_effect como objeto Bukkit; o formato alternativo usa Potion_effect_type, Potion_effect_duration e Potion_effect_amplifier. Essa duração é ticks, não segundos. GIVE_RANDOM_EFFECT usa Effects, Duration em segundos (1–3600) e Amplifier (0–255); 0 significa nível I.

OreChances associa pesos a minérios compatíveis; o editor normaliza-os. Delay é segundos (0–3600). RENEW_BLOCK e CYCLE_ORE só substituem se o local ainda for ar e o chunk estiver carregado. Suprimem drops normais ao substituir.

RegenDuration e AbsorptionDuration de Golden Apple são ticks (1–72000), amplificadores 0–255. FeedEnabled controla FoodPoints e Saturation (0–20); PlaySound os sons. RespectFortune, DropExperience e PlayEffects de Ore Smelter são booleanos. Os drops fundidos próprios não são o evento normal recolhido por Auto Pickup.

DROP_ITEM — Largar item
Código · Texto simples

Reward_type: DROP_ITEM
Item_to_drop


MULTIPLE_DROP — Drop múltiplo
Código · Texto simples

Reward_type: MULTIPLE_DROP
Multiply


GIVE_MONEY — Dar dinheiro
Código · Texto simples

Reward_type: GIVE_MONEY
Money


GIVE_LEVEL — Dar nível
Código · Texto simples

Reward_type: GIVE_LEVEL
Level


GIVE_EXPERIENCE — Dar experiência
Código · Texto simples

Reward_type: GIVE_EXPERIENCE
Exp


SPAWN_BONUS_CHEST — Gerar baú de bónus
Código · Texto simples

Reward_type: SPAWN_BONUS_CHEST
Chest_items


GIVE_POTION_EFFECT — Dar efeito de poção
Código · Texto simples

Reward_type: GIVE_POTION_EFFECT
Potion_effect
Potion_effect_type
Potion_effect_duration
Potion_effect_amplifier


COMMAND — Comando
Código · Texto simples

Reward_type: COMMAND
Command


REPAIR_TOOL — Reparar ferramenta
Código · Texto simples

Reward_type: REPAIR_TOOL


EXPLOSION_REWARD — Recompensa de explosão
Código · Texto simples

Reward_type: EXPLOSION_REWARD
Power


RENEW_BLOCK — Renovar bloco
Código · Texto simples

Reward_type: RENEW_BLOCK


CYCLE_ORE — Alternar minério
Código · Texto simples

Reward_type: CYCLE_ORE
OreChances
Delay


ENCHANTMENT_REWARD — Recompensa de encantamento
Código · Texto simples

Reward_type: ENCHANTMENT_REWARD
Enchantment
Level


GIVE_RANDOM_EFFECT — Dar efeito aleatório
Código · Texto simples

Reward_type: GIVE_RANDOM_EFFECT
Effects
Duration
Amplifier


VEIN_BURST — Extração de veio
Código · Texto simples

Reward_type: VEIN_BURST
Radius
MaxBlocks


GOLDEN_APPLE — Maçã dourada
Código · Texto simples

Reward_type: GOLDEN_APPLE
RegenAmplifier
RegenDuration
AbsorptionAmplifier
AbsorptionDuration
FeedEnabled
FoodPoints
Saturation
PlaySound


ORE_SMELTER — Fundidor de minérios
Código · Texto simples

Reward_type: ORE_SMELTER
RespectFortune
DropExperience
PlayEffects


PROSPECTOR_PULSE — Pulso do prospector
Código · Texto simples

Reward_type: PROSPECTOR_PULSE
ScanRadius
MaxTargets
DurationSeconds
HiddenOnly
TargetOres


MINING_SHIELD — Escudo de mineração
Código · Texto simples

Reward_type: MINING_SHIELD
Charges
DurationSeconds
DamageReductionPercent
PlayEffects


AUTO_PICKUP — Recolha automática
Código · Texto simples

Reward_type: AUTO_PICKUP
CollectExperience
OverflowAtPlayer
PlayEffects


Exemplos de recompensas
São ficheiros completos de exemplo com o nome indicado em Rewards/. Não são recompensas predefinidas geradas. Reinicia após edição manual; não há subcomando reload próprio. A GUI guarda os ficheiros diretamente.

Rewards/pickup_stone.yml

Código · Texto simples

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

Código · Texto simples

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

Código · Texto simples

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

Código · Texto simples

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%!



Ficheiros completos incluídos
Estes blocos reproduzem Config.yml e Messages.yml exatos incluídos. Safety e o suplemento são adicionados no arranque. Integra exemplos nas secções existentes sem duplicar chaves e mantém Rewards/ e a base de blocos.

Config.yml

Código · Texto simples

#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

Código · Texto simples

#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!'


Bem-vindo — idioma e privacidade

Os cookies necessários protegem o início de sessão e guardam as suas escolhas. As estatísticas opcionais e o YouTube ficam desativados até dar consentimento. Pode alterar esta escolha no rodapé. Privacidade