Troubleshooting
The pickaxe breaks one block, the plugin will not enable, drops do not appear — symptoms and causes.
Before you start digging — check the server console. Most plugin problems leave a specific message there, and without one we are guessing.
The most likely causes, in order:
- You are holding a normal pickaxe, not the plugin's one. The plugin recognises its
own item by the way it was handed out. An ordinary netherite pickaxe from your
inventory will not work — you have to get one through
/grzybcio-kilof. wymagaj-uprawnienia: trueis set and you do not havegrzybciokilof.use. Then the pickaxe deliberately behaves like a normal one. Check with/lp user <nick> permission check grzybciokilof.use.- The block is on the exclusion list. Bedrock is there by default. Check
bloki-wykluczoneinconfig.yml. - The pickaxe was handed out before a config change. If you changed
kilof-typ, older copies may no longer match. Give yourself a fresh one.
Look for lines mentioning GrzybcioKilof in the console. Typical messages:
| What you see | What it means |
|---|---|
Unsupported API version | The server is older than 1.21. Update it or use an older plugin build |
Error occurred while enabling | Usually a config.yml error. Delete the file and let the plugin regenerate it |
| Nothing — the plugin is not mentioned at all | The JAR is not in plugins/, is in a subfolder, or was unzipped |
Also check /plugins in game — GrzybcioKilof should be green. Red means the plugin is
loaded but disabled.
/grzybcio-kilof reload needs the grzybciokilof.reload permission, which is separate
from grzybciokilof.give. This trips people up often — someone can hand out pickaxes but
not reload the plugin.
If you have the permission and the reload still fails, it is almost certainly a YAML syntax error. The usual suspects:
- Tabs instead of spaces. YAML does not accept them.
- No space after a colon. It has to be
kopanie-promien: 1, notkopanie-promien:1. - An unclosed quote in one of the messages or in the pickaxe name.
Paste the file into any YAML validator — it will point at the line.
Instead of a colour you literally see ED4E6. Possible causes:
- The server does not support HEX. HEX colours work from Minecraft 1.16 onwards. On older versions use the legacy codes (
&b,&a,&e). - Wrong format. It has to be
&#RRGGBBor<#RRGGBB>— six characters, no spaces, no dashes. - A typo in the colour code.
ED4E(five characters) will not be recognised.
Check whether another plugin on your server hooks the block break event — typically land protection, anti-grief or a custom mining economy plugin. When two plugins handle the same event, the second one can cancel the drops.
Quickest test: disable the suspects one at a time, restarting after each.
Check kopanie-promien in config.yml. At 3 a single swing is 49 blocks — with a few
players at once that is hundreds of operations per second, plus drops and lighting
updates.
Drop back to 1 (3×3). If the lag persists, check /timings or /spark — the problem is
almost certainly somewhere else.
By default the plugin touches everything except bedrock. If players are losing chests,
spawners or blocks from other plugins, add them to bloki-wykluczone:
bloki-wykluczone:
- BEDROCK
- SPAWNER
- CHEST
- TRAPPED_CHEST
- BARREL
- SHULKER_BOX
- ENDER_CHEST
- BEACONThen run /grzybcio-kilof reload.
Reporting a bug
If none of the above helped, open an issue in the GitHub repository. Include:
- your server version (
versionin the console) and the plugin version, - your
config.yml, - the relevant part of
logs/latest.log, - your plugin list (
/plugins).