Toda la documentación
WIKI DEL PLUGIN

MiningRewards — Configuración

Crea recompensas por minar y ajusta sus condiciones y efectos desde un menú dentro del juego.

Ver plugin

Configuración

Información de la versión actual
Última versión
4.5.0
Minecraft
26.1.x, 26.2.x, 26.3.x
Plataformas
Spigot, Paper, Folia, Purpur
Versión mínima de Java
25+
Notas de versión
Versión 4.5.0Última actualización: 19/10/2026 10:39
Configuración

Archivos y persistencia
Config.yml contiene controles globales y Safety generado. Messages.yml contiene plantillas de chat/consola e interruptores. Rewards/<reward_name>.yml es una recompensa; el nombre del archivo es su nombre. placedBlocks.db guarda coordenadas de bloques colocados. SQLite no guarda definiciones ni sincroniza recompensas entre servidores.

Ajustes globales
ClaimingRewardsStatus controla procesamiento normal; claimingrewardsbypass solo evita ese interruptor. PermissionRequired exige permisos globalmente. DisabledForPlacedBlocks: true bloquea recompensas de bloques registrados de jugadores pese al comentario ambiguo. DisabledWorlds es una lista opcional inicialmente vacía. ParticleStatus/Particle y SoundStatus/Sound controlan efectos generales. No cambies CfgVersion.

Límites de seguridad
Safety se añade al arrancar y falta en el pequeño Config.yml incluido. MaxRewardsPerBlockBreak: 1–20 (defecto 3); PlayerTriggerCooldownTicks: 0–1200 (0 desactiva); SkipCreativeMode: true. MaxVeinBurstBlocks: 1–256 (defecto 64). MaxExplosionPower: defecto 4, limitado a 0–16; ExplosionBlockDamage: false. AllowUnsafeEnchantments: false. Command.MaxLength: 1–1024 (defecto 256). BlockedPrefixes incluye por defecto op, deop, stop, restart y reload.

Código · Texto sin formato

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


Los comandos de recompensa se ejecutan como consola, sustituyendo %PLAYER% y %BLOCK%. Se eliminan barras iniciales y se rechazan varias líneas. BlockedPrefixes compara exactamente la primera palabra sin distinguir mayúsculas; no es un cortafuegos general de prefijos o permisos. Los alias con espacio de nombres deben bloquearse aparte. Reserva su edición a personal de confianza.

Mensajes y efectos
Messages.yml admite colores & y HEX &#RRGGBB. BROADCAST_REWARD_TO_PLAYER, BROADCAST_REWARD y BROADCAST_REWARD_CONSOLE son independientes. Las claves del tipo definen mensajes personales y _BROADCAST anuncios. Conserva los marcadores. UPDATE_CHECKER_ON_JOIN y miningrewards.update controlan avisos al entrar. Este archivo no traduce todas las etiquetas GUI.

El arranque añade MINING_SHIELD, MINING_SHIELD_BROADCAST, MINING_SHIELD_ABSORB, AUTO_PICKUP y AUTO_PICKUP_BROADCAST si faltan. El suplemento reproduce sus valores predeterminados. ParticleStatus/SoundStatus generales son independientes de PlayEffects/PlaySound de la recompensa. No todos los tipos tienen mensaje de activación; Golden Apple no lo tiene aquí.

Código · Texto sin formato

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 comunes
Abajo está el esquema común. Broken_block es lista de materiales Minecraft; Chance porcentaje; VIPAccess controla permisos; Drop_broken_block los drops normales donde sea compatible. DisabledWorlds es lista de mundos. WorldGuardRegion.Enabled/Disabled asigna IDs de región a un valor World. Mantén claves técnicas e identificadores en inglés.

Código · Texto sin formato

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


Código · Texto sin formato

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


Los nombres deben ser únicos sin distinguir mayúsculas, no vacíos, máximo 48 caracteres, sin espacios al principio/final, '..', controles ni caracteres de archivo inválidos. Se rechazan nombres reservados del sistema. Edit/remove exige las mayúsculas guardadas. Renombra por GUI cuando puedas; cambia también el permiso derivado del nombre.

Campos específicos del tipo
Se indican los 20 tipos y sus claves leídas o guardadas. Son referencia, no archivos completos. Usa la GUI para serializar ItemStack Bukkit, objetos de cofre y efectos de poción. Los tipos sin campos extra también necesitan el esquema común.

Item_to_drop guarda el ItemStack elegido en GUI. Chest_items asigna ranuras 0–26 a ItemStacks serializados.

Multiply es número de copias; Money cantidad Vault; Level niveles dados en GIVE_LEVEL o nivel de encantamiento en ENCHANTMENT_REWARD; Exp puntos XP directos. Power es potencia explosiva también limitada globalmente. Enchantment acepta un identificador compatible.

GIVE_POTION_EFFECT guarda Potion_effect como objeto Bukkit; el formato alternativo usa Potion_effect_type, Potion_effect_duration y Potion_effect_amplifier. Esa duración es ticks, no segundos. GIVE_RANDOM_EFFECT usa Effects, Duration en segundos (1–3600) y Amplifier (0–255); 0 significa nivel I.

OreChances asigna pesos a minerales compatibles; el editor los normaliza. Delay es segundos (0–3600). RENEW_BLOCK y CYCLE_ORE solo reemplazan si sigue siendo aire y el chunk está cargado. Suprimen drops normales al reemplazar.

RegenDuration y AbsorptionDuration de Golden Apple son ticks (1–72000), amplificadores 0–255. FeedEnabled controla FoodPoints y Saturation (0–20); PlaySound sus sonidos. RespectFortune, DropExperience y PlayEffects de Ore Smelter son booleanos. Sus drops fundidos propios no son el evento normal recogido por Auto Pickup.

DROP_ITEM — Soltar objeto
Código · Texto sin formato

Reward_type: DROP_ITEM
Item_to_drop


MULTIPLE_DROP — Drop múltiple
Código · Texto sin formato

Reward_type: MULTIPLE_DROP
Multiply


GIVE_MONEY — Dar dinero
Código · Texto sin formato

Reward_type: GIVE_MONEY
Money


GIVE_LEVEL — Dar nivel
Código · Texto sin formato

Reward_type: GIVE_LEVEL
Level


GIVE_EXPERIENCE — Dar experiencia
Código · Texto sin formato

Reward_type: GIVE_EXPERIENCE
Exp


SPAWN_BONUS_CHEST — Generar cofre adicional
Código · Texto sin formato

Reward_type: SPAWN_BONUS_CHEST
Chest_items


GIVE_POTION_EFFECT — Dar efecto de poción
Código · Texto sin formato

Reward_type: GIVE_POTION_EFFECT
Potion_effect
Potion_effect_type
Potion_effect_duration
Potion_effect_amplifier


COMMAND — Comando
Código · Texto sin formato

Reward_type: COMMAND
Command


REPAIR_TOOL — Reparar herramienta
Código · Texto sin formato

Reward_type: REPAIR_TOOL


EXPLOSION_REWARD — Recompensa explosiva
Código · Texto sin formato

Reward_type: EXPLOSION_REWARD
Power


RENEW_BLOCK — Renovar bloque
Código · Texto sin formato

Reward_type: RENEW_BLOCK


CYCLE_ORE — Cambiar mineral
Código · Texto sin formato

Reward_type: CYCLE_ORE
OreChances
Delay


ENCHANTMENT_REWARD — Recompensa de encantamiento
Código · Texto sin formato

Reward_type: ENCHANTMENT_REWARD
Enchantment
Level


GIVE_RANDOM_EFFECT — Dar efecto aleatorio
Código · Texto sin formato

Reward_type: GIVE_RANDOM_EFFECT
Effects
Duration
Amplifier


VEIN_BURST — Extracción de veta
Código · Texto sin formato

Reward_type: VEIN_BURST
Radius
MaxBlocks


GOLDEN_APPLE — Manzana dorada
Código · Texto sin formato

Reward_type: GOLDEN_APPLE
RegenAmplifier
RegenDuration
AbsorptionAmplifier
AbsorptionDuration
FeedEnabled
FoodPoints
Saturation
PlaySound


ORE_SMELTER — Fundidor de minerales
Código · Texto sin formato

Reward_type: ORE_SMELTER
RespectFortune
DropExperience
PlayEffects


PROSPECTOR_PULSE — Pulso del prospector
Código · Texto sin formato

Reward_type: PROSPECTOR_PULSE
ScanRadius
MaxTargets
DurationSeconds
HiddenOnly
TargetOres


MINING_SHIELD — Escudo minero
Código · Texto sin formato

Reward_type: MINING_SHIELD
Charges
DurationSeconds
DamageReductionPercent
PlayEffects


AUTO_PICKUP — Recogida automática
Código · Texto sin formato

Reward_type: AUTO_PICKUP
CollectExperience
OverflowAtPlayer
PlayEffects


Ejemplos de recompensas
Son archivos completos de ejemplo con el nombre indicado en Rewards/. No son recompensas predeterminadas generadas. Reinicia tras editar archivos manualmente; no hay subcomando reload propio. La GUI guarda directamente los archivos.

Rewards/pickup_stone.yml

Código · Texto sin formato

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 sin formato

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 sin formato

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 sin formato

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



Archivos incluidos completos
Estos dos bloques reproducen Config.yml y Messages.yml exactos incluidos. Safety y el suplemento se añaden al arrancar. Integra ejemplos en secciones existentes sin duplicar claves y conserva Rewards/ y la base de bloques.

Config.yml

Código · Texto sin formato

#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 sin formato

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



Bienvenido — idioma y privacidad

Las cookies necesarias protegen el inicio de sesión y recuerdan tus preferencias. Las estadísticas opcionales y YouTube permanecen desactivados hasta que los permitas. Puedes cambiar esta elección en el pie de página. Privacidad