Sari la conținut
Platforme

Plugin-uri Spigot și Paper

Cum obții de la Codexe cel mai bun plugin Bukkit, Spigot sau Paper, în Java sau Kotlin. Ce să pui în cerere, versiuni, plugin.yml, dependențe, build-ul și problemele frecvente.

Actualizat

Pe această pagină
  1. Ce să pui în cerere
  2. Ce generează Codexe
  3. Versiuni și Java
  4. Build și verificare
  5. Instalare
  6. Probleme frecvente

Tipurile Bukkit/Spigot/Paper produc un plugin de server care rulează pe Paper, Spigot și pe fork-urile lor. Alege Java (proiect Maven) sau Kotlin (proiect Gradle cu build.gradle.kts).

Ca să îți joci pluginul în joc, pornește un server de testare privat cu Încearcă acum.

Când trimiți cererea, Codexe te întreabă pentru ce versiune Minecraft este pluginul, de la 1.8.8 la 26.3. Codul este scris pentru API-ul și nivelul Java ale acelei versiuni, iar serverul de testare rulează acea versiune. Proiectele create înainte de 30 septembrie 2026 păstrează versiunea scrisă în fișierele lor de build.

#Ce să pui în cerere

  • Software-ul serverului și versiunea: „Paper 1.21.4” sau „Spigot 1.20.1”. Paper are un API mai larg decât Spigot. Codul scris pentru Spigot rulează pe Paper, dar nu și invers, așa că cere Spigot dacă ai nevoie de amândouă.
  • Comenzile cu argumente, cine le poate folosi și completarea cu tab.
  • Permisiunile cu valorile lor implicite (true, op, false).
  • Cheile din config.yml pe care vrei să le poți edita.
  • Stocarea: YAML, SQLite, MySQL sau în memorie.
  • Integrările: Vault, PlaceholderAPI, LuckPerms, WorldGuard…, numite explicit ca să fie adăugate ca dependențe.
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.

#Ce generează Codexe

  • Un proiect Maven (Java) sau Gradle (Kotlin) cu dependența de API corectă.
  • Clasa principală care extinde JavaPlugin, plus clase pentru comenzi, listeneri și stocare.
  • plugin.yml cu clasa principală, api-version, comenzile și permisiunile, și config.yml când există setări.
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

#Versiuni și Java

Codexe citește versiunea Minecraft din fișierul de build și compilează cu Java 17 (înainte de 1.20.5), Java 21 (1.20.5 și mai noi) sau Java 25 (26.x). Dacă nu precizezi o versiune, se folosește API-ul Paper/Spigot 1.20.6.

#Build și verificare

Codexe compilează pluginul înainte să îl declare Gata și verifică dacă JAR-ul conține clasele și un plugin.yml (sau paper-plugin.yml). Build-urile de plugin-uri durează de obicei cu mult sub un minut. Vezi Compilează.

#Instalare

Descarcă JAR-ul, pune-l în plugins/, repornește serverul (nu folosi /reload) și verifică în consolă dacă apar erori la pornire.

#Probleme frecvente

SimptomCauză probabilă
Pluginul nu se încarcă, „main class not found”main: din plugin.yml nu corespunde clasei. Cere-i chatului să repare sau verifică după redenumirile făcute de mână.
„Unsupported API version” pe un server mai vechiPluginul vizează un API mai nou decât serverul tău. Spune în cerere versiunea exactă a serverului.
O comandă nu face nimicComanda lipsește din plugin.yml sau jucătorul nu are permisiunea.
NoClassDefFoundError pentru Vault sau ceva similarPluginul de care depinde nu este instalat pe server.
Se compilează, dar o funcție nu se comportă corectDescrie în chat comportamentul exact din joc. Verificarea controlează build-ul, nu gameplay-ul.
Plugin-uri Spigot și Paper | Codexe Docs