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ă
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.
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.#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.ymlcu clasa principală,api-version, comenzile și permisiunile, șiconfig.ymlcând există setări.
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
| Simptom | Cauză 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 vechi | Pluginul vizează un API mai nou decât serverul tău. Spune în cerere versiunea exactă a serverului. |
| O comandă nu face nimic | Comanda lipsește din plugin.yml sau jucătorul nu are permisiunea. |
NoClassDefFoundError pentru Vault sau ceva similar | Pluginul de care depinde nu este instalat pe server. |
| Se compilează, dar o funcție nu se comportă corect | Descrie în chat comportamentul exact din joc. Verificarea controlează build-ul, nu gameplay-ul. |