Плагіни 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». Paper має ширший API, ніж 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 чи подібного | Плагін-залежність не встановлено на сервері. |
| Збирається, але функція поводиться неправильно | Опишіть у чаті точну поведінку в грі. Перевірка стосується збірки, а не ігрового процесу. |