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). Ако не наведеш верзију, користи се 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 или слично | Плагин зависност није инсталиран на серверу. |
| Гради се, али нека функција се погрешно понаша | Тачно опиши понашање у игри у чату. Провера испитује изградњу, не игру. |