Alle Dokumentation
PLUGIN-WIKI

MiningRewards — Konfiguration

Erstelle Belohnungen fürs Abbauen und passe ihre Bedingungen und Effekte direkt im Spielmenü an.

Plugin ansehen

Konfiguration

Informationen zur aktuellen Version
Neueste Version
4.5.0
Minecraft
26.1.x, 26.2.x, 26.3.x
Plattformen
Spigot, Paper, Folia, Purpur
Erforderliche Java-Mindestversion
25+
Versionshinweise
Version 4.5.0Zuletzt aktualisiert: 19.10.2026 10:39
Konfiguration

Dateien und dauerhafte Daten
Config.yml enthält globale Schalter und erzeugte Safety-Werte. Messages.yml enthält Chat-/Konsolenvorlagen und Broadcast-Schalter. Rewards/<reward_name>.yml ist eine Belohnung; der Dateiname ist ihr Name. placedBlocks.db speichert Weltkoordinaten platzierter Blöcke. SQLite speichert keine Belohnungsdefinitionen und synchronisiert nicht zwischen Servern.

Globale Einstellungen
ClaimingRewardsStatus steuert normale Verarbeitung; claimingrewardsbypass umgeht nur diesen Schalter. PermissionRequired verlangt global Belohnungsrechte. DisabledForPlacedBlocks: true blockiert Belohnungen aus erfassten Spielerblöcken trotz missverständlichem Dateikommentar. DisabledWorlds ist eine optionale, anfangs leere Weltnamenliste. ParticleStatus/Particle und SoundStatus/Sound steuern allgemeine Aktivierungseffekte. CfgVersion unverändert lassen.

Sicherheitsgrenzen
Safety wird beim Start ergänzt und fehlt in der kleinen mitgelieferten Config.yml. MaxRewardsPerBlockBreak: 1–20 (Standard 3); PlayerTriggerCooldownTicks: 0–1200 (0 deaktiviert); SkipCreativeMode: standardmäßig true. MaxVeinBurstBlocks: 1–256 (Standard 64). MaxExplosionPower: Standard 4, begrenzt auf 0–16; ExplosionBlockDamage: standardmäßig false. AllowUnsafeEnchantments: false. Command.MaxLength: 1–1024 (Standard 256). BlockedPrefixes enthält standardmäßig op, deop, stop, restart und reload.

Code · Nur Text

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


Befehlsbelohnungen laufen als Konsole und ersetzen %PLAYER% sowie %BLOCK%. Führende Schrägstriche werden entfernt, mehrzeilige Befehle abgewiesen. BlockedPrefixes vergleicht das exakte erste Befehlswort ohne Groß-/Kleinschreibung; es ist keine allgemeine Präfix- oder Berechtigungsfirewall. Namensraum-Aliasse müssen separat gesperrt werden. Vergib deren Bearbeitung nur an vertraute Mitarbeiter.

Nachrichten und Effekte
Messages.yml unterstützt &-Farben und &#RRGGBB-HEX. BROADCAST_REWARD_TO_PLAYER, BROADCAST_REWARD und BROADCAST_REWARD_CONSOLE sind unabhängig. Typenschlüssel definieren persönliche Nachrichten, _BROADCAST-Versionen Ankündigungen. Behalte Vorlagenplatzhalter bei. UPDATE_CHECKER_ON_JOIN und miningrewards.update steuern Updatehinweise beim Beitritt. Nicht alle GUI-Texte werden über diese Datei übersetzt.

Der Start ergänzt fehlende MINING_SHIELD, MINING_SHIELD_BROADCAST, MINING_SHIELD_ABSORB, AUTO_PICKUP und AUTO_PICKUP_BROADCAST. Unten stehen deren Standardwerte. Allgemeine ParticleStatus/SoundStatus sind getrennt von belohnungsspezifischen PlayEffects/PlaySound. Nicht jeder Typ hat eine Aktivierungsnachricht; Golden Apple hat hier keine.

Code · Nur Text

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


Gemeinsame Belohnungsfelder
Unten steht das gemeinsame Schema. Broken_block ist eine Liste von Minecraft-Materialien; Chance ein Prozentwert; VIPAccess steuert Berechtigungen; Drop_broken_block normale Drops, soweit unterstützt. DisabledWorlds ist eine Weltnamenliste. WorldGuardRegion.Enabled/Disabled ordnet Regions-IDs einen World-Wert zu. Technische Schlüssel und Enum-Werte bleiben Englisch.

Code · Nur Text

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


Code · Nur Text

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


Namen müssen ohne Beachtung der Groß-/Kleinschreibung eindeutig, nichtleer und höchstens 48 Zeichen lang sein, ohne Rand-Leerzeichen, '..', Steuer- oder ungültige Dateizeichen. Reservierte Systemnamen werden abgewiesen. edit/remove verlangt die gespeicherte Schreibweise. Benenne möglichst über die GUI um; dadurch ändert sich auch der abgeleitete Berechtigungsname.

Typspezifische Felder
Unten stehen alle 20 Typen und ihre gelesenen oder gespeicherten Schlüssel. Die Listen sind Referenz, keine vollständigen Dateien. Nutze die GUI zur Serialisierung von Bukkit-ItemStacks, Truheninhalten und Trankeffekten. Typen ohne Zusatzfelder benötigen dennoch das gemeinsame Schema.

Item_to_drop speichert den in der GUI gewählten ItemStack. Chest_items ordnet Slots 0–26 serialisierte ItemStacks zu.

Multiply ist die Exemplarzahl; Money der Vault-Betrag; Level die vergebenen Level bei GIVE_LEVEL oder Verzauberungsstufe bei ENCHANTMENT_REWARD; Exp sind direkte XP-Punkte. Power ist die zusätzlich global begrenzte Explosionsstärke. Enchantment akzeptiert einen unterstützten Verzauberungsbezeichner.

GIVE_POTION_EFFECT speichert Potion_effect als Bukkit-Objekt; alternativ werden Potion_effect_type, Potion_effect_duration und Potion_effect_amplifier gelesen. Diese alternative Dauer ist in Ticks, nicht Sekunden. GIVE_RANDOM_EFFECT nutzt Effects, Duration in Sekunden (1–3600) und Amplifier (0–255); 0 bedeutet Effektstufe I.

OreChances ordnet unterstützten Erzen Gewichte zu; der Editor normalisiert sie. Delay ist in Sekunden (0–3600). RENEW_BLOCK und CYCLE_ORE ersetzen nur weiterhin leere Positionen in geladenen Chunks. Beim Ersetzen unterdrücken sie normale Drops.

Golden-Apfel-Dauern RegenDuration und AbsorptionDuration sind Ticks (1–72000), Verstärkungen 0–255. FeedEnabled steuert FoodPoints und Saturation (0–20); PlaySound die Sounds. RespectFortune, DropExperience und PlayEffects des Erzschmelzers sind boolesch. Dessen eigene geschmolzene Drops sind nicht das normale von Auto Pickup gesammelte Drop-Ereignis.

DROP_ITEM — Gegenstand droppen
Code · Nur Text

Reward_type: DROP_ITEM
Item_to_drop


MULTIPLE_DROP — Mehrfachdrop
Code · Nur Text

Reward_type: MULTIPLE_DROP
Multiply


GIVE_MONEY — Geld vergeben
Code · Nur Text

Reward_type: GIVE_MONEY
Money


GIVE_LEVEL — Level vergeben
Code · Nur Text

Reward_type: GIVE_LEVEL
Level


GIVE_EXPERIENCE — Erfahrung vergeben
Code · Nur Text

Reward_type: GIVE_EXPERIENCE
Exp


SPAWN_BONUS_CHEST — Bonustruhe spawnen
Code · Nur Text

Reward_type: SPAWN_BONUS_CHEST
Chest_items


GIVE_POTION_EFFECT — Trankeffekt vergeben
Code · Nur Text

Reward_type: GIVE_POTION_EFFECT
Potion_effect
Potion_effect_type
Potion_effect_duration
Potion_effect_amplifier


COMMAND — Befehl
Code · Nur Text

Reward_type: COMMAND
Command


REPAIR_TOOL — Werkzeug reparieren
Code · Nur Text

Reward_type: REPAIR_TOOL


EXPLOSION_REWARD — Explosionsbelohnung
Code · Nur Text

Reward_type: EXPLOSION_REWARD
Power


RENEW_BLOCK — Block erneuern
Code · Nur Text

Reward_type: RENEW_BLOCK


CYCLE_ORE — Erzwechsel
Code · Nur Text

Reward_type: CYCLE_ORE
OreChances
Delay


ENCHANTMENT_REWARD — Verzauberungsbelohnung
Code · Nur Text

Reward_type: ENCHANTMENT_REWARD
Enchantment
Level


GIVE_RANDOM_EFFECT — Zufälligen Effekt vergeben
Code · Nur Text

Reward_type: GIVE_RANDOM_EFFECT
Effects
Duration
Amplifier


VEIN_BURST — Erzader abbauen
Code · Nur Text

Reward_type: VEIN_BURST
Radius
MaxBlocks


GOLDEN_APPLE — Goldener Apfel
Code · Nur Text

Reward_type: GOLDEN_APPLE
RegenAmplifier
RegenDuration
AbsorptionAmplifier
AbsorptionDuration
FeedEnabled
FoodPoints
Saturation
PlaySound


ORE_SMELTER — Erzschmelzer
Code · Nur Text

Reward_type: ORE_SMELTER
RespectFortune
DropExperience
PlayEffects


PROSPECTOR_PULSE — Sucherimpuls
Code · Nur Text

Reward_type: PROSPECTOR_PULSE
ScanRadius
MaxTargets
DurationSeconds
HiddenOnly
TargetOres


MINING_SHIELD — Bergbauschild
Code · Nur Text

Reward_type: MINING_SHIELD
Charges
DurationSeconds
DamageReductionPercent
PlayEffects


AUTO_PICKUP — Automatisches Aufheben
Code · Nur Text

Reward_type: AUTO_PICKUP
CollectExperience
OverflowAtPlayer
PlayEffects


Belohnungsbeispiele
Dies sind vollständige Beispieldateien unter dem angegebenen Namen in Rewards/. Sie sind Beispiele, keine automatisch erzeugten Standardbelohnungen. Starte nach manuellen Änderungen neu; es gibt keinen eigenen reload-Unterbefehl. GUI-Änderungen speichern Dateien direkt.

Rewards/pickup_stone.yml

Code · Nur Text

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

Code · Nur Text

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

Code · Nur Text

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

Code · Nur Text

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



Vollständige mitgelieferte Dateien
Diese zwei Blöcke entsprechen exakt der mitgelieferten Config.yml und Messages.yml. Safety und neue Nachrichtenvorgaben werden beim Start ergänzt. Füge Beispiele in vorhandene Abschnitte ein, ohne Schlüssel zu duplizieren, und behalte Rewards/ und die Blockdatenbank.

Config.yml

Code · Nur Text

#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

Code · Nur Text

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



Willkommen — Sprache und Datenschutz

Notwendige Cookies sichern die Anmeldung und speichern Ihre Auswahl. Optionale Statistiken und YouTube bleiben bis zu Ihrer Zustimmung deaktiviert. Sie können Ihre Auswahl in der Fußzeile ändern. Datenschutz