MiningRewards

Com o MiningRewards, podes recompensar os jogadores por minerarem os blocos que escolheres nos servidores Spigot e Paper. Cria e ajusta as recompensas num menu dentro do jogo, com todas as opções à mão.

As recompensas podem dar itens, dinheiro, experiência, efeitos de poção e encantamentos. Também podem executar comandos, reparar ferramentas, substituir ou transformar blocos, minerar veios de minério ligados e analisar o terreno próximo. O Mining Shield oferece proteção temporária e o Auto Pickup coloca os itens minerados diretamente no inventário.

✅ Criação e gestão de recompensas

• Gestão por GUI – Cria, edita, pré-visualiza, ordena e remove recompensas diretamente nos menus de inventário.
  
• Criador de recompensas passo a passo – Configura cada recompensa com um assistente com etapas separadas para:
  
  • Nome da recompensa
    
  • Tipo de recompensa
    
  • Blocos de ativação
    
  • Definições específicas da recompensa
    
  • Probabilidade de ativação
    
  • Acesso VIP
    
  • Mundos desativados
    
  • Regiões WorldGuard
    
  • Drops normais do bloco
    
  
  
• Ficheiros de recompensa separados – Cada recompensa é guardada no seu próprio ficheiro dentro da pasta Rewards.
  
• Nomes de recompensa seguros – Os nomes são validados antes de criar, renomear, carregar ou eliminar recompensas.
  
• Atualizações automáticas de configuração – Entradas de configuração e mensagens em falta são adicionadas no arranque quando necessário.
  

✅ 20 tipos de recompensa
Podes escolher entre os seguintes tipos de recompensa:

• Largar item – Dá ao jogador um item adicional configurável.
  
• Drop múltiplo – Dá várias cópias do item do bloco minerado.
  
• Dar dinheiro – Recompensa o jogador com moeda do servidor através do Vault.
  
• Dar nível – Concede um ou mais níveis de experiência.
  
• Dar experiência – Concede uma quantidade configurável de experiência direta.
  
• Gerar baú de bónus – Gera um baú com os itens de recompensa configurados.
  
• Dar efeito de poção – Aplica o efeito selecionado durante o tempo configurado.
  
• Comando – Executa um ou mais comandos do servidor ao ativar. Suporta marcadores como %PLAYER% e %BLOCK%.
  
• Reparar ferramenta – Repara a ferramenta usada para minerar o bloco.
  
• Recompensa de explosão – Cria uma explosão na localização do bloco minerado.
  
• Renovar bloco – Substitui o bloco minerado pelo mesmo tipo de bloco.
  
• Alternar minério – Substitui o bloco minerado por um minério configurado escolhido aleatoriamente.
  
• Recompensa de encantamento – Adiciona um encantamento e nível selecionados à ferramenta de mineração.
  
• Dar efeito aleatório – Dá ao jogador um efeito aleatório de uma lista configurada.
  
• Extração de veio – Minera automaticamente blocos de minério ligados com raio e limites configuráveis.
  
• Maçã dourada – Aplica regeneração, absorção e benefícios alimentares configuráveis baseados na recompensa de maçã dourada.
  
• Fundidor de minérios – Substitui drops de minério bruto por lingotes. Fortuna, experiência de forno e efeitos visuais são configuráveis. Suporta ferro, ouro, cobre e detritos ancestrais.
  
• Pulso do prospector – Analisa terreno carregado à procura de minérios selecionados e mostra uma bússola privada de partículas. Raio, duração, grupos de minérios, máximo de alvos e modo apenas ocultos são configuráveis.
  
• Escudo de mineração – Concede um escudo temporário por cargas, com cargas, duração, redução de dano e efeitos configuráveis. Ativações repetidas adicionam cargas até ao limite de segurança e mantêm a proteção mais forte.
  
• Recolha automática – Envia os drops do bloco minerado diretamente para o inventário. Recolhe opcionalmente a experiência de imediato, escolhe se os itens em excesso caem junto ao jogador ou bloco e ativa efeitos de recolha. Inclui definições próprias no criador e editor.
  

✅ Condições de recompensa e controlo de probabilidades

• Vários blocos de ativação – Atribui vários tipos de bloco a uma recompensa em vez de criar uma para cada bloco.
  
• Probabilidade individual de ativação – Configura a probabilidade de cada recompensa separadamente, de 0.01% até 100%.
  
• Controlos rápidos de probabilidade – Ajusta a probabilidade diretamente na GUI com passos de 0.01%, 0.1%, 1% e 10%.
  
• Várias recompensas por bloco – Atribui várias recompensas ao mesmo bloco, cada uma com probabilidade e restrições próprias.
  
• Controlo do drop normal – Decide se o bloco continua a largar o item normal após ativar uma recompensa. Auto Pickup mantém os drops normais ativos para os recolher.
  

✅ Definições globais e proteção contra abusos

• Interruptor global de recompensas – Ativa ou desativa o processamento para jogadores normais sem apagar as recompensas configuradas.
  
• Exceção administrativa – Permite à equipa autorizada continuar a receber recompensas com o interruptor global desativado.
  
