Плагины Spigot и Paper
Как получить от Codexe лучший плагин Bukkit, Spigot или Paper на Java или Kotlin. Что указать в запросе, версии, plugin.yml, зависимости, сборка и частые проблемы.
Обновлено
На этой странице
Типы 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… — называйте их явно, чтобы они были добавлены как зависимости.
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).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, если есть настройки.
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 или чего-то похожего | Плагин-зависимость не установлен на сервере. |
| Собирается, но функция работает неправильно | Опишите в чате точное поведение в игре. Проверка касается сборки, а не игрового процесса. |