Cała dokumentacja
WIKI PLUGINU

MiningRewards — Konfiguracja

Twórz nagrody za wydobywanie bloków i ustawiaj ich warunki oraz efekty bezpośrednio w menu gry.

Zobacz plugin

Konfiguracja

Informacje o bieżącym wydaniu
Najnowsza wersja
4.5.0
Minecraft
26.1.x, 26.2.x, 26.3.x
Platformy
Spigot, Paper, Folia, Purpur
Minimalna wersja Java
25+
Informacje o wydaniu
Wersja 4.5.0Ostatnia aktualizacja: 19.10.2026 10:39
Konfiguracja

Pliki i trwałość danych
Config.yml zawiera globalne przełączniki i generowane ustawienia Safety. Messages.yml zawiera szablony czatu/konsoli i ogłoszenia. Rewards/<reward_name>.yml to jedna nagroda; jej nazwą jest nazwa pliku. placedBlocks.db zapisuje współrzędne postawionych bloków. SQLite nie przechowuje definicji nagród ani nie synchronizuje ich między serwerami.

Ustawienia globalne
ClaimingRewardsStatus steruje zwykłym przetwarzaniem; claimingrewardsbypass omija tylko ten przełącznik. PermissionRequired wymaga uprawnień globalnie. DisabledForPlacedBlocks: true blokuje nagrody z rejestrowanych bloków graczy, mimo niejasnego komentarza w pliku. DisabledWorlds to opcjonalna lista nazw światów, początkowo pusta. ParticleStatus/Particle i SoundStatus/Sound sterują ogólnymi efektami aktywacji. Nie zmieniaj CfgVersion.

Limity bezpieczeństwa
Sekcja Safety jest dodawana przy starcie i nie występuje w małym domyślnym Config.yml. MaxRewardsPerBlockBreak ma zakres 1–20 (domyślnie 3); PlayerTriggerCooldownTicks 0–1200 (0 wyłącza); SkipCreativeMode domyślnie true. MaxVeinBurstBlocks wynosi 1–256 (domyślnie 64). MaxExplosionPower domyślnie 4, ograniczony do 0–16; ExplosionBlockDamage domyślnie false. AllowUnsafeEnchantments domyślnie false. Command.MaxLength to 1–1024 (domyślnie 256). BlockedPrefixes domyślnie zawiera op, deop, stop, restart i reload.

Kod · Zwykły tekst

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


Nagrody komend działają jako konsola, zastępując %PLAYER% i %BLOCK%. Początkowe ukośniki są usuwane, a komendy wielowierszowe odrzucane. BlockedPrefixes porównuje dokładnie pierwsze słowo komendy bez względu na wielkość liter; nie jest ogólną zaporą prefiksów ani uprawnień. Aliasy z przestrzenią nazw trzeba blokować osobno. Edycję nagród komend przyznawaj zaufanej administracji.

Wiadomości i efekty
Messages.yml obsługuje kolory & i HEX &#RRGGBB. BROADCAST_REWARD_TO_PLAYER, BROADCAST_REWARD i BROADCAST_REWARD_CONSOLE są niezależne. Klucze typów nagród określają wiadomości osobiste, a wersje _BROADCAST ogłoszenia. Zachowaj zmienne każdego szablonu. UPDATE_CHECKER_ON_JOIN i miningrewards.update sterują informacją o aktualizacji przy wejściu. Edycja pliku nie tłumaczy wszystkich etykiet GUI.

Start dodaje brakujące MINING_SHIELD, MINING_SHIELD_BROADCAST, MINING_SHIELD_ABSORB, AUTO_PICKUP i AUTO_PICKUP_BROADCAST. Poniższy dodatek odtwarza te wartości domyślne. Ogólne ParticleStatus/SoundStatus są osobne od PlayEffects/PlaySound nagrody. Nie każdy typ ma przypisaną wiadomość aktywacji; Golden Apple nie ma jej w tej wersji.