• Proteção de blocos colocados – Impede colocar e quebrar repetidamente blocos próprios para obter recompensas.
  
• Base de proteção persistente – As localizações colocadas por jogadores são guardadas em SQLite e mantêm-se protegidas após reinícios.
  

✅ Segurança das recompensas e controlo de desempenho

• Limite de recompensas por bloco – Limita quantas recompensas se ativam ao quebrar um bloco. A predefinição é 3, configurável através de Safety.MaxRewardsPerBlockBreak.
  
• Tempo de espera do jogador – Define opcionalmente um atraso em ticks entre ativações bem-sucedidas por jogador. Desativado por predefinição.
  
• Controlo do modo criativo – Ignora recompensas para jogadores em Creative por predefinição, com um interruptor configurável.
  
• Limites de extração de veio – Combina raio e limite de cada recompensa com um máximo global de blocos minerados. Blocos adicionais geram eventos de quebra para plugins de proteção poderem cancelar, sem cadeias recursivas de recompensas.
  
• Controlos de explosão – Configura potência máxima e se as explosões de recompensa podem danificar blocos. O dano a blocos está desativado por predefinição.
  
• Limites de encantamentos – Usa limites normais de nível por predefinição, com uma opção para encantamentos inseguros.
  
• Restrições de comandos – Define comprimento máximo e prefixos bloqueados para recompensas de comandos.
  
• Validação de recompensas – Ignora recompensas com valores obrigatórios ausentes ou inválidos. Erros de execução são registados e a recompensa falhada é ignorada.
  

✅ Restrições de mundos

• Mundos desativados globalmente – Desativa recompensas de mineração em mundos selecionados pelas definições globais.
  
• Mundos desativados por recompensa – Desativa uma recompensa individual em mundos selecionados através de uma GUI paginada.
  

✅ Suporte de regiões WorldGuard
Com o WorldEdit e o WorldGuard instalados, podes limitar as recompensas por região:

• Regiões permitidas – Permite ativação apenas dentro de regiões WorldGuard selecionadas.
  
• Regiões desativadas – Impede a ativação dentro de regiões selecionadas.
  
• GUI de gestão de regiões – Adiciona, remove e repõe regiões permitidas ou desativadas diretamente nos menus.
  

✅ Permissões de recompensas

• Recompensas VIP opcionais – Marca recompensas individuais como protegidas por permissões.
  
• Exigência global de permissão – Exige uma permissão para cada recompensa configurada.
  
• Permissão de todas as recompensas – Concede acesso a todas as recompensas protegidas com miningrewards.reward.all.
  
• Permissão de recompensa individual – Concede acesso a uma recompensa selecionada com miningrewards.reward.<reward_name>.
  
• Permissões administrativas separadas – Controla separadamente acesso ao menu principal, lista, pré-visualização, criador, editor, remoção e definições globais.
  

✅ Lista de recompensas e GUI de pré-visualização

• Lista paginada – Percorre todas as recompensas configuradas num menu de inventário organizado.
  
• Pré-visualização detalhada – Consulta tipo, blocos, probabilidade, VIP, drops normais, regiões e valores específicos.
  
• Ordenação – Alterna a ordem alfabética entre A–Z e Z–A.
  
• Edição rápida – Abre o editor completo com Clique esquerdo.
  
• Remoção segura – Remove uma recompensa através de uma confirmação protegida com Shift + clique direito.
  

✅ Editor completo de recompensas
Edita as recompensas existentes sem teres de as criar de novo. Consoante o tipo, podes alterar:

• Nome da recompensa
  
• Blocos de ativação
  
• Probabilidade de ativação
  
• Valores específicos da recompensa
  
• Exigência VIP
  
• Drops normais do bloco
  
• Mundos desativados
  
• Regiões WorldGuard
  

✅ Efeitos, sons e mensagens

• Efeitos de ativação – Mostra efeitos visuais configuráveis ao ativar uma recompensa.
  
• Sons de ativação – Reproduz um som configurável após uma recompensa bem-sucedida.
  
• Mensagens do jogador – Envia informações ao jogador que ativou a recompensa.
  
• Anúncios globais – Anuncia recompensas bem-sucedidas a outros jogadores online.
  
• Mensagens da consola – Regista ativações bem-sucedidas na consola do servidor.
  
• Controlos independentes – Ativa ou desativa separadamente mensagens ao jogador, anúncios globais e mensagens da consola.
  
• Mensagens editáveis – Personaliza prefixos, mensagens, valores e marcadores em Messages.yml.
  

✅ Comandos e administração
Usa /miningrewards ou o alias /mr para abrires o menu principal e as ferramentas de administração:

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

O preenchimento com Tab ajuda-te a escrever os subcomandos do plugin.

✅ Integrações e compatibilidade

• Economia Vault – As recompensas monetárias ficam disponíveis com Vault e um fornecedor de economia compatível.
  
• WorldEdit e WorldGuard – Restrições opcionais de recompensa por região.
  
• SQLite – Armazenamento persistente da proteção de blocos colocados.
  
• Spigot e Paper – Concebido para servidores com API Spigot/Paper 26.2 e Java 25.