Problemy
Kilof kopie jeden blok, plugin się nie włącza, dropy nie wypadają — objawy i przyczyny.
Zanim zaczniesz szukać — sprawdź konsolę serwera. Większość problemów z pluginami zostawia tam konkretny komunikat, a bez niego zgadujemy.
Najczęstsze przyczyny, w kolejności od najbardziej prawdopodobnej:
- Trzymasz zwykły kilof, nie ten z pluginu. Plugin rozpoznaje swój przedmiot po tym,
jak został wydany komendą. Zwykły netherytowy kilof z ekwipunku nie zadziała — musisz
dostać go przez
/grzybcio-kilof. - Masz włączone
wymagaj-uprawnienia: true, a nie maszgrzybciokilof.use. Wtedy kilof celowo zachowuje się jak zwykły. Sprawdź/lp user <nick> permission check grzybciokilof.use. - Blok jest na liście wykluczeń. Domyślnie jest tam bedrock. Sprawdź
bloki-wykluczonewconfig.yml. - Kilof wydany przed zmianą konfiguracji. Jeśli zmieniałeś
kilof-typ, stare egzemplarze mogą już nie pasować. Wydaj sobie nowy.
Poszukaj w konsoli linii ze słowem GrzybcioKilof. Typowe komunikaty:
| Co widzisz | Co to znaczy |
|---|---|
Unsupported API version | Serwer jest starszy niż 1.21. Zaktualizuj serwer albo użyj starszej wersji pluginu |
Error occurred while enabling | Zwykle błąd w config.yml. Skasuj plik i pozwól pluginowi wygenerować go od nowa |
| Nic — plugin w ogóle nie występuje w logu | JAR nie jest w plugins/, jest w podkatalogu albo został rozpakowany |
Sprawdź też /plugins w grze — GrzybcioKilof powinien być na zielono. Czerwony oznacza,
że plugin jest wczytany, ale wyłączony.
/grzybcio-kilof reload wymaga uprawnienia grzybciokilof.reload, które jest osobne od
grzybciokilof.give. To częsta pomyłka — ktoś ma prawo wydawać kilofy, ale nie
przeładowywać pluginu.
Jeśli masz uprawnienie, a przeładowanie i tak nie działa, to prawie na pewno błąd składni w YAML-u. Najczęstsze:
- Tabulatory zamiast spacji. YAML ich nie akceptuje.
- Brak spacji po dwukropku. Musi być
kopanie-promien: 1, niekopanie-promien:1. - Niezamknięty cudzysłów w którejś wiadomości albo w nazwie kilofa.
Wklej plik do dowolnego walidatora YAML — pokaże numer linii.
Zamiast koloru widzisz dosłownie ED4E6. Możliwe przyczyny:
- Serwer nie obsługuje HEX-a. Kolory HEX działają od Minecrafta 1.16. Na starszych wersjach użyj zwykłych kodów (
&b,&a,&e). - Zły format. Musi być
&#RRGGBBalbo<#RRGGBB>— sześć znaków, bez spacji, bez myślników. - Literówka w kodzie koloru.
ED4E(pięć znaków) nie zostanie rozpoznane.
Sprawdź, czy nie masz na serwerze pluginu, który przechwytuje zdarzenie niszczenia bloku — typowo są to pluginy od ochrony terenu, anty-griefu albo od własnej ekonomii kopania. Gdy dwa pluginy obsługują to samo zdarzenie, drugi może anulować dropy.
Najszybszy test: wyłącz kolejno podejrzane pluginy i sprawdzaj po każdym restarcie.
Sprawdź kopanie-promien w config.yml. Przy 3 jedno uderzenie to 49 bloków —
przy kilku graczach naraz to już setki operacji na sekundę, do tego dropy i aktualizacje
oświetlenia.
Zejdź do 1 (3×3). Jeśli lagi zostają, sprawdź /timings albo /spark — problem
prawie na pewno leży gdzie indziej.
Plugin domyślnie rusza wszystko poza bedrockiem. Jeśli graczom znikają skrzynie,
spawnery albo bloki z innych pluginów, dopisz je do bloki-wykluczone:
bloki-wykluczone:
- BEDROCK
- SPAWNER
- CHEST
- TRAPPED_CHEST
- BARREL
- SHULKER_BOX
- ENDER_CHEST
- BEACONPo zmianie: /grzybcio-kilof reload.
Zgłaszanie błędu
Jeśli nic z powyższego nie pomogło, załóż zgłoszenie w repozytorium na GitHubie. Dołącz:
- wersję serwera (
versionw konsoli) i wersję pluginu, - swój
config.yml, - fragment logu z
logs/latest.logz momentu wystąpienia problemu, - listę pozostałych pluginów (
/plugins).