MiningRewards

Con MiningRewards puedes recompensar a los jugadores por picar bloques concretos en servidores Spigot y Paper. Crea y ajusta las recompensas desde un menú dentro del juego, con todas las opciones a mano.

Las recompensas pueden dar objetos, dinero, experiencia, efectos de poción y encantamientos. También pueden ejecutar comandos, reparar herramientas, sustituir o transformar bloques, extraer vetas de mineral conectadas y analizar el terreno cercano. Mining Shield ofrece protección temporal y Auto Pickup lleva los objetos extraídos directamente al inventario.

✅ Creación y gestión de recompensas

• Gestión mediante GUI – Crea, edita, consulta, ordena y elimina recompensas directamente desde menús de inventario.
  
• Creador de recompensas paso a paso – Configura cada recompensa con un asistente con pasos separados para:
  
  • Nombre de la recompensa
    
  • Tipo de recompensa
    
  • Bloques activadores
    
  • Ajustes específicos de la recompensa
    
  • Probabilidad de activación
    
  • Acceso VIP
    
  • Mundos desactivados
    
  • Regiones WorldGuard
    
  • Drops normales del bloque
    
  
  
• Archivos de recompensa separados – Cada recompensa se guarda en su propio archivo dentro de la carpeta Rewards.
  
• Nombres de recompensa seguros – Los nombres se validan antes de crear, renombrar, cargar o eliminar recompensas.
  
• Actualizaciones automáticas de configuración – Las entradas de configuración y mensajes que falten se añaden al arrancar cuando es necesario.
  

✅ 20 tipos de recompensa
Puedes elegir entre los siguientes tipos de recompensa:

• Soltar objeto – Da al jugador un objeto adicional configurable.
  
• Drop múltiple – Da varias copias del objeto del bloque minado.
  
• Dar dinero – Recompensa al jugador con moneda del servidor mediante Vault.
  
• Dar nivel – Concede uno o más niveles de experiencia.
  
• Dar experiencia – Concede una cantidad configurable de experiencia directa.
  
• Generar cofre adicional – Genera un cofre con los objetos de recompensa configurados.
  
• Dar efecto de poción – Aplica el efecto seleccionado durante el tiempo configurado.
  
• Comando – Ejecuta uno o más comandos del servidor al activarse. Admite marcadores como %PLAYER% y %BLOCK%.
  
• Reparar herramienta – Repara la herramienta usada para minar el bloque.
  
• Recompensa explosiva – Crea una explosión en la ubicación del bloque minado.
  
• Renovar bloque – Sustituye el bloque minado por el mismo tipo de bloque.
  
• Cambiar mineral – Sustituye el bloque minado por un mineral configurado elegido al azar.
  
• Recompensa de encantamiento – Añade un encantamiento y nivel seleccionados a la herramienta minera del jugador.
  
• Dar efecto aleatorio – Da al jugador un efecto aleatorio de una lista configurada.
  
• Extracción de veta – Mina automáticamente bloques de mineral conectados con radio y límites configurables.
  
• Manzana dorada – Aplica regeneración, absorción y beneficios alimenticios configurables basados en la recompensa de manzana dorada.
  
• Fundidor de minerales – Sustituye drops de mineral en bruto por lingotes. Se pueden configurar Fortuna, experiencia de horno y efectos visuales. Admite hierro, oro, cobre y escombros ancestrales.
  
• Pulso del prospector – Explora terreno cargado buscando minerales seleccionados y muestra una brújula privada de partículas. Radio, duración, grupos de minerales, máximo de objetivos y modo solo ocultos son configurables.
  
• Escudo minero – Concede un escudo temporal por cargas, con cargas, duración, reducción de daño y efectos configurables. Las activaciones repetidas añaden cargas hasta un límite de seguridad y conservan la protección más fuerte.
  
• Recogida automática – Envía los drops del bloque minado directamente al inventario. Recoge opcionalmente la experiencia al instante, elige si los objetos sobrantes caen junto al jugador o al bloque y activa efectos de recogida. Incluye ajustes específicos del creador y editor.
  

✅ Condiciones de recompensa y control de probabilidades

• Varios bloques activadores – Asigna varios tipos de bloque a una recompensa en vez de crear una por cada bloque.
  
• Probabilidad individual de activación – Configura por separado la probabilidad de cada recompensa, desde 0.01% hasta 100%.
  
• Controles rápidos de probabilidad – Ajusta la probabilidad directamente en la GUI con incrementos de 0.01%, 0.1%, 1% y 10%.
  
• Varias recompensas por bloque – Asigna varias recompensas al mismo bloque, cada una con su probabilidad y restricciones.
  
• Control del drop normal – Decide si el bloque debe seguir soltando su objeto normal tras activarse una recompensa. Auto Pickup mantiene los drops normales para recogerlos.
  

✅ Ajustes globales y protección contra abusos

• Interruptor global de recompensas – Activa o desactiva el procesamiento para jugadores normales sin borrar las recompensas configuradas.
  
• Excepción administrativa – Permite al personal autorizado seguir recibiendo recompensas con el interruptor global desactivado.
  
