Към съдържанието
Платформи

Плъгини за Spigot и Paper

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