Opas

Miten korjata Minecraft-pluginin virheet

Päivitetty 18. lokakuuta 2026

Kun plugin ei lataudu, palvelin kertoo melkein aina miksi: syy on konsolissa käynnistyksen aikana, muutama rivi pluginin nimen ylä- tai alapuolella. Opettele lukemaan se osa lokista, niin useimpien virheiden korjaus vie minuutin. Tässä ovat yleisimmät ja niiden merkitys.

Kerro palvelimesi versio ja mitä pluginin pitäisi tehdä.

Generoi tämä Codexella

Vaihe vaiheelta

1.Avaa käynnistyksen loki
Lue konsoli tai palvelinkansion logs/latest.log. Hallintapaneelissa käytä sen konsolia tai tiedostonhallintaa.
2.Etsi pluginin nimeä
Etsi ensimmäinen virhe, jossa se mainitaan. Merkitykselliset rivit alkavat [ERROR] tai [WARN] ja niiden alla on pinojälki.
3.Lue ensimmäinen rivi ja "Caused by" -rivit
Ensimmäinen rivi kertoo, mikä epäonnistui; viimeinen Caused by: -rivi kertoo yleensä miksi. Rivit, joissa on pluginin oma paketin nimi, näyttävät, missä kohtaa sen koodia.
4.Vertaa sitä alla olevaan listaan
Useimmat käynnistysvirheet ovat versio-, Java- tai riippuvuusongelmia, ja viesti kertoo, mikä.
5.Korjaa yksi asia ja käynnistä uudelleen
Muuta yhtä asiaa, käynnistä uudelleen (älä käytä /reload) ja lue loki uudelleen. Yhden pluginin virheet voivat aiheuttaa virheitä muissa.

Yleiset virheet

Näet	Mitä se tarkoittaa	Korjaus
`Unsupported API version 1.21`	Pluginin `api-version` on uudempi kuin palvelimesi.	Hae palvelimellesi sopiva versio tai päivitä palvelin.
`Could not load 'plugins/X.jar'` ja `Invalid plugin.yml` tai `Jar does not contain plugin.yml`	Pluginin kuvaustiedosto puuttuu tai siinä on YAML-virhe, tai tiedosto ei ole plugin.	Tarkista, että latasit pluginin etkä sen lähdekoodia, modia tai zipiä. Jos koosit sen itse, korjaa `plugin.yml`.
`UnsupportedClassVersionError`, "class file version 65.0"	Plugin vaatii uudemman Javan kuin palvelin käyttää (61 = Java 17, 65 = Java 21, 69 = Java 25).	Aja palvelinta sillä Javalla tai kokoa plugin uudelleen omalle Javallesi.
`NoClassDefFoundError` tai `ClassNotFoundException`	Luokka, jota plugin tarvitsee, puuttuu: riippuvuusplugin puuttuu, kirjastoa ei ole shadattu .jar-tiedostoon tai API:a ei ole tässä versiossa.	Asenna virheessä nimetty plugin (Vault, ProtocolLib) tai käytä versiollesi tehtyä koontia.
`Unknown/missing dependency plugins`	Kohdassa `depend` listattua pluginia ei ole asennettu.	Asenna se kansioon `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Plugin latautui, mutta kaatui metodissa `onEnable`.	Lue `Caused by` -rivi: usein kyse on asetusvirheestä tai puuttuvasta riippuvuudesta.
`Ambiguous plugin name`	Kansiossa `plugins/` on saman pluginin kaksi .jar-tiedostoa.	Poista vanha.

Virheet, jotka eivät liity lataamiseen

Plugin on vihreä, mutta komento sanoo "Unknown command": komento puuttuu tiedostosta plugin.yml, tai toinen plugin käyttää samaa nimeä.
"I'm sorry, but you do not have permission": pelaajalta puuttuu oikeussolmu. Tarkista solmu pluginin sivulta ja anna se oikeuspluginillasi.
Virheet config.yml-tiedoston muokkauksen jälkeen: YAML vaatii välilyönnit, ei sarkaimia, ja lainausmerkit tekstin ympärille, joka alkaa merkillä : tai &.
Toimii uudelleenkäynnistyksen jälkeen, hajoaa /reloadin jälkeen: plugin ei tue komentoa /reload. Käynnistä uudelleen sen sijaan.

Mitä Javaa palvelimesi tarvitsee

Minecraft 1.20.5 ja uudemmat vaativat Java 21:n, ja 26.x vaatii Java 25:n; 1.18-1.20.4 vaativat Java 17:n. Aja java -version samalla Javalla, jota palvelin käyttää (hallintapaneelissa se on yleensä asetus nimeltä Docker image tai Java version). Vanhemmalle Javalle koottu plugin toimii uudemmalla, mutta ei toisin päin.

Codexella tehtyjen pluginien korjaus

Codexella tehdyt pluginit käännetään valitsemallesi versiolle, ja niistä tarkistetaan kelvollinen plugin.yml ennen kuin ne ovat valmiita. Testipalvelimella Lokit-välilehti näyttää lokin reaaliajassa virheet korostettuina, ja Vie lokit tallentaa sen tiedostoksi. Kuvaile projektin chatissa, mitä näet ("plugin on punainen /plugins-listassa ja lokissa lukee ..."), niin Codexe muuttaa koodia ja kokoaa uudelleen. Jos Käännä epäonnistuu tiedostoilla, jotka ovat täsmälleen sellaisina kuin Codexe ne toimitti, Korjaa tekoälyllä korjaa ne ilmaiseksi.

Kysymykset

Missä palvelimen loki on?

Palvelinkansion logs/latest.log nykyisestä ajosta. Aiemmat ajot ovat samassa kansiossa .log.gz-tiedostoina.

Voiko yksi plugin rikkoa toisen?

Kyllä: puuttuva tai rikkinäinen riippuvuus pysäyttää jokaisen pluginin, joka tarvitsee sitä. Korjaa lokin ensimmäinen virhe ennen muita.

Onko lokini jakaminen turvallista?

Enimmäkseen, mutta tarkista se ensin: lokeissa voi olla IP-osoitteita ja joidenkin pluginien kohdalla virheistä peräisin olevia tietokantasalasanoja.

Kokoa rikkinäinen plugin uudelleen palvelimellesi

Tämä kehote aukeaa valmiina lähetettäväksi:

“Paper 1.21.4 -plugin nimeltä SimpleWarps, joka korvaa vanhan, enää latautumattoman pluginini: /setwarp, /warp ja /delwarp nimellä, /warps listaa ne GUI:ssa, oikeus warps.admin asettamiseen ja poistamiseen, warpit säilyvät uudelleenkäynnistysten yli, viestit config.yml-tiedostossa.”