Перейти к содержимому
Платформы

Плагины Spigot и Paper

Как получить от Codexe лучший плагин Bukkit, Spigot или Paper на Java или Kotlin. Что указать в запросе, версии, plugin.yml, зависимости, сборка и частые проблемы.

Обновлено

На этой странице
  1. Что указать в запросе
  2. Что создаёт Codexe
  3. Версии и Java
  4. Сборка и проверка
  5. Установка
  6. Частые проблемы

Типы Bukkit/Spigot/Paper создают серверный плагин, который работает на Paper, Spigot и их форках. Выберите Java (проект Maven) или Kotlin (проект Gradle с build.gradle.kts).

Чтобы поиграть со своим плагином в игре, запустите приватный тестовый сервер через Попробовать сейчас.

Когда вы отправляете запрос, Codexe спрашивает, для какой версии Minecraft предназначен плагин, — от 1.8.8 до 26.3. Код пишется под API и уровень Java этой версии, и тестовый сервер работает на ней же. Проекты, созданные до 30 сентября 2026 года, сохраняют версию, указанную в их файлах сборки.

#Что указать в запросе

  • Серверное ПО и версия: «Paper 1.21.4» или «Spigot 1.20.1». API у Paper шире, чем у Spigot. Код, написанный для Spigot, работает на Paper, но не наоборот, поэтому, если вам нужны оба, просите Spigot.
  • Команды с аргументами, кто может их использовать, и автодополнение по Tab.
  • Права со значениями по умолчанию (true, op, false).
  • Ключи config.yml, которые должны быть редактируемыми.
  • Хранение данных: YAML, SQLite, MySQL или в памяти.
  • Интеграции: Vault, PlaceholderAPI, LuckPerms, WorldGuard… — называйте их явно, чтобы они были добавлены как зависимости.
Text
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).
Text
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.

#Что создаёт Codexe

  • Проект Maven (Java) или Gradle (Kotlin) с нужной зависимостью API.
  • Главный класс, наследующий JavaPlugin, а также классы команд, слушателей и хранения данных.
  • plugin.yml с главным классом, api-version, командами и правами, а также config.yml, если есть настройки.
YAML
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

#Версии и Java

Codexe считывает версию Minecraft из файла сборки и собирает на Java 17 (до 1.20.5), Java 21 (1.20.5 и новее) или Java 25 (26.x). Если версия не указана, используется API Paper/Spigot 1.20.6.

#Сборка и проверка

Codexe компилирует плагин, прежде чем назвать его готовым, и проверяет, что JAR содержит классы и plugin.yml (или paper-plugin.yml). Сборка плагина обычно занимает заметно меньше минуты. Подробнее — в разделе Компиляция.

#Установка

Скачайте JAR, положите его в plugins/, перезапустите сервер (не используйте /reload) и проверьте консоль на ошибки при запуске.

#Частые проблемы

СимптомВероятная причина
Плагин не загружается, «main class not found»main: в plugin.yml не совпадает с классом. Попросите чат исправить это или проверьте после ручных переименований.
«Unsupported API version» на старом сервереПлагин рассчитан на более новый API, чем у вашего сервера. Укажите в запросе точную версию сервера.
Команда ничего не делаетКоманды нет в plugin.yml или у игрока нет нужного права.
NoClassDefFoundError для Vault или чего-то похожегоПлагин-зависимость не установлен на сервере.
Собирается, но функция работает неправильноОпишите в чате точное поведение в игре. Проверка касается сборки, а не игрового процесса.
Плагины Spigot и Paper | Codexe Docs