Pluginy pro Spigot a Paper
Jak z Codexe dostat co nejlepší plugin pro Bukkit, Spigot nebo Paper, v Javě nebo Kotlinu. Co dát do zadání, verze, plugin.yml, závislosti, sestavení a časté problémy.
Aktualizováno
Na této stránce
Typy Bukkit/Spigot/Paper vytvářejí serverový plugin, který běží na Paperu, Spigotu a jejich forcích. Zvol Javu (projekt Maven) nebo Kotlin (projekt Gradle s build.gradle.kts).
Pokud si chceš plugin zahrát ve hře, spusť si soukromý testovací server přes Vyzkoušet hned.
Když zadání odešleš, Codexe se zeptá, pro jakou verzi Minecraftu plugin je, od 1.8.8 do 26.3. Kód se napíše pro API a úroveň Javy této verze a testovací server poběží na této verzi. Projekty vytvořené před 30. zářím 2026 si ponechávají verzi zapsanou ve svých souborech pro sestavení.
#Co dát do zadání
- Serverový software a verze: „Paper 1.21.4“ nebo „Spigot 1.20.1“. Paper má rozsáhlejší API než Spigot. Kód napsaný pro Spigot běží na Paperu, ale ne naopak, takže pokud potřebuješ obojí, žádej o Spigot.
- Příkazy s argumenty, kdo je smí používat, a doplňování tabulátorem.
- Oprávnění s jejich výchozími hodnotami (
true,op,false). - Klíče v config.yml, které chceš mít upravitelné.
- Ukládání dat: YAML, SQLite, MySQL nebo v paměti.
- Integrace: Vault, PlaceholderAPI, LuckPerms, WorldGuard…, výslovně jmenované, aby se přidaly jako závislosti.
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).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 Codexe vygeneruje
- Projekt Maven (Java) nebo Gradle (Kotlin) se správnou závislostí na API.
- Hlavní třídu rozšiřující
JavaPlugina k tomu třídy příkazů, listenerů a ukládání dat. plugin.ymls hlavní třídou,api-version, příkazy a oprávněními aconfig.yml, pokud jsou nějaká nastavení.
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#Verze a Java
Codexe přečte verzi Minecraftu ze souboru pro sestavení a sestavuje s Javou 17 (před 1.20.5), Javou 21 (1.20.5 a novější) nebo Javou 25 (26.x). Pokud verzi neuvedeš, použije se API Paper/Spigot 1.20.6.
#Sestavení a ověření
Codexe plugin zkompiluje, než ho označí jako Hotovo, a zkontroluje, že JAR obsahuje třídy a plugin.yml (nebo paper-plugin.yml). Sestavení pluginů obvykle trvá výrazně méně než minutu. Viz Kompilace.
#Instalace
Stáhni JAR, vlož ho do plugins/, restartuj server (nepoužívej /reload) a zkontroluj v konzoli, jestli se při startu neobjevily chyby.
#Časté problémy
| Příznak | Pravděpodobná příčina |
|---|---|
| Plugin se nenačte, „main class not found“ | main: v plugin.yml neodpovídá třídě. Požádej chat o opravu, nebo to zkontroluj po ručním přejmenování. |
| „Unsupported API version“ na starším serveru | Plugin cílí na novější API, než má tvůj server. Uveď v zadání přesnou verzi svého serveru. |
| Příkaz nic nedělá | Příkaz chybí v plugin.yml, nebo hráč nemá oprávnění. |
NoClassDefFoundError pro Vault a podobné | Plugin, na kterém závisí, není na serveru nainstalovaný. |
| Sestaví se, ale některá funkce se chová špatně | Popiš v chatu přesné chování ve hře. Ověření kontroluje sestavení, ne hratelnost. |