Плъгини за Spigot и Paper
Как да получиш най-добрия плъгин за Bukkit, Spigot или Paper от Codexe, на 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). Ако не кажеш версия, се използва Paper/Spigot API 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 или подобен | Плъгинът, от който зависи, не е инсталиран на сървъра. |
| Компилира се, но някоя функция не работи както трябва | Опиши в чата точното поведение в играта. Проверката проверява компилацията, не геймплея. |