• Protección de bloques colocados – Evita colocar y romper repetidamente bloques propios para obtener recompensas.
  
• Base de protección persistente – Las ubicaciones colocadas por jugadores se guardan en SQLite y siguen protegidas tras reiniciar.
  

✅ Seguridad de recompensas y control de rendimiento

• Límite de recompensas por bloque – Limita cuántas recompensas se activan al romper un bloque. El valor predeterminado es 3, configurable mediante Safety.MaxRewardsPerBlockBreak.
  
• Tiempo de espera del jugador – Establece opcionalmente un retraso en ticks entre activaciones exitosas por jugador. Desactivado por defecto.
  
• Control del modo creativo – Omite recompensas para jugadores en Creative por defecto, con un ajuste configurable.
  
• Límites de extracción de veta – Combina el radio y límite de cada recompensa con un máximo global de bloques minados. Los bloques adicionales generan eventos de rotura para que los plugins de protección puedan cancelarlos, sin cadenas recursivas de recompensas.
  
• Controles de explosión – Configura la potencia máxima y si las explosiones pueden dañar bloques. El daño a bloques está desactivado por defecto.
  
• Límites de encantamientos – Usa límites normales de nivel por defecto, con una opción para encantamientos inseguros.
  
• Restricciones de comandos – Establece longitud máxima y prefijos de comandos bloqueados para estas recompensas.
  
• Validación de recompensas – Omite recompensas con valores requeridos ausentes o no válidos. Los errores de ejecución se registran y se omite la recompensa fallida.
  

✅ Restricciones de mundos

• Mundos desactivados globalmente – Desactiva recompensas mineras en mundos seleccionados desde los ajustes globales.
  
• Mundos desactivados por recompensa – Desactiva una recompensa individual en mundos seleccionados mediante una GUI paginada.
  

✅ Compatibilidad con regiones WorldGuard
Con WorldEdit y WorldGuard instalados, puedes restringir las recompensas por región:

• Regiones permitidas – Permite la activación solo dentro de regiones WorldGuard seleccionadas.
  
• Regiones desactivadas – Impide la activación dentro de regiones seleccionadas.
  
• GUI de gestión de regiones – Añade, elimina y restablece regiones permitidas o desactivadas directamente en los menús.
  

✅ Permisos de recompensas

• Recompensas VIP opcionales – Marca recompensas individuales como protegidas por permisos.
  
• Requisito global de permiso – Exige un permiso para cada recompensa configurada.
  
• Permiso para todas las recompensas – Concede acceso a todas las recompensas protegidas con miningrewards.reward.all.
  
• Permiso de recompensa individual – Concede acceso a una recompensa seleccionada con miningrewards.reward.<reward_name>.
  
• Permisos administrativos separados – Controla por separado acceso al menú principal, lista, vista previa, creador, editor, eliminación y ajustes globales.
  

✅ Lista de recompensas y GUI de vista previa

• Lista paginada – Explora todas las recompensas configuradas en un menú de inventario organizado.
  
• Vista previa detallada – Consulta tipo, bloques activadores, probabilidad, VIP, drops normales, regiones y valores específicos.
  
• Ordenación – Alterna el orden alfabético entre A–Z y Z–A.
  
• Edición rápida – Abre el editor completo con Clic izquierdo.
  
• Eliminación segura – Elimina una recompensa mediante una confirmación protegida de Shift + clic derecho.
  

✅ Editor completo de recompensas
Edita las recompensas existentes sin tener que crearlas de nuevo. Según el tipo, puedes cambiar:

• Nombre de la recompensa
  
• Bloques activadores
  
• Probabilidad de activación
  
• Valores específicos de recompensa
  
• Requisito VIP
  
• Drops normales del bloque
  
• Mundos desactivados
  
• Regiones WorldGuard
  

✅ Efectos, sonidos y mensajes

• Efectos de activación – Muestra efectos visuales configurables al activarse una recompensa.
  
• Sonidos de activación – Reproduce un sonido configurable después de una recompensa exitosa.
  
• Mensajes del jugador – Envía información al jugador que activó la recompensa.
  
• Anuncios globales – Anuncia las recompensas exitosas a otros jugadores conectados.
  
• Mensajes de consola – Registra las activaciones exitosas en la consola del servidor.
  
• Controles independientes – Activa o desactiva por separado mensajes al jugador, anuncios globales y mensajes de consola.
  
• Mensajes editables – Personaliza prefijos, mensajes, valores y marcadores en Messages.yml.
  

✅ Comandos y administración
Usa /miningrewards o su alias /mr para abrir el menú principal y las herramientas de administración:

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

El autocompletado con Tab te ayuda a escribir los subcomandos del plugin.

✅ Integraciones y compatibilidad

• Economía Vault – Las recompensas monetarias están disponibles con Vault y un proveedor de economía compatible.
  
• WorldEdit y WorldGuard – Restricciones opcionales de recompensa por región.
  
• SQLite – Almacenamiento persistente de protección de bloques colocados.
  
• Spigot y Paper – Diseñado para servidores con API Spigot/Paper 26.2 y Java 25.