Kod · Zwykły tekst

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%%)'


Wspólne pola nagród
Poniżej pokazano wspólny schemat. Broken_block to lista materiałów Minecrafta; Chance to procent; VIPAccess steruje uprawnieniami; Drop_broken_block kontroluje zwykły drop tam, gdzie nagroda to obsługuje. DisabledWorlds to lista światów. WorldGuardRegion.Enabled/Disabled przypisuje identyfikatorom regionów wartość World. Zachowuj techniczne klucze i identyfikatory po angielsku.

Kod · Zwykły tekst

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


Kod · Zwykły tekst

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


Nazwy muszą być unikalne bez względu na wielkość liter, niepuste, do 48 znaków, bez spacji na początku/końcu, '..', znaków sterujących i nieprawidłowych znaków pliku. Zastrzeżone nazwy systemowe są odrzucane. Komendy edit/remove wymagają wielkości liter zapisanej nazwy. Najlepiej zmieniaj nazwę przez GUI; zmienia to również uprawnienie wyprowadzone z nazwy.

Pola właściwe dla typu nagrody
Poniżej są wszystkie 20 typów i klucze przez nie odczytywane lub zapisywane. Listy kluczy to dokumentacja, nie kompletne pliki nagród. Serializację ItemStack Bukkit, przedmiotów skrzyni i efektów mikstur wykonuj przez GUI. Typy bez dodatkowych pól nadal wymagają wspólnego schematu.

Item_to_drop przechowuje ItemStack wybrany w GUI. Chest_items przypisuje slotom 0–26 serializowane ItemStack.

Multiply to liczba kopii; Money to kwota Vault; Level to liczba przyznawanych poziomów dla GIVE_LEVEL lub poziom zaklęcia dla ENCHANTMENT_REWARD; Exp to punkty XP. Power to siła eksplozji ograniczana też globalnie. Enchantment przyjmuje identyfikator obsługiwanego zaklęcia.

GIVE_POTION_EFFECT zapisuje Potion_effect jako obiekt Bukkit; alternatywny czytelny zapis używa Potion_effect_type, Potion_effect_duration i Potion_effect_amplifier. Alternatywny czas jest w tickach, nie sekundach. GIVE_RANDOM_EFFECT używa Effects, Duration w sekundach (1–3600) i Amplifier (0–255); 0 oznacza poziom efektu I.

OreChances przypisuje wagi obsługiwanym rudom; edytor je normalizuje. Delay to sekundy (0–3600). RENEW_BLOCK i CYCLE_ORE zastępują blok tylko wtedy, gdy miejsce nadal jest powietrzem, a chunk pozostaje załadowany. W ramach zastępowania blokują zwykły drop.

Czasy Golden Apple RegenDuration i AbsorptionDuration są w tickach (1–72000), a siła ma zakres 0–255. FeedEnabled kontroluje FoodPoints i Saturation (0–20); PlaySound steruje dźwiękiem. RespectFortune, DropExperience i PlayEffects dla Ore Smelter są logiczne. Własne przetopione przedmioty nie są zwykłym zdarzeniem dropu zbieranym przez Auto Pickup.

DROP_ITEM — Upuszczenie przedmiotu
Kod · Zwykły tekst

Reward_type: DROP_ITEM
Item_to_drop


MULTIPLE_DROP — Wielokrotny drop
Kod · Zwykły tekst

Reward_type: MULTIPLE_DROP
Multiply


GIVE_MONEY — Przyznanie pieniędzy
Kod · Zwykły tekst

Reward_type: GIVE_MONEY
Money


GIVE_LEVEL — Przyznanie poziomu
Kod · Zwykły tekst

Reward_type: GIVE_LEVEL
Level


GIVE_EXPERIENCE — Przyznanie doświadczenia
Kod · Zwykły tekst

Reward_type: GIVE_EXPERIENCE
Exp


SPAWN_BONUS_CHEST — Przywołanie skrzyni bonusowej
Kod · Zwykły tekst

Reward_type: SPAWN_BONUS_CHEST
Chest_items


GIVE_POTION_EFFECT — Przyznanie efektu mikstury
Kod · Zwykły tekst

Reward_type: GIVE_POTION_EFFECT
Potion_effect
Potion_effect_type
Potion_effect_duration
Potion_effect_amplifier


COMMAND — Komenda
Kod · Zwykły tekst

Reward_type: COMMAND
Command


REPAIR_TOOL — Naprawa narzędzia
Kod · Zwykły tekst

Reward_type: REPAIR_TOOL


EXPLOSION_REWARD — Nagroda eksplozji
Kod · Zwykły tekst

Reward_type: EXPLOSION_REWARD
Power


RENEW_BLOCK — Odnowienie bloku
Kod · Zwykły tekst

Reward_type: RENEW_BLOCK


CYCLE_ORE — Zmiana rudy
Kod · Zwykły tekst

Reward_type: CYCLE_ORE
OreChances
Delay


ENCHANTMENT_REWARD — Nagroda zaklęcia
Kod · Zwykły tekst

Reward_type: ENCHANTMENT_REWARD
Enchantment
Level


GIVE_RANDOM_EFFECT — Przyznanie losowego efektu
Kod · Zwykły tekst

Reward_type: GIVE_RANDOM_EFFECT
Effects
Duration
Amplifier


VEIN_BURST — Wydobycie żyły
Kod · Zwykły tekst

Reward_type: VEIN_BURST
Radius
MaxBlocks


GOLDEN_APPLE — Złote jabłko
Kod · Zwykły tekst

Reward_type: GOLDEN_APPLE
RegenAmplifier
RegenDuration
AbsorptionAmplifier
AbsorptionDuration
FeedEnabled
FoodPoints
Saturation
PlaySound


ORE_SMELTER — Przetapiacz rud
Kod · Zwykły tekst

Reward_type: ORE_SMELTER
RespectFortune
DropExperience
PlayEffects


PROSPECTOR_PULSE — Impuls poszukiwacza
Kod · Zwykły tekst

Reward_type: PROSPECTOR_PULSE
ScanRadius
MaxTargets
DurationSeconds
HiddenOnly
TargetOres


MINING_SHIELD — Tarcza górnicza
Kod · Zwykły tekst

Reward_type: MINING_SHIELD
Charges
DurationSeconds
DamageReductionPercent
PlayEffects


AUTO_PICKUP — Automatyczne zbieranie
Kod · Zwykły tekst

Reward_type: AUTO_PICKUP
CollectExperience
OverflowAtPlayer
PlayEffects


Przykłady nagród
To kompletne przykładowe pliki nagród do zapisania pod wskazaną nazwą w Rewards/. Są przykładami, nie generowanymi nagrodami domyślnymi. Po ręcznej edycji plików wykonaj restart; plugin nie ma osobnej podkomendy reload. Edycje GUI zapisują pliki bezpośrednio.

Rewards/pickup_stone.yml

Kod · Zwykły tekst

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

Kod · Zwykły tekst

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

Kod · Zwykły tekst

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

Kod · Zwykły tekst

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



Kompletne pliki domyślne
Te dwa bloki odtwarzają dokładne pliki Config.yml i Messages.yml z paczki. Safety i dodatek nowych wiadomości są dodawane przy starcie. Łącz przykłady z istniejącymi sekcjami bez powtarzania kluczy i zachowaj istniejące Rewards/ oraz bazę bloków.

Config.yml

Kod · Zwykły tekst

#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

Kod · Zwykły tekst

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



Witaj — wybierz język i ustawienia prywatności

Niezbędne cookies zabezpieczają logowanie i zapamiętują Twoje wybory. Opcjonalne statystyki i filmy YouTube pozostają wyłączone do czasu Twojej zgody. Ustawienia możesz zmienić w stopce. Prywatność