Ръководство
Как да инсталираш Minecraft плъгин
Обновено на 18 октомври 2026 г.
Инсталирането на плъгин отнема минута: пускаш .jar файл в папката plugins/ на сървъра и рестартираш. Повечето проблеми идват от стъпките около това: сървър, който не може да пуска плъгини, плъгин за друга версия или липсваща зависимост. Това ръководство обхваща всички тях.
Първо го пробвай на тестов сървър, после инсталирай .jar файла.
Генерирай това с CodexeСтъпка по стъпка
1.Провери дали сървърът ти може да пуска плъгини
Плъгините изискват сървърен софтуер на базата на Bukkit: Paper, Spigot, Purpur или Folia за игрови сървъри, BungeeCord или Velocity за проксита. Ванилен сървър или Fabric или Forge сървър не зарежда плъгини.
2.Провери версията на плъгина
Страницата или файлът на плъгина казва кои версии на Minecraft поддържа. Плъгин, компилиран за по-нова версия от сървъра ти, обикновено отказва да се зареди.
3.Спри сървъра и копирай .jar файла
Сложи .jar файла в папката
plugins/до .jar файла на сървъра. В хостинг панел го качи с файловия мениджър или през SFTP. Не го разархивирай.4.Инсталирай зависимостите му
Ако плъгинът има нужда от други плъгини (Vault, PlaceholderAPI, ProtocolLib, LuckPerms), сложи и техните .jar файлове в
plugins/.5.Стартирай сървъра и прочети конзолата
Потърси името на плъгина в лога при стартиране. „Enabling <Plugin>“ без грешка след него означава, че се е заредил.
6.Провери го в играта и го настрой
Изпълни
/plugins: заредените плъгини са зелени, тези, които не са успели да се включат, са червени. Настройките му се появяват вplugins/<PluginName>/config.yml; редактирай ги и рестартирай.
Къде отиват файловете
Типичната папка на сървъра изглежда така след първото стартиране с плъгин:
paper.jar(илиspigot.jar): самият сървър.plugins/MyPlugin.jar: плъгинът, който си добавил.plugins/MyPlugin/: папка, която плъгинът създава, сconfig.yml, съобщения и запазените му данни.logs/latest.log: логът на текущото пускане, където се записват грешките при зареждане.
Рестартирай, не прави /reload
/reload разтоварва и презарежда всички плъгини, без да рестартира сървъра. Много плъгини не го поддържат: слушателите се регистрират два пъти, губят се данни или изтича памет. Винаги рестартирай сървъра, след като добавиш, махнеш или обновиш плъгин. Някои плъгини имат собствена команда за презареждане (например /myplugin reload) само за своята конфигурация: тя е безопасна.
Преди да инсталираш на живия сървър
- Направи резервно копие на папката на сървъра или поне на
plugins/и световете. - Първо го пробвай на копие: същият софтуер, версия и други плъгини като на истинския сървър. Виж как да тестваш плъгин.
- По един плъгин наведнъж: ако нещо се счупи, знаеш кой е виновен.
- Изтегляй от страницата на автора (SpigotMC, Hangar, Modrinth, GitHub), а не от повторни качвания.
Плъгини, направени с Codexe
Плъгин, направен в Codexe, идва като компилиран .jar с името на проекта, проверен, преди да го получиш: трябва да съдържа компилираните класове и plugin.yml. Можеш да го пробваш на частен тестов сървър, преди да го инсталираш където и да е, безплатно с всеки план; тестовият сървър инсталира вместо теб плъгините, посочени като зависимости. За изтегляне на .jar файла за собствения ти сървър трябва план или пакет изтегляния.
Въпроси
Мога ли да инсталирам плъгини на ванилен сървър?
Не. Замени .jar файла на сървъра с Paper (или Spigot) със същата версия на Minecraft; светът ти продължава да работи. За ванилни сървъри алтернативата е датапак.
Мога ли да инсталирам плъгини в singleplayer?
Не, плъгините работят само на сървъри. Можеш да пуснеш локален Paper сървър на собствения си компютър и да влезеш в него на localhost.
Трябва ли играчите да инсталират нещо?
Не. Плъгините работят само на сървъра: играчите влизат с обикновената игра. Само плъгините, които използват ресурсен пакет, молят играчите да го приемат.
Защо плъгинът ми е червен в /plugins?
Намерен е, но не е успял да се включи. Причината е в конзолата точно преди това: виж как да поправиш грешките в плъгините.
Направи плъгин, който можеш да инсталираш още днес
Този промпт се отваря готов за изпращане:
“Плъгин за Paper 1.21.4, наречен JoinMessages: собствени съобщения при влизане и излизане с името на играча и броя онлайн, различно съобщение при първото влизане, заглавие за добре дошли и всички съобщения и звуци в config.yml.”
Генерирай това с Codexe