Platformy

Pluginy Spigot i Paper

Jak uzyskać od Codexe najlepszy plugin Bukkit, Spigot lub Paper, w Javie albo Kotlinie. Co wpisać w prośbie, wersje, plugin.yml, zależności, build i typowe problemy.

Zaktualizowano 30 września 2026

Na tej stronie

Co wpisać w prośbie
Co generuje Codexe
Wersje i Java
Build i weryfikacja
Instalacja
Typowe problemy

Typy Plugin Bukkit/Spigot/Paper (Java) tworzą plugin serwerowy, który działa na Paperze, Spigocie i ich forkach. Wybierz Java (projekt Maven) albo Kotlin (projekt Gradle z build.gradle.kts).

Aby zagrać ze swoim pluginem w grze, uruchom prywatny serwer testowy przyciskiem Wypróbuj teraz.

Gdy wysyłasz prośbę, Codexe pyta, dla której wersji Minecrafta jest plugin, od 1.8.8 do 26.3. Kod jest pisany pod API i poziom Javy tej wersji, a serwer testowy działa na tej wersji. Projekty utworzone przed 30 września 2026 zachowują wersję zapisaną w swoich plikach builda.

#Co wpisać w prośbie

Oprogramowanie serwera i wersja: „Paper 1.21.4” albo „Spigot 1.20.1”. Paper ma większe API niż Spigot. Kod napisany pod Spigota działa na Paperze, ale nie odwrotnie, więc jeśli potrzebujesz obu, poproś o Spigota.
Komendy z argumentami, informacją, kto może ich używać, i podpowiadaniem tabulatorem.
Uprawnienia z wartościami domyślnymi (true, op, false).
Klucze w config.yml, które mają być edytowalne.
Przechowywanie danych: YAML, SQLite, MySQL albo w pamięci.
Integracje: Vault, PlaceholderAPI, LuckPerms, WorldGuard…, wymienione wprost, żeby zostały dodane jako zależności.

Prośba w JavieProśba w Kotlinie

Text

A Paper 1.21.4 plugin (Java) called Bounties.
- /bounty set <player> <amount>: takes money via Vault, adds it to the player's bounty.
- Killing a player with a bounty pays it to the killer.
- /bounty top shows the 10 highest bounties.
- Bounties stored in SQLite. Minimum bounty 100 (config.yml).
- Permission bounties.set (default true).

Text

A Paper 1.21.4 plugin in Kotlin called Bounties, same features as above.
Use Kotlin idioms (data classes, extension functions) but keep the Bukkit API usage standard.

#Co generuje Codexe

Projekt Maven (Java) lub Gradle (Kotlin) z właściwą zależnością API.
Klasę główną rozszerzającą JavaPlugin, a do tego klasy komend, listenerów i przechowywania danych.
plugin.yml z klasą główną, api-version, komendami i uprawnieniami oraz config.yml, gdy są jakieś ustawienia.

YAML

name: Bounties
version: 1.0.0
main: eu.codexe.bounties.Bounties
api-version: '1.21'
depend: [Vault]
commands:
  bounty:
    description: Manage bounties
permissions:
  bounties.set:
    default: true

#Wersje i Java

Codexe odczytuje wersję Minecrafta z pliku builda i buduje z użyciem Java 17 (przed 1.20.5), Java 21 (1.20.5 i nowsze) lub Java 25 (26.x). Jeśli nie podasz wersji, używane jest API Paper/Spigot 1.20.6.

#Build i weryfikacja

Codexe kompiluje plugin, zanim uzna go za Gotowe, i sprawdza, czy JAR zawiera klasy oraz plugin.yml (lub paper-plugin.yml). Buildy pluginów trwają zwykle znacznie krócej niż minutę. Zobacz Skompiluj.

#Instalacja

Pobierz JAR, wrzuć go do plugins/, zrestartuj serwer (nie używaj /reload) i sprawdź w konsoli, czy przy starcie nie ma błędów.

#Typowe problemy

Objaw	Prawdopodobna przyczyna
Plugin się nie wczytuje, „main class not found”	`main:` w `plugin.yml` nie zgadza się z klasą. Poproś czat o poprawkę albo sprawdź to po ręcznej zmianie nazw.
„Unsupported API version” na starszym serwerze	Plugin jest pisany pod nowsze API niż twój serwer. Podaj w prośbie dokładną wersję serwera.
Komenda nic nie robi	Komendy brakuje w `plugin.yml` albo gracz nie ma uprawnienia.
`NoClassDefFoundError` dla Vaulta lub podobnego	Plugin, od którego zależy projekt, nie jest zainstalowany na serwerze.
Buduje się, ale jakaś funkcja działa źle	Opisz na czacie dokładne zachowanie w grze. Weryfikacja sprawdza build, a nie rozgrywkę.