Preskočiť na obsah
Platformy

Pluginy pre Spigot a Paper

Ako z Codexe dostať čo najlepší plugin pre Bukkit, Spigot alebo Paper, v Jave alebo Kotline. Čo dať do požiadavky, verzie, plugin.yml, závislosti, build a časté problémy.

Aktualizované

Na tejto stránke
  1. Čo dať do požiadavky
  2. Čo Codexe vygeneruje
  3. Verzie a Java
  4. Build a overenie
  5. Inštalácia
  6. Časté problémy

Typy Bukkit/Spigot/Paper vytvárajú serverový plugin, ktorý beží na Paper, Spigot a ich forkoch. Vyber Java (projekt Maven) alebo Kotlin (projekt Gradle s build.gradle.kts).

Ak si chceš plugin zahrať v hre, spusti súkromný testovací server cez Vyskúšaj teraz.

Keď odošleš požiadavku, Codexe sa opýta, pre akú verziu Minecraftu je plugin určený, od 1.8.8 po 26.3. Kód sa napíše pre API a úroveň Javy tejto verzie a testovací server beží na tejto verzii. Projekty vytvorené pred 30. septembrom 2026 si ponechajú verziu zapísanú vo svojich build súboroch.

#Čo dať do požiadavky

  • Serverový softvér a verziu: „Paper 1.21.4“ alebo „Spigot 1.20.1“. Paper má väčšie API ako Spigot. Kód napísaný pre Spigot beží na Paper, nie naopak, takže ak potrebuješ oboje, žiadaj Spigot.
  • Príkazy s argumentmi, kto ich môže používať, a dopĺňanie cez Tab.
  • Oprávnenia s ich predvolenými hodnotami (true, op, false).
  • Kľúče config.yml, ktoré chceš mať upraviteľné.
  • Ukladanie: YAML, SQLite, MySQL alebo v pamäti.
  • Integrácie: Vault, PlaceholderAPI, LuckPerms, WorldGuard…, pomenované výslovne, aby sa pridali ako závislosti.
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.

#Čo Codexe vygeneruje

  • Projekt Maven (Java) alebo Gradle (Kotlin) so správnou závislosťou API.
  • Hlavnú triedu, ktorá rozširuje JavaPlugin, plus triedy príkazov, listenerov a ukladania.
  • plugin.yml s hlavnou triedou, api-version, príkazmi a oprávneniami a config.yml, keď sú k dispozícii nastavenia.
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

#Verzie a Java

Codexe prečíta verziu Minecraftu z build súboru a zostavuje s Java 17 (pred 1.20.5), Java 21 (1.20.5 a novšie) alebo Java 25 (26.x). Ak verziu neuvedieš, použije sa API Paper/Spigot 1.20.6.

#Build a overenie

Codexe plugin skompiluje predtým, ako ho označí ako Pripravené, a skontroluje, či JAR obsahuje triedy a plugin.yml (alebo paper-plugin.yml). Buildy pluginov zvyčajne trvajú výrazne menej ako minútu. Pozri Skompilovať.

#Inštalácia

Stiahni JAR, vlož ho do plugins/, reštartuj server (nepoužívaj /reload) a pri štarte skontroluj chyby v konzole.

#Časté problémy

PríznakPravdepodobná príčina
Plugin sa nenačíta, „main class not found“main: v plugin.yml nezodpovedá triede. Požiadaj chat o opravu alebo to skontroluj po ručnom premenovaní.
„Unsupported API version“ na staršom serveriPlugin cieli na novšie API, než má tvoj server. V požiadavke uveď presnú verziu svojho servera.
Príkaz nič nerobíPríkaz chýba v plugin.yml alebo hráč nemá oprávnenie.
NoClassDefFoundError pre Vault alebo podobný pluginPlugin, od ktorého závisí, nie je na serveri nainštalovaný.
Zostaví sa, ale funkcia sa správa zleV chate opíš presné správanie v hre. Overenie kontroluje build, nie hrateľnosť.
Pluginy pre Spigot a Paper | Codexe Docs