Ghid

Cum faci un plugin Spigot

Actualizat 7 octombrie 2026

Un plugin Spigot folosește API-ul Bukkit/Spigot, deci rulează pe Spigot și pe toate fork-urile lui, inclusiv Paper. Asta îl face alegerea cea mai largă când nu știi unde va rula pluginul. Acest ghid acoperă proiectul, codul și build-ul.

Schimbă exemplul după serverul tău.

Generează asta cu Codexe

Pas cu pas

  1. 1.Configurează Java și un instrument de build

    Instalează JDK-ul care se potrivește cu versiunea ta Minecraft (17, 21 sau 25) și folosește Maven sau Gradle.

  2. 2.Adaugă API-ul Spigot

    Adaugă spigot-api pentru versiunea ta din repository-ul Spigot, cu scope-ul provided. Este necesar doar pentru compilare; serverul îl furnizează la rulare.

  3. 3.Scrie comenzile și listener-ele

    Înregistrează un CommandExecutor cu getCommand("name").setExecutor(...) și listener-ele de evenimente cu registerEvents.

  4. 4.Scrie plugin.yml

    Nume, versiune, clasa principală, api-version (de la 1.13), comenzi și permisiuni.

  5. 5.Compilează și instalează

    mvn package, apoi copiază .jar-ul din target/ în folderul plugins/ al serverului și repornește.

Versiuni vechi (1.8 până la 1.12)

Multe servere de minijocuri încă rulează 1.8. API-ul este mai vechi (fără api-version, nume de materiale diferite), așa că un plugin trebuie scris pentru acea versiune, nu copiat dintr-un tutorial 1.21. Codexe întreabă versiunea și scrie codul pentru acel API.

Cu Codexe

Descrie pluginul și scrie „Spigot” cu versiunea. Codexe generează proiectul Maven, îl compilează, repară erorile și te lasă să îl testezi pe un server de testare de acea versiune înainte să îl descarci.

Întrebări

Am nevoie de BuildTools?

Doar ca să rulezi un server Spigot sau să folosești NMS (cod intern al serverului). Pentru a compila pe API-ul obișnuit, dependența spigot-api este suficientă.

Plugin Spigot sau plugin Paper?

Spigot dacă trebuie să ruleze peste tot; Paper dacă serverul tău rulează Paper și vrei API-ul lui suplimentar. Vezi cum faci un plugin Paper.

Creează un plugin Spigot

Acest prompt se deschide gata de trimis:

“Un plugin Spigot 1.8.8 numit Kits: /kit <name> dă un set configurabil de obiecte cu cooldown pe fiecare kit, kituri definite în config.yml, permisiunea kits.<name> pentru fiecare kit, cooldown-uri păstrate după restart.”

Generează asta cu Codexe
Cum faci un plugin Spigot: configurare, cod, build | Codexe