Dodaci na Minecraft poslužiteljima; Upravlja sustavom autorizacije, ekonomijom, zaštitom, tržištem, događajima, zahtjevima, anti-cheat i mnogim posebnim sustavima. Ako jedan od dodataka nije instaliran, značajan dio poslužitelja možda neće raditi.

Pogreške dodataka obično se javljaju u konzoli ili dnevnici/najnovije.log pojavljuje u datoteci. Najčešće greške; Nije moguće učitati dodatak, Nepodržana verzija API-ja, nepoznata ovisnost, Nevažeći plugin.yml i nekompatibilnosti Java verzije.

1. Gdje možete vidjeti pogrešku dodatka?

Ako se dodatak ne učitava, prvo mjesto koje trebate pogledati je konzola poslužitelja i datoteka latest.log.

tail -n 200 logs/latest.log

Za praćenje uživo:

tail -f logs/latest.log

Za pretraživanje prema nazivu dodatka:

grep -i "pluginadi" logs/latest.log

2. Pogreška verzije nepodržanog API-ja

Ova pogreška označava da verzija Minecraft API-ja koju podržava dodatak nije kompatibilna s verzijom poslužitelja.

Unsupported API version 1.20

Na primjer, dodatak može biti pripremljen za 1.20, ali vaš poslužitelj može pokrenuti 1.16.5. U tom slučaju dodatak se možda neće učitati ili može neispravno raditi.

rješenje:

• Provjerite koju verziju Minecrafta podržava dodatak.
• Preuzmite verziju dodatka kompatibilnu s verzijom vašeg poslužitelja.
• Nemojte očekivati da će novi dodaci raditi na vrlo starim poslužiteljima.
• Ako je potrebno, pronađite odgovarajuću verziju iz arhive stare verzije dodatka.

3. Nepoznata pogreška ovisnosti

Neki dodaci ne rade sami. Traži da se prvo instalira drugi dodatak. To se zove ovisnost.

Unknown dependency Vault
Could not load plugin because dependency LuckPerms was not found

Na primjer, ekonomski dodaci često Trezor želi. Dodaci za autorizaciju ili tržište mogu također trebati dodatke za druge knjižnice.

rješenje:

• Pročitajte zahtjeve na stranici dodatka.
• Preuzmite dodatak za ovisnosti koji nedostaje.
• Provjerite je li dodatak ovisnosti također kompatibilan s verzijom vašeg poslužitelja.
• Potpuno ponovno pokrenite poslužitelj.

4. Nevažeći dodatak.yml Greška

Unutar datoteke jar dodatka dodatak.yml Ako je datoteka oštećena, nedostaje ili je netočna, dodatak se ne može instalirati.

Invalid plugin.yml
Plugin does not contain a plugin.yml

To se obično događa kada:

• Preuzeta je pogrešna datoteka.
• Umjesto dodatka, zip izvornog koda smješten je u mapu dodataka.
• Jar datoteka je oštećena.
• Programer je neispravno upakirao dodatak.

Kao rješenje, dodatak je ispravan. .staklenka Datoteku treba preuzeti. Izvorni kod.zip preuzet s GitHuba ne smije se stavljati izravno u mapu dodataka.

5. Nekompatibilnost Java verzije

Minecraft verzija i dodaci zahtijevaju određene Java verzije. Ako se koristi pogrešna verzija Jave, dodatak ili poslužitelj se možda uopće neće otvoriti.

java -version

Uobičajena pogreška:

UnsupportedClassVersionError

Ova pogreška označava da je dodatak kompajliran s novijom Javom, ali se starija Java koristi na poslužitelju.

Opća logika:

• Starije verzije Minecrafta često zahtijevaju stariju Javu.
• Novije verzije Minecrafta zahtijevaju noviju Javu.
• Java zahtjev u opisu dodatka treba provjeriti.
• Odabrana verzija Java u hosting panelu mora biti verificirana.

6. Je li datoteka dodatka u ispravnoj mapi?

Datoteke dodataka na poslužiteljima Bukkit, Spigot i Paper dodaci se baca u mapu.

ls plugins/

Datoteka dodatka trebala bi biti ovakva:

plugins/PluginAdi.jar

Dodaci ostavljeni u zip, rar, izvornom kodu ili mapama često ne rade.

7. Sukobi dodataka

Dva dodatka koji rade isti posao mogu biti u sukobu jedan s drugim. Na primjer, dva različita dodatka za chat, dva različita ekonomska dodatka ili dva različita sustava zahtjeva mogu pokušati upravljati istim događajima.

Simptomi sukoba:

• Dodatak je instaliran, ali njegove naredbe ne rade.
• Jedan dodatak nadjača postavku drugog.
• Došlo je do sukoba događaja ili iznimke u konzoli.
• Igrači ne mogu koristiti naredbe čak i ako imaju dopuštenje.
• Poslužitelj se ponaša drugačije nakon ponovnog pokretanja.

Kako biste pronašli rješenje, dodatke je moguće testirati tako da ih onemogućite jednog po jednog. Međutim, prije nego što to učinite na poslužitelju uživo, treba napraviti sigurnosnu kopiju i dati prednost malom broju sati igrača.

8. Pogreška konfiguracije može spriječiti otvaranje dodatka

Neki se dodaci neće otvoriti ako u konfiguracijskoj datoteci postoji YAML pogreška. Uvlake razmaka posebno su važne u YAML datotekama.

Uobičajene pogreške:

• Korištenje tabulatorskog znaka
• Ne ostavljajte razmak nakon dvotočke
• Pisanje teksta koji zahtijeva navodnike bez navodnika
• Oštećenje datoteke zbog turskog znaka ili posebnog simbola
• Spremanje konfiguracijske datoteke koja nedostaje

Ako postoji netočna konfiguracijska datoteka, mapa dodatka može se privremeno preimenovati kako bi se napravila sigurnosna kopija mape dodatka i ponovno stvorila konfiguracija.

Uobičajene greške

• Instaliranje dodataka koji nisu kompatibilni s verzijom poslužitelja
• Ne instalirate dodatke ovisnosti koji nedostaju
• Zamjena GitHub izvorne zip datoteke kao dodatka
• Ne provjeravam verziju Jave
• Pokušavam instalirati dodatak s /reload
• Korištenje kartica u YAML konfiguracijskim datotekama

FAQ

Dodatak je u mapi dodataka, ali ne radi, zašto?
To može biti nekompatibilnost verzije, nedostajuća ovisnost, nekompatibilnost Jave ili pogreška konfiguracije. Treba pregledati najnoviju.log datoteku.

Što znači UnsupportedClassVersionError?
Dodatak je upravo kompajliran s Javom. Verzija Jave koja se koristi na poslužitelju je zastarjela.

Je li sigurno koristiti/reload?
Ne preporučuje se za mnoge dodatke. Potpuno ponovno pokretanje sigurnije je za instalaciju dodataka, uklanjanje i velike promjene konfiguracije.

Preporuke za sigurnost i rad

• Preuzmite dodatke iz pouzdanih izvora.
• Prije dodavanja dodatka na živi poslužitelj, isprobajte ga na testnom poslužitelju.
• Prije svakog ažuriranja dodatka napravite sigurnosnu kopiju mape dodataka.
• Smanjite površinu napada uklanjanjem nepotrebnih dodataka.
• Redovito provjeravajte zapisnike dodataka.

Ovaj članak je posebno pripremljen za PvPServer.