MiningRewards — Visão geral

Visão geral

Este guia apresenta o MiningRewards 4.5.0: 20 tipos de recompensa, criação e edição na GUI, restrições por mundo e região, permissões e proteção de blocos colocados. O catálogo mantém os identificadores Reward_type exatos dos ficheiros de recompensas.

Primeira recompensa
Executa /mr create example_reward. Escolhe tipo, blocos, valores, probabilidade e condições restantes antes de guardar. Verifica com /mr list. Testa em Survival num bloco natural compatível; Creative e blocos colocados estão excluídos por predefinição.

A lista tem páginas e ordenação A–Z/Z–A. A pré-visualização aparece na descrição com a permissão adequada. Clique esquerdo abre o editor. Shift + direito prepara a remoção; repete para confirmar. Remove elimina diretamente sem confirmação GUI. Não é preciso recriar para editar, mas o editor não permite mudar o tipo.

Condições e ativação
Um bloco pode corresponder a várias recompensas com probabilidades e restrições próprias. A GUI aceita 0.01–100%; 0 no ficheiro nunca ativa. O limite predefinido é 3 recompensas bem-sucedidas por bloco. O tempo de espera é verificado antes do ciclo e limita quebras posteriores, não recompensas da mesma quebra. Eventos cancelados e recursivos de Vein Burst não ativam o processamento.

DisabledWorlds global bloqueia todas as recompensas nesses mundos. A lista própria acrescenta restrições. Com WorldEdit e WorldGuard, regiões desativadas têm prioridade; uma lista permitida não vazia exige estar numa região permitida. Sem integração ou gestor de regiões disponível, essas restrições não são aplicadas. Seleciona regiões existentes e mundos carregados na GUI.

Todos os tipos de recompensa
DROP_ITEM — Largar item
– Dá ao jogador um item adicional configurável.
MULTIPLE_DROP — Drop múltiplo
– Dá várias cópias do item do bloco minerado.
GIVE_MONEY — Dar dinheiro
– Recompensa o jogador com moeda do servidor através do Vault.
GIVE_LEVEL — Dar nível
– Concede um ou mais níveis de experiência.
GIVE_EXPERIENCE — Dar experiência
– Concede uma quantidade configurável de experiência direta.
SPAWN_BONUS_CHEST — Gerar baú de bónus
– Gera um baú com os itens de recompensa configurados.
GIVE_POTION_EFFECT — Dar efeito de poção
– Aplica o efeito selecionado durante o tempo configurado.
COMMAND — Comando
– Executa um ou mais comandos do servidor ao ativar. Suporta marcadores como %PLAYER% e %BLOCK%.
REPAIR_TOOL — Reparar ferramenta
– Repara a ferramenta usada para minerar o bloco.
EXPLOSION_REWARD — Recompensa de explosão
– Cria uma explosão na localização do bloco minerado.
RENEW_BLOCK — Renovar bloco
– Substitui o bloco minerado pelo mesmo tipo de bloco.
CYCLE_ORE — Alternar minério
– Substitui o bloco minerado por um minério configurado escolhido aleatoriamente.
ENCHANTMENT_REWARD — Recompensa de encantamento
– Adiciona um encantamento e nível selecionados à ferramenta de mineração.
GIVE_RANDOM_EFFECT — Dar efeito aleatório
– Dá ao jogador um efeito aleatório de uma lista configurada.
VEIN_BURST — Extração de veio
– Minera automaticamente blocos de minério ligados com raio e limites configuráveis.
GOLDEN_APPLE — Maçã dourada
– Aplica regeneração, absorção e benefícios alimentares configuráveis baseados na recompensa de maçã dourada.
ORE_SMELTER — 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.
PROSPECTOR_PULSE — 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.
MINING_SHIELD — 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.
AUTO_PICKUP — 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.

Comportamento especial das recompensas
Auto Pickup recolhe o evento normal de drops do bloco ativador, não todos os blocos futuros. CollectExperience dá os XP de imediato; OverflowAtPlayer escolhe onde cai o excesso. Os drops normais são forçados. Outras recompensas que os suprimem podem impedir a recolha; testa combinações no mesmo bloco.

Mining Shield dá 1–20 cargas por ativação, dura 5–600 segundos e reduz dano em 10–100%. Repetições somam até 100 cargas e mantêm a validade mais longa e redução mais forte. Cada evento de dano elegível consome uma carga. VOID, SUICIDE e KILL estão excluídos. É removido ao morrer, sair ou desativar o plugin.

Prospector Pulse analisa terreno carregado: raio 4–24, 1–8 alvos e 2–30 segundos. HiddenOnly exige minérios fechados. TargetOres seleciona grupos. Mostra partículas privadas e barra de chefe, não minera alvos e avisa se não encontrar nada. Uma ativação substitui o pulso anterior.

Vein Burst segue blocos ligados do mesmo material, incluindo diagonais, num raio 1–8. O limite efetivo é o menor entre MaxBlocks e Safety.MaxVeinBurstBlocks, incluindo o bloco original. Eventos adicionais são enviados a plugins de proteção e não iniciam novas cadeias MiningRewards. Só processa terreno carregado.