Как установить плагины Minecraft через панель сервера
Плагин: серверное расширение. Для Bukkit/Spigot/Paper-плагинов нужен поддерживающий их сервер: обычный vanilla JAR и стандартный Fabric не загружают такие плагины сами по себе.
Проверьте API, версию и зависимости
На странице плагина найдите поддерживаемые версии Minecraft, платформы и зависимости. Требуемая библиотека или другой плагин не всегда включены в основной JAR. Скачивайте расширение у автора, в официальном репозитории, Hangar или другом доверенном каталоге.
| Расширение | Куда обычно устанавливать | Условие |
|---|---|---|
| Paper / Bukkit / Spigot плагин | plugins/ | Paper, Purpur или совместимое ядро |
| Fabric / NeoForge мод | mods/ | Совпадающие загрузчик и Minecraft-версия |
| Плагин Velocity | plugins/ отдельного proxy-сервера | Запуск именно на Velocity |
| Datapack | world/datapacks/ выбранного мира | Совместимый формат datapack |
Таблицу можно прокрутить по горизонтали →
Загрузите JAR в /plugins
Остановите сервер. В Ghosting откройте Файлы → plugins → Загрузить файлы и выберите JAR. Не помещайте серверный plugin.jar в корень и не распаковывайте обычный JAR плагина: это уже готовый исполняемый архив.
- Сделайте копию сервера или хотя бы данных обновляемого плагина.
- Скачайте совместимую версию плагина и нужные зависимости.
- Удалите или перенесите старый JAR того же плагина, чтобы не запускались две версии одновременно.
- Загрузите новые файлы и дождитесь завершения передачи.
- Запустите сервер и проверьте консоль, затем папку с конфигурацией плагина.
Настройте плагин и права
При первом запуске плагин часто создаёт папку с config.yml. Остановите сервер перед изменением файлов, которые плагин может перезаписать при выключении. После сохранения используйте штатный полный перезапуск; /reload не является универсальным безопасным обновлением плагинов.
- Не выдавайте всем игрокам * или OP ради одной команды. Найдите нужный permission node в документации.
- Проверьте поведение обычным игроком: OP часто обходит ограничения.
- Не публикуйте пароли баз данных, токены Discord и webhook URL из конфигураций.
enabled: true
messages:
welcome: "Добро пожаловать!"
# Отступы: пробелами. Названия ключей берите из документации плагина.Почему плагин не загрузился
Откройте logs/latest.log и найдите название плагина и первую ошибку при его включении. Цвет записи в списке плагинов полезен, но причина находится в журнале.
| Сообщение | Что оно обычно означает |
|---|---|
| UnknownDependencyException / missing dependency | Не установлен обязательный плагин или несовместима его версия |
| UnsupportedClassVersionError | Плагин собран для более новой Java |
| InvalidPluginException | Повреждённый JAR, не тот тип расширения или несовместимый API |
| NoSuchMethodError / NoClassDefFoundError | Часто несовместимость API или библиотек; сверяйте весь stack trace |
| ScannerException / YAML parse error | Ошибка отступов, кавычек или структуры YAML |
Таблицу можно прокрутить по горизонтали →
Как обновлять без потери данных
Обновляйте сначала на копии сервера. Проверьте описание миграций плагина: новая версия может преобразовать файлы или базу данных. Сохраняйте JAR и данные одной версии вместе. Если плагин использует MySQL, копия папки plugins не заменяет резервную копию базы. Для обращения в поддержку укажите версию ядра, Java, плагина, воспроизведение ошибки и фрагмент лога без секретов.
Документация и источники
Названия файлов и параметры могут отличаться между версиями. Перед изменением сверяйте документацию своей сборки.