Configuración
- Ú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+
Configuración
Archivos y persistencia
Ajustes globales
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.
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
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í.
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.
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
MULTIPLE_DROP — Drop múltiple
GIVE_MONEY — Dar dinero
GIVE_LEVEL — Dar nivel
GIVE_EXPERIENCE — Dar experiencia
SPAWN_BONUS_CHEST — Generar cofre adicional
GIVE_POTION_EFFECT — Dar efecto de poción
COMMAND — Comando
REPAIR_TOOL — Reparar herramienta
EXPLOSION_REWARD — Recompensa explosiva
RENEW_BLOCK — Renovar bloque
CYCLE_ORE — Cambiar mineral
ENCHANTMENT_REWARD — Recompensa de encantamiento
GIVE_RANDOM_EFFECT — Dar efecto aleatorio
VEIN_BURST — Extracción de veta
GOLDEN_APPLE — Manzana dorada
ORE_SMELTER — Fundidor de minerales
PROSPECTOR_PULSE — Pulso del prospector
MINING_SHIELD — Escudo minero
AUTO_PICKUP — Recogida automática
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.
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.
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!'
