Пређи на садржај
Платформе

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“. 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