Poradnik

Jak zrobić plugin na Paper

Zaktualizowano: 7 października 2026

Paper to najpopularniejsze oprogramowanie serwerowe Minecrafta dla pluginów: uruchamia pluginy Spigot i dodaje na wierzchu większe, szybsze API. Plugin na Paper to projekt w Javie (lub Kotlinie) kompilowany z paper-api. Oto, czego potrzebuje: robiony ręcznie albo z AI, która zbuduje go za ciebie.

Przykład na początek.

Wygeneruj to w Codexe

Krok po kroku

  1. 1.Wybierz wersję Minecrafta

    Użyj wersji, na której działa twój serwer. To ona decyduje o wersji Javy: Java 17 przed 1.20.5, Java 21 od 1.20.5, Java 25 dla 26.x.

  2. 2.Utwórz projekt

    Projekt Gradle lub Maven z zależnością paper-api dla tej wersji, z repozytorium PaperMC, w zakresie provided/compileOnly.

  3. 3.Napisz klasę główną

    Klasa rozszerzająca JavaPlugin, z metodą onEnable() rejestrującą komendy i listenery.

  4. 4.Opisz plugin serwerowi

    plugin.yml (name, version, main, api-version, commands, permissions). Paper obsługuje też paper-plugin.yml, z własnymi zasadami ładowania.

  5. 5.Zbuduj i przetestuj

    Zbuduj plik .jar, wrzuć go do folderu plugins/ serwera testowego Paper, uruchom serwer i sprawdź konsolę pod kątem błędów.

Paper czy Spigot?

Kod napisany pod API Spigot działa na Paperze, ale nie odwrotnie: Paper dodaje zdarzenia i metody (na przykład komponenty tekstowe Adventure i wiele asynchronicznych API), których Spigot nie ma. Pisz pod Paper, jeśli twój serwer działa na Paperze; pisz pod Spigot, jeśli plugin ma działać także na serwerach Spigot.

Szybka droga

W Codexe wybierz plugin Bukkit/Spigot/Paper, wpisz w zapytaniu „Paper” i wersję, a potem opisz, co plugin robi. Codexe skonfiguruje projekt i odpowiednią wersję Javy, skompiluje go, naprawi błędy budowania i pozwoli ci wejść na serwer testowy Paper z zainstalowanym pluginem.

Częste problemy

  • UnsupportedClassVersionError: plugin został skompilowany nowszą Javą, niż ta, na której działa serwer.
  • NoSuchMethodError / NoClassDefFoundError: plugin używa API, które nie istnieje w wersji serwera, albo zależność nie została dołączona (shade) do pliku .jar.
  • Plugin się ładuje, ale komendy nic nie robią: komendy brakuje w plugin.yml albo executor nie jest zarejestrowany.

Pytania

Czy pluginy Paper działają na Purpur lub Folia?

Purpur to fork Papera, więc pluginy Paper na nim działają. Folia zmienia obsługę wątków: żeby plugin działał na Folii, musi być napisany pod jej regionalny scheduler.

Czy mogę napisać plugin na Paper w Kotlinie?

Tak. Codexe potrafi wygenerować projekt Gradle w Kotlinie z build.gradle.kts dla tego samego Paper API.

Zrób plugin na Paper już teraz

Ten prompt otworzy się gotowy do wysłania:

“Plugin na Paper 1.21.4 o nazwie Bounties: /bounty set <player> <amount> z ekonomią Vault, zabójca dostaje nagrodę, /bounty list pokazuje top 10, listy gończe zapisują się między restartami, wiadomości w config.yml.”

Wygeneruj to w Codexe
Jak zrobić plugin na Paper (Minecraft) | Codexe