Οδηγός

Πώς να φτιάξεις ένα Spigot plugin

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

Ένα Spigot plugin χρησιμοποιεί το Bukkit/Spigot API, οπότε τρέχει στο Spigot και σε κάθε fork του, μαζί και το Paper. Γι' αυτό είναι η πιο ευρεία επιλογή όταν δεν ξέρεις πού θα τρέξει το plugin. Αυτός ο οδηγός καλύπτει το project, τον κώδικα και το build.

Άλλαξε το παράδειγμα για τον server σου.

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

Βήμα βήμα

  1. 1.Στήσε τη Java και ένα εργαλείο build

    Εγκατάστησε το JDK που αντιστοιχεί στην έκδοση Minecraft σου (17, 21 ή 25) και χρησιμοποίησε Maven ή Gradle.

  2. 2.Πρόσθεσε το Spigot API

    Πρόσθεσε το spigot-api για την έκδοσή σου από το αποθετήριο του Spigot με scope provided. Χρειάζεται μόνο για το compile· ο server το παρέχει κατά την εκτέλεση.

  3. 3.Γράψε εντολές και listeners

    Καταχώρησε έναν CommandExecutor με getCommand("name").setExecutor(...) και event listeners με registerEvents.

  4. 4.Γράψε το plugin.yml

    Όνομα, έκδοση, κύρια κλάση, api-version (από την 1.13), εντολές και δικαιώματα.

  5. 5.Build και εγκατάσταση

    mvn package, μετά αντίγραψε το .jar από το target/ στον φάκελο plugins/ του server και κάνε επανεκκίνηση.

Παλιές εκδόσεις (1.8 έως 1.12)

Πολλοί servers με minigames τρέχουν ακόμα 1.8. Το API είναι παλαιότερο (χωρίς api-version, διαφορετικά ονόματα υλικών), οπότε ένα plugin πρέπει να είναι γραμμένο για εκείνη την έκδοση, όχι αντιγραμμένο από ένα tutorial της 1.21. Το Codexe ρωτά την έκδοση και γράφει τον κώδικα για εκείνο το API.

Με το Codexe

Περίγραψε το plugin και γράψε «Spigot» με την έκδοση. Το Codexe δημιουργεί το project Maven, το κάνει compile, διορθώνει τα σφάλματα και σε αφήνει να το δοκιμάσεις σε δοκιμαστικό server εκείνης της έκδοσης πριν το κατεβάσεις.

Ερωτήσεις

Χρειάζομαι το BuildTools;

Μόνο για να τρέξεις server Spigot ή για να χρησιμοποιήσεις NMS (εσωτερικό κώδικα του server). Για compile με το κανονικό API, αρκεί το dependency spigot-api.

Spigot plugin ή Paper plugin;

Spigot αν πρέπει να τρέχει παντού· Paper αν ο server σου τρέχει Paper και θέλεις το επιπλέον API του. Δες πώς να φτιάξεις ένα Paper plugin.

Φτιάξε ένα Spigot plugin

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

“Ένα plugin για Spigot 1.8.8 με το όνομα Kits: το /kit <name> δίνει ένα ρυθμιζόμενο σετ items με cooldown ανά kit, kits ορισμένα στο config.yml, δικαίωμα kits.<name> ανά kit, cooldowns που αποθηκεύονται μετά από επανεκκινήσεις.”

Φτιάξ' το με το Codexe
Πώς να φτιάξεις ένα Spigot plugin: στήσιμο, κώδικας, build | Codexe