Ръководство

Как да направиш Spigot плъгин

Обновено на 7 октомври 2026 г.

Spigot плъгинът използва Bukkit/Spigot API, така че работи на Spigot и на всеки негов fork, включително Paper. Затова е най-широкият избор, когато не знаеш къде ще работи плъгинът. Това ръководство обхваща проекта, кода и компилацията.

Промени примера според сървъра си.

Генерирай това с Codexe

Стъпка по стъпка

  1. 1.Настрой Java и инструмент за компилация

    Инсталирай JDK, който съответства на версията ти на Minecraft (17, 21 или 25), и използвай Maven или Gradle.

  2. 2.Добави Spigot API

    Добави spigot-api за версията си от хранилището на Spigot със scope provided. Трябва само за компилиране; сървърът го осигурява при работа.

  3. 3.Напиши команди и listeners

    Регистрирай CommandExecutor с getCommand("name").setExecutor(...) и event listeners с registerEvents.

  4. 4.Напиши plugin.yml

    Име, версия, главен клас, api-version (от 1.13), команди и права.

  5. 5.Компилирай и инсталирай

    mvn package, после копирай .jar файла от target/ в папката plugins/ на сървъра и рестартирай.

Стари версии (от 1.8 до 1.12)

Много сървъри с мини игри още работят на 1.8. API-то е по-старо (няма api-version, други имена на материалите), така че плъгинът трябва да е писан за тази версия, а не копиран от ръководство за 1.21. Codexe пита за версията и пише кода за този API.

С Codexe

Опиши плъгина и напиши „Spigot“ с версията. Codexe генерира Maven проекта, компилира го, поправя грешките и те оставя да го тестваш на тестов сървър с тази версия, преди да го изтеглиш.

Въпроси

Трябва ли ми BuildTools?

Само за да пуснеш Spigot сървър или да използваш NMS (вътрешния код на сървъра). За компилиране срещу нормалния API е достатъчна зависимостта spigot-api.

Spigot плъгин или Paper плъгин?

Spigot, ако трябва да работи навсякъде; Paper, ако сървърът ти е на Paper и искаш допълнителния му API. Виж как да направиш Paper плъгин.

Направи Spigot плъгин

Този промпт се отваря готов за изпращане:

“Spigot 1.8.8 плъгин, наречен Kits: /kit <name> дава настройваем набор от предмети с cooldown за всеки кит, китовете са описани в config.yml, право kits.<name> за всеки кит, cooldown-ите се пазят след рестарти.”

Генерирай това с Codexe
Как да направиш Spigot плъгин: настройка, код, компилация | Codexe