Конфигурация
- Последняя версия
- 4.5.0
- Minecraft
- 26.1.x, 26.2.x, 26.3.x
- Платформы
- Spigot, Paper, Folia, Purpur
- Минимальная версия Java
- 25+
Конфигурация
Файлы и постоянные данные
Глобальные настройки
Пределы безопасности
Safety добавляется при старте и отсутствует в небольшом поставляемом Config.yml. MaxRewardsPerBlockBreak: 1–20 (стандарт 3); PlayerTriggerCooldownTicks: 0–1200 (0 отключает); SkipCreativeMode: true. MaxVeinBurstBlocks: 1–256 (стандарт 64). MaxExplosionPower: стандарт 4, предел 0–16; ExplosionBlockDamage: false. AllowUnsafeEnchantments: false. Command.MaxLength: 1–1024 (стандарт 256). BlockedPrefixes по умолчанию содержит op, deop, stop, restart и reload.
Награды-команды выполняются консолью с заменой %PLAYER% и %BLOCK%. Начальные слеши удаляются, многострочные команды отклоняются. BlockedPrefixes сравнивает точное первое слово без регистра; это не общий фильтр префиксов или прав. Алиасы с пространством имён блокируются отдельно. Редактирование давайте доверенным сотрудникам.
Сообщения и эффекты
Messages.yml поддерживает цвета
Старт добавляет отсутствующие MINING_SHIELD, MINING_SHIELD_BROADCAST, MINING_SHIELD_ABSORB, AUTO_PICKUP и AUTO_PICKUP_BROADCAST. Дополнение воспроизводит их значения. Общие ParticleStatus/SoundStatus отделены от PlayEffects/PlaySound награды. Не все типы имеют сообщение активации; Golden Apple здесь его не имеет.
Общие поля
Ниже общая схема. Broken_block — список материалов Minecraft; Chance — процент; VIPAccess — проверка прав; Drop_broken_block — обычный дроп, где поддерживается. DisabledWorlds — список миров. WorldGuardRegion.Enabled/Disabled сопоставляет ID региона со значением World. Технические ключи и идентификаторы оставляйте английскими.
Имена должны быть уникальными без учёта регистра, непустыми, до 48 символов, без крайних пробелов, '..', управляющих и недопустимых файловых символов. Системные зарезервированные имена отклоняются. Edit/remove требует сохранённый регистр. Переименовывайте через интерфейс; производное право тоже меняется.
Поля конкретного типа
Ниже все 20 типов и читаемые/записываемые ключи. Списки — справочник, не полные файлы. Используйте интерфейс для сериализации Bukkit ItemStack, предметов сундука и эффектов зелий. Типы без дополнительных полей тоже требуют общую схему.
Item_to_drop хранит выбранный ItemStack. Chest_items сопоставляет ячейки 0–26 с сериализованными ItemStack.
Multiply — число копий; Money — сумма Vault; Level — выдаваемые уровни для GIVE_LEVEL или уровень зачарования для ENCHANTMENT_REWARD; Exp — прямые очки XP. Power — сила взрыва, ограниченная также глобально. Enchantment принимает поддерживаемый идентификатор.
GIVE_POTION_EFFECT сохраняет Potion_effect как объект Bukkit; альтернативная форма использует Potion_effect_type, Potion_effect_duration и Potion_effect_amplifier. Её длительность в тиках, не секундах. GIVE_RANDOM_EFFECT использует Effects, Duration в секундах (1–3600) и Amplifier (0–255); 0 — уровень I.
OreChances задаёт веса поддерживаемых руд; редактор нормализует их. Delay — секунды (0–3600). RENEW_BLOCK и CYCLE_ORE заменяют только оставшийся воздух в загруженном чанке. При замене подавляют обычный дроп.
RegenDuration и AbsorptionDuration Golden Apple — тики (1–72000), усиление 0–255. FeedEnabled управляет FoodPoints и Saturation (0–20); PlaySound — звуками. RespectFortune, DropExperience и PlayEffects Ore Smelter логические. Его собственный переплавленный дроп не является обычным событием, собираемым Auto Pickup.
DROP_ITEM — Выдать предмет
MULTIPLE_DROP — Множественный дроп
GIVE_MONEY — Выдать деньги
GIVE_LEVEL — Выдать уровень
GIVE_EXPERIENCE — Выдать опыт
SPAWN_BONUS_CHEST — Создать бонусный сундук
GIVE_POTION_EFFECT — Выдать эффект зелья
COMMAND — Команда
REPAIR_TOOL — Починить инструмент
EXPLOSION_REWARD — Взрывная награда
RENEW_BLOCK — Восстановить блок
CYCLE_ORE — Смена руды
ENCHANTMENT_REWARD — Награда зачарования
GIVE_RANDOM_EFFECT — Выдать случайный эффект
VEIN_BURST — Добыча жилы
GOLDEN_APPLE — Золотое яблоко
ORE_SMELTER — Плавильщик руд
PROSPECTOR_PULSE — Импульс старателя
MINING_SHIELD — Шахтёрский щит
AUTO_PICKUP — Автоподбор
Примеры наград
Это полные примеры файлов под указанными именами в Rewards/. Не автоматически создаваемые стандартные награды. После ручной правки перезапускайте; отдельной подкоманды reload нет. Интерфейс записывает файлы напрямую.
Полные поставляемые файлы
Эти блоки точно воспроизводят поставляемые Config.yml и Messages.yml. Safety и дополнение добавляются при старте. Объединяйте с разделами без повторения ключей и сохраняйте Rewards/ и базу блоков.
Файлы и постоянные данные
Config.yml содержит глобальные переключатели и созданные Safety-настройки. Messages.yml — шаблоны чата/консоли и объявления. Rewards/<reward_name>.yml — одна награда с именем файла. placedBlocks.db хранит координаты блоков игроков. SQLite не хранит определения наград и не синхронизирует их между серверами.Глобальные настройки
ClaimingRewardsStatus управляет обычной обработкой; claimingrewardsbypass обходит только этот переключатель. PermissionRequired глобально требует права. DisabledForPlacedBlocks: true блокирует награды зарегистрированных блоков игроков вопреки неоднозначному комментарию. DisabledWorlds — необязательный, изначально пустой список. ParticleStatus/Particle и SoundStatus/Sound управляют общими эффектами. Не меняйте CfgVersion.Пределы безопасности
Safety добавляется при старте и отсутствует в небольшом поставляемом Config.yml. MaxRewardsPerBlockBreak: 1–20 (стандарт 3); PlayerTriggerCooldownTicks: 0–1200 (0 отключает); SkipCreativeMode: true. MaxVeinBurstBlocks: 1–256 (стандарт 64). MaxExplosionPower: стандарт 4, предел 0–16; ExplosionBlockDamage: false. AllowUnsafeEnchantments: false. Command.MaxLength: 1–1024 (стандарт 256). BlockedPrefixes по умолчанию содержит op, deop, stop, restart и reload.
Код · Обычный текст
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
Награды-команды выполняются консолью с заменой %PLAYER% и %BLOCK%. Начальные слеши удаляются, многострочные команды отклоняются. BlockedPrefixes сравнивает точное первое слово без регистра; это не общий фильтр префиксов или прав. Алиасы с пространством имён блокируются отдельно. Редактирование давайте доверенным сотрудникам.
Сообщения и эффекты
Messages.yml поддерживает цвета
& и HEX &#RRGGBB. BROADCAST_REWARD_TO_PLAYER, BROADCAST_REWARD и BROADCAST_REWARD_CONSOLE независимы. Ключи типов задают личные сообщения, _BROADCAST — объявления. Сохраняйте переменные. UPDATE_CHECKER_ON_JOIN и miningrewards.update управляют уведомлениями при входе. Не все подписи интерфейса переводятся этим файлом.Старт добавляет отсутствующие MINING_SHIELD, MINING_SHIELD_BROADCAST, MINING_SHIELD_ABSORB, AUTO_PICKUP и AUTO_PICKUP_BROADCAST. Дополнение воспроизводит их значения. Общие ParticleStatus/SoundStatus отделены от PlayEffects/PlaySound награды. Не все типы имеют сообщение активации; Golden Apple здесь его не имеет.
Код · Обычный текст
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%%)'
Общие поля
Ниже общая схема. Broken_block — список материалов Minecraft; Chance — процент; VIPAccess — проверка прав; Drop_broken_block — обычный дроп, где поддерживается. DisabledWorlds — список миров. WorldGuardRegion.Enabled/Disabled сопоставляет ID региона со значением World. Технические ключи и идентификаторы оставляйте английскими.
Код · Обычный текст
Reward_type: AUTO_PICKUP
Broken_block:
- STONE
- DEEPSLATE
Chance: 25.0
VIPAccess: false
Drop_broken_block: true
DisabledWorlds: []
WorldGuardRegion:
Enabled: {}
Disabled: {}
Код · Обычный текст
DisabledWorlds:
- lobby
WorldGuardRegion:
Enabled:
mine:
World: world
Disabled:
spawn:
World: world
Имена должны быть уникальными без учёта регистра, непустыми, до 48 символов, без крайних пробелов, '..', управляющих и недопустимых файловых символов. Системные зарезервированные имена отклоняются. Edit/remove требует сохранённый регистр. Переименовывайте через интерфейс; производное право тоже меняется.
Поля конкретного типа
Ниже все 20 типов и читаемые/записываемые ключи. Списки — справочник, не полные файлы. Используйте интерфейс для сериализации Bukkit ItemStack, предметов сундука и эффектов зелий. Типы без дополнительных полей тоже требуют общую схему.
Item_to_drop хранит выбранный ItemStack. Chest_items сопоставляет ячейки 0–26 с сериализованными ItemStack.
Multiply — число копий; Money — сумма Vault; Level — выдаваемые уровни для GIVE_LEVEL или уровень зачарования для ENCHANTMENT_REWARD; Exp — прямые очки XP. Power — сила взрыва, ограниченная также глобально. Enchantment принимает поддерживаемый идентификатор.
GIVE_POTION_EFFECT сохраняет Potion_effect как объект Bukkit; альтернативная форма использует Potion_effect_type, Potion_effect_duration и Potion_effect_amplifier. Её длительность в тиках, не секундах. GIVE_RANDOM_EFFECT использует Effects, Duration в секундах (1–3600) и Amplifier (0–255); 0 — уровень I.
OreChances задаёт веса поддерживаемых руд; редактор нормализует их. Delay — секунды (0–3600). RENEW_BLOCK и CYCLE_ORE заменяют только оставшийся воздух в загруженном чанке. При замене подавляют обычный дроп.
RegenDuration и AbsorptionDuration Golden Apple — тики (1–72000), усиление 0–255. FeedEnabled управляет FoodPoints и Saturation (0–20); PlaySound — звуками. RespectFortune, DropExperience и PlayEffects Ore Smelter логические. Его собственный переплавленный дроп не является обычным событием, собираемым Auto Pickup.
DROP_ITEM — Выдать предмет
Код · Обычный текст
Reward_type: DROP_ITEM
Item_to_drop
MULTIPLE_DROP — Множественный дроп
Код · Обычный текст
Reward_type: MULTIPLE_DROP
Multiply
GIVE_MONEY — Выдать деньги
Код · Обычный текст
Reward_type: GIVE_MONEY
Money
GIVE_LEVEL — Выдать уровень
Код · Обычный текст
Reward_type: GIVE_LEVEL
Level
GIVE_EXPERIENCE — Выдать опыт
Код · Обычный текст
Reward_type: GIVE_EXPERIENCE
Exp
SPAWN_BONUS_CHEST — Создать бонусный сундук
Код · Обычный текст
Reward_type: SPAWN_BONUS_CHEST
Chest_items
GIVE_POTION_EFFECT — Выдать эффект зелья
Код · Обычный текст
Reward_type: GIVE_POTION_EFFECT
Potion_effect
Potion_effect_type
Potion_effect_duration
Potion_effect_amplifier
COMMAND — Команда
Код · Обычный текст
Reward_type: COMMAND
Command
REPAIR_TOOL — Починить инструмент
Код · Обычный текст
Reward_type: REPAIR_TOOL
EXPLOSION_REWARD — Взрывная награда
Код · Обычный текст
Reward_type: EXPLOSION_REWARD
Power
RENEW_BLOCK — Восстановить блок
Код · Обычный текст
Reward_type: RENEW_BLOCK
CYCLE_ORE — Смена руды
Код · Обычный текст
Reward_type: CYCLE_ORE
OreChances
Delay
ENCHANTMENT_REWARD — Награда зачарования
Код · Обычный текст
Reward_type: ENCHANTMENT_REWARD
Enchantment
Level
GIVE_RANDOM_EFFECT — Выдать случайный эффект
Код · Обычный текст
Reward_type: GIVE_RANDOM_EFFECT
Effects
Duration
Amplifier
VEIN_BURST — Добыча жилы
Код · Обычный текст
Reward_type: VEIN_BURST
Radius
MaxBlocks
GOLDEN_APPLE — Золотое яблоко
Код · Обычный текст
Reward_type: GOLDEN_APPLE
RegenAmplifier
RegenDuration
AbsorptionAmplifier
AbsorptionDuration
FeedEnabled
FoodPoints
Saturation
PlaySound
ORE_SMELTER — Плавильщик руд
Код · Обычный текст
Reward_type: ORE_SMELTER
RespectFortune
DropExperience
PlayEffects
PROSPECTOR_PULSE — Импульс старателя
Код · Обычный текст
Reward_type: PROSPECTOR_PULSE
ScanRadius
MaxTargets
DurationSeconds
HiddenOnly
TargetOres
MINING_SHIELD — Шахтёрский щит
Код · Обычный текст
Reward_type: MINING_SHIELD
Charges
DurationSeconds
DamageReductionPercent
PlayEffects
AUTO_PICKUP — Автоподбор
Код · Обычный текст
Reward_type: AUTO_PICKUP
CollectExperience
OverflowAtPlayer
PlayEffects
Примеры наград
Это полные примеры файлов под указанными именами в Rewards/. Не автоматически создаваемые стандартные награды. После ручной правки перезапускайте; отдельной подкоманды reload нет. Интерфейс записывает файлы напрямую.
Rewards/pickup_stone.yml
Код · Обычный текст
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
Код · Обычный текст
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
Код · Обычный текст
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
Код · Обычный текст
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%!
Полные поставляемые файлы
Эти блоки точно воспроизводят поставляемые Config.yml и Messages.yml. Safety и дополнение добавляются при старте. Объединяйте с разделами без повторения ключей и сохраняйте Rewards/ и базу блоков.
Config.yml
Код · Обычный текст
#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
Код · Обычный текст
#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!'
