Οδηγός

Πώς να διορθώσεις σφάλματα σε Minecraft plugins

Ενημερώθηκε 18 Οκτωβρίου 2026

Όταν ένα plugin δεν φορτώνει, ο server σχεδόν πάντα λέει γιατί: ο λόγος είναι στην κονσόλα κατά την εκκίνηση, λίγες γραμμές πάνω ή κάτω από το όνομα του plugin. Μάθε να διαβάζεις αυτό το κομμάτι του log και τα περισσότερα σφάλματα διορθώνονται σε ένα λεπτό. Δες τα πιο συνηθισμένα και τι σημαίνουν.

Γράψε την έκδοση του server σου και τι πρέπει να κάνει το plugin.

Φτιάξ' το με το Codexe

Βήμα βήμα

1.Άνοιξε το log της εκκίνησης
Διάβασε την κονσόλα ή το logs/latest.log στον φάκελο του server. Σε πάνελ hosting, χρησιμοποίησε την κονσόλα ή τον file manager του.
2.Ψάξε το όνομα του plugin
Βρες το πρώτο σφάλμα που το αναφέρει. Οι γραμμές που ξεκινούν με [ERROR] ή [WARN] και το stack trace από κάτω τους είναι αυτές που μετράνε.
3.Διάβασε την πρώτη γραμμή και τις γραμμές «Caused by»
Η πρώτη γραμμή λέει τι απέτυχε· η τελευταία γραμμή Caused by: συνήθως λέει γιατί. Οι γραμμές με το όνομα του package του ίδιου του plugin δείχνουν πού στον κώδικά του.
4.Αντιστοίχισέ το με τη λίστα παρακάτω
Τα περισσότερα σφάλματα εκκίνησης είναι πρόβλημα έκδοσης, Java ή εξάρτησης, και το μήνυμα λέει ποιο.
5.Διόρθωσε ένα πράγμα και κάνε επανεκκίνηση
Άλλαξε ένα πράγμα, κάνε επανεκκίνηση (όχι /reload) και διάβασε ξανά το log. Τα σφάλματα ενός plugin μπορεί να προκαλέσουν σφάλματα σε άλλα.

Τα συνηθισμένα σφάλματα

Βλέπεις	Τι σημαίνει	Λύση
`Unsupported API version 1.21`	Το `api-version` του plugin είναι νεότερο από τον server σου.	Πάρε την έκδοση για τον server σου ή ενημέρωσε τον server.
`Could not load 'plugins/X.jar'` με `Invalid plugin.yml` ή `Jar does not contain plugin.yml`	Ο descriptor του plugin λείπει ή έχει σφάλμα YAML, ή το αρχείο δεν είναι plugin.	Έλεγξε ότι κατέβασες το plugin και όχι τον κώδικά του, ένα mod ή ένα zip. Αν το έκανες build εσύ, διόρθωσε το `plugin.yml`.
`UnsupportedClassVersionError`, «class file version 65.0»	Το plugin χρειάζεται νεότερη Java από αυτή που τρέχει ο server (61 = Java 17, 65 = Java 21, 69 = Java 25).	Τρέξε τον server με εκείνη τη Java ή κάνε ξανά build το plugin για τη δική σου Java.
`NoClassDefFoundError` ή `ClassNotFoundException`	Μια κλάση που χρειάζεται το plugin δεν υπάρχει: λείπει ένα plugin-εξάρτηση, μια βιβλιοθήκη δεν έγινε shade μέσα στο .jar ή το API δεν υπάρχει σε αυτή την έκδοση.	Εγκατάστησε το plugin που αναφέρει το σφάλμα (Vault, ProtocolLib) ή χρησιμοποίησε ένα build για την έκδοσή σου.
`Unknown/missing dependency plugins`	Ένα plugin που αναφέρεται στο `depend` δεν είναι εγκατεστημένο.	Εγκατάστησέ το στο `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Το plugin φορτώθηκε αλλά έκανε crash στο `onEnable`.	Διάβασε τη γραμμή `Caused by`: συχνά είναι σφάλμα στο config ή εξάρτηση που λείπει.
`Ambiguous plugin name`	Δύο αρχεία .jar του ίδιου plugin βρίσκονται στο `plugins/`.	Διάγραψε το παλιό.

Σφάλματα που δεν αφορούν τη φόρτωση

Το plugin είναι πράσινο αλλά μια εντολή λέει «Unknown command»: η εντολή λείπει από το plugin.yml ή ένα άλλο plugin χρησιμοποιεί το ίδιο όνομα.
«I'm sorry, but you do not have permission»: ο παίκτης δεν έχει το permission node. Βρες το node στη σελίδα του plugin και δώσ' το με το plugin για permissions που χρησιμοποιείς.
Σφάλματα μετά από αλλαγές στο config.yml: το YAML θέλει κενά, όχι tabs, και εισαγωγικά γύρω από κείμενο που ξεκινά με : ή &.
Λειτουργεί μετά από επανεκκίνηση, χαλάει μετά από /reload: το plugin δεν υποστηρίζει το /reload. Κάνε επανεκκίνηση.

Ποια Java χρειάζεται ο server σου

Το Minecraft 1.20.5 και νεότερα χρειάζονται Java 21 και η 26.x χρειάζεται Java 25· οι 1.18 έως 1.20.4 χρειάζονται Java 17. Τρέξε java -version με την ίδια Java που χρησιμοποιεί ο server (σε πάνελ hosting είναι συνήθως μια ρύθμιση με το όνομα Docker image ή Java version). Ένα plugin φτιαγμένο για παλιότερη Java τρέχει σε νεότερη, όχι το αντίστροφο.

Διόρθωση plugins φτιαγμένων με το Codexe

Τα plugins που φτιάχνονται στο Codexe γίνονται compile για την έκδοση που διάλεξες και ελέγχονται για έγκυρο plugin.yml πριν γίνουν Έτοιμα. Σε έναν δοκιμαστικό server, η καρτέλα Logs δείχνει το log ζωντανά με τα σφάλματα τονισμένα και το Export logs το αποθηκεύει σε αρχείο. Περίγραψε τι βλέπεις στο chat του project («το plugin είναι κόκκινο στο /plugins και το log λέει ...») και το Codexe αλλάζει τον κώδικα και κάνει ξανά build. Αν μια Μεταγλώττιση αποτύχει σε αρχεία ακριβώς όπως τα παρέδωσε το Codexe, το Fix with AI τα διορθώνει δωρεάν.

Ερωτήσεις

Πού είναι το log του server;

Στο logs/latest.log στον φάκελο του server, για την τρέχουσα εκτέλεση. Οι παλιότερες εκτελέσεις βρίσκονται στον ίδιο φάκελο ως αρχεία .log.gz.

Μπορεί ένα plugin να χαλάσει ένα άλλο;

Ναι: μια εξάρτηση που λείπει ή είναι χαλασμένη σταματά κάθε plugin που τη χρειάζεται. Διόρθωσε το πρώτο σφάλμα στο log πριν από τα άλλα.

Είναι ασφαλές να μοιραστώ το log μου;

Κατά κανόνα ναι, αλλά έλεγξέ το πρώτα: τα logs μπορεί να περιέχουν διευθύνσεις IP και, με κάποια plugins, κωδικούς βάσεων δεδομένων από σφάλματα.

Ξαναφτιάξε ένα χαλασμένο plugin για τον server σου

Αυτό το prompt ανοίγει έτοιμο για αποστολή:

“Ένα plugin για Paper 1.21.4 με το όνομα SimpleWarps που αντικαθιστά το παλιό μου που δεν φορτώνει πια: /setwarp, /warp και /delwarp με όνομα, το /warps τα δείχνει σε ένα GUI, permission warps.admin για ορισμό και διαγραφή, τα warps διατηρούνται μετά από επανεκκινήσεις, μηνύματα στο config.yml.”