Poradnik

Jak zrobić plugin na Spigot

Zaktualizowano: 7 października 2026

Plugin na Spigot używa API Bukkit/Spigot, więc działa na Spigocie i na każdym jego forku, w tym na Paperze. To najszerszy wybór, gdy nie wiesz, gdzie plugin będzie działał. Ten poradnik obejmuje projekt, kod i budowanie.

Zmień przykład pod swój serwer.

Wygeneruj to w Codexe

Krok po kroku

  1. 1.Skonfiguruj Javę i narzędzie do budowania

    Zainstaluj JDK zgodne z twoją wersją Minecrafta (17, 21 lub 25) i użyj Maven lub Gradle.

  2. 2.Dodaj Spigot API

    Dodaj spigot-api dla swojej wersji z repozytorium Spigot w zakresie provided. Jest potrzebne tylko do kompilacji; w trakcie działania udostępnia je serwer.

  3. 3.Napisz komendy i listenery

    Zarejestruj CommandExecutor przez getCommand("name").setExecutor(...), a listenery zdarzeń przez registerEvents.

  4. 4.Napisz plugin.yml

    Nazwa, wersja, klasa główna, api-version (od 1.13), komendy i uprawnienia.

  5. 5.Zbuduj i zainstaluj

    mvn package, potem skopiuj plik .jar z target/ do folderu plugins/ serwera i zrestartuj go.

Stare wersje (od 1.8 do 1.12)

Wiele serwerów z minigrami nadal działa na 1.8. API jest starsze (brak api-version, inne nazwy materiałów), więc plugin trzeba napisać pod tę wersję, a nie kopiować z poradnika do 1.21. Codexe pyta o wersję i pisze kod pod jej API.

Z Codexe

Opisz plugin i napisz „Spigot” z wersją. Codexe wygeneruje projekt Maven, skompiluje go, naprawi błędy i pozwoli ci przetestować go na serwerze testowym tej wersji, zanim go pobierzesz.

Pytania

Czy potrzebuję BuildTools?

Tylko po to, żeby uruchomić serwer Spigot lub użyć NMS (wewnętrznego kodu serwera). Do kompilacji ze zwykłym API wystarczy zależność spigot-api.

Plugin na Spigot czy na Paper?

Spigot, jeśli ma działać wszędzie; Paper, jeśli twój serwer działa na Paperze i chcesz korzystać z jego dodatkowego API. Zobacz jak zrobić plugin na Paper.

Zrób plugin na Spigot

Ten prompt otworzy się gotowy do wysłania:

“Plugin na Spigot 1.8.8 o nazwie Kits: /kit <name> daje konfigurowalny zestaw przedmiotów z cooldownem dla każdego zestawu, zestawy zdefiniowane w config.yml, uprawnienie kits.<name> dla każdego zestawu, cooldowny zapisywane między restartami.”

Wygeneruj to w Codexe
Jak zrobić plugin na Spigot: konfiguracja, kod, budowanie | Codexe