Руководство

Как сделать плагин для Spigot

Обновлено: 7 октября 2026 г.

Плагин для Spigot использует API Bukkit/Spigot, поэтому он работает на Spigot и на всех его форках, включая Paper. Это самый универсальный выбор, когда вы не знаете, где будет работать плагин. В этом руководстве разбираются проект, код и сборка.

Измените пример под свой сервер.

Сгенерировать это в Codexe

Шаг за шагом

  1. 1.Настройте Java и инструмент сборки

    Установите JDK под вашу версию Minecraft (17, 21 или 25) и используйте Maven или Gradle.

  2. 2.Добавьте Spigot API

    Добавьте spigot-api для вашей версии из репозитория Spigot с областью provided. Он нужен только для компиляции; во время работы его предоставляет сервер.

  3. 3.Напишите команды и слушатели

    Зарегистрируйте CommandExecutor через getCommand("name").setExecutor(...), а слушатели событий через 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> выдаёт настраиваемый набор предметов с кулдауном на каждый набор, наборы описаны в config.yml, право kits.<name> для каждого набора, кулдауны сохраняются после перезапусков.”

Сгенерировать это в Codexe
Как сделать плагин для Spigot: настройка, код, сборка | Codexe