Návod

Jak vytvořit plugin pro Spigot

Aktualizováno 7. října 2026

Plugin pro Spigot používá API Bukkit/Spigot, takže běží na Spigotu i na každém jeho forku, včetně Paperu. To z něj dělá nejširší volbu, když nevíš, kde plugin poběží. Tento návod pokrývá projekt, kód a sestavení.

Změň příklad podle svého serveru.

Vygeneruj to s Codexe

Krok za krokem

  1. 1.Nastav Javu a nástroj pro sestavení

    Nainstaluj JDK odpovídající tvé verzi Minecraftu (17, 21 nebo 25) a použij Maven nebo Gradle.

  2. 2.Přidej API Spigotu

    Přidej spigot-api pro svoji verzi z repozitáře Spigotu s rozsahem provided. Potřebuje se jen ke kompilaci; za běhu ho poskytuje server.

  3. 3.Napiš příkazy a listenery

    Zaregistruj CommandExecutor pomocí getCommand("name").setExecutor(...) a posluchače událostí pomocí registerEvents.

  4. 4.Napiš plugin.yml

    Name, version, hlavní třída, api-version (od 1.13), commands a permissions.

  5. 5.Sestav a nainstaluj

    mvn package, pak zkopíruj .jar z target/ do složky plugins/ serveru a restartuj.

Staré verze (1.8 až 1.12)

Mnoho serverů s minihrami stále běží na 1.8. API je starší (bez api-version, jiné názvy materiálů), takže plugin musí být napsán pro tuto verzi, ne zkopírován z návodu pro 1.21. Codexe se zeptá na verzi a napíše kód pro dané API.

S Codexe

Popiš plugin a napiš „Spigot“ s verzí. Codexe vygeneruje projekt Maven, zkompiluje ho, opraví chyby a před stažením ti umožní otestovat ho na testovacím serveru dané verze.

Otázky

Potřebuju BuildTools?

Jen ke spuštění serveru Spigot nebo k použití NMS (interní kód serveru). Ke kompilaci proti běžnému API stačí závislost spigot-api.

Plugin pro Spigot, nebo pro Paper?

Spigot, pokud musí běžet všude; Paper, pokud tvůj server běží na Paperu a chceš jeho rozšířené API. Viz jak vytvořit plugin pro Paper.

Vytvoř plugin pro Spigot

Toto zadání se otevře připravené k odeslání:

“Plugin pro Spigot 1.8.8 s názvem Kits: /kit <name> dá konfigurovatelnou sadu předmětů s cooldownem pro každý kit, kity definované v config.yml, oprávnění kits.<name> pro každý kit, cooldowny uložené i po restartech.”

Vygeneruj to s Codexe
Jak vytvořit plugin pro Spigot: nastavení, kód, sestavení | Codexe