Minecraft · файлы

Плагины и моды: куда класть файлы

Как поставить плагин или мод на сервер Minecraft: куда положить файл через панель, чем папка plugins отличается от mods и что делать, если ничего не произошло.

Здесь показано, куда класть скачанные файлы, чтобы сервер их подхватил, и что делать, если он их не заметил. ⏱️ Загрузка одного плагина — минуты две вместе с перезапуском.

Плагин и мод — разные вещи

Плагин живёт только на сервере. Он добавляет права, защищённые участки земли, деньги, свои команды — а игрок заходит обычным клиентом и себе не ставит ничего. Мод меняет саму игру: новые блоки, предметы, механики. Поэтому такой же набор модов обязан стоять и у игрока.

ЯдроПапкаЧто кладутЧто нужно игроку
Paper, Leaf, PurpurpluginsПлагины Bukkit, Spigot, Paperничего, обычный клиент
ForgemodsМоды Forgeтот же набор модов
VelocitypluginsПлагины Velocity — у него своиничего
Таблица-схема: плагин читается из папки plugins на Paper, Leaf и Purpur, мод — из папки mods на Forge, в чужой папке ни то, ни другое не загружается
Промах не выглядит промахом: файл в чужой папке просто лежит на диске, сервер стартует как обычно, и в консоли об этом нет ни строчки.

Как загрузить файл

  1. Файлы

    Найдите нужную папку

    Верхняя папка в строке пути называется «Сервер» — с неё всё и начинается. Папки plugins и mods появляются при установке сами. Если нужной нет, её создаёт кнопка «Новая папка».

  2. Файлы

    Загрузите файл .jar

    Нажмите «Загрузить файлы» или просто перетащите файл прямо в список. Файл едет с вашего компьютера на ноду напрямую, мимо панели, — поэтому от загруженности панели скорость загрузки не зависит.

  3. Файлы

    Архив со сборкой распакуйте на месте

    Нажмите на строку архива и выберите «Распаковать здесь». Так гораздо быстрее, чем распаковывать у себя и загружать сотню файлов по одному.

  4. Шапка сервера

    Перезапустите сервер

    Плагины и моды читаются только при запуске. Нажмите «Перезапустить». Пока этого не сделали, новый файл просто лежит на диске и ничего не делает.

Схема загрузки: файл едет с вашего компьютера прямо на ноду, панель при этом только показывает список папок и не пропускает файл через себя
Панель показывает папки и говорит ноде, куда положить, а сам файл через неё не идёт. Отсюда и правило: закрыли вкладку на середине — загрузка оборвалась.

Положил, а ничего не произошло

Пять причин, от самой частой к более редким:

  • Файл лёг не в ту папку. Мод в папке plugins и плагин в папке mods ядро просто не читает — и ошибки при этом тоже не покажет.
  • Плагин собран под другую версию игры. Сервер от этого обычно не падает: плагин не включается, а в «Консоли» появляется строка про это.
  • Мод собран под другую версию игры. Вот это уже падение: сервер перестаёт запускаться целиком.
  • Сервер не перезапускали. Самая обидная причина, и проверяется первой.
  • Мод положили на Paper, а плагин — на Forge. Загляните в статью про ядра: наборы у них разные, и одно другим не заменяется.

Правка настроечных файлов

У плагинов и модов свои настройки, и лежат они в обычных текстовых файлах рядом с самим плагином. Такой файл правится прямо в панели: «Открыть в редакторе», потом «Сохранить». Панель тут же честно предупреждает: «Правки применяются на ноде сразу после сохранения. Работающий сервер перечитает конфиг только после перезапуска».

Часть файлов панель разбирать не умеет — bukkit.yml, spigot.yml, paper-global.yml, ops.json, whitelist.json, velocity.toml. Их она открывает просто текстом, во вкладке «Настройки игры», в списке «Файлы на ноде», и там же прямо об этом пишет: «Панель не разбирает этот файл — правьте текст как есть».

Читайте дальше

Minecraft

Свой сервер Minecraft: шесть шагов до первого входа

Как создать сервер Minecraft за шесть шагов и минут за десять: версия, плагины и адрес, который отправляют друзьям. Скачивать на свой компьютер ничего не нужно.

Minecraft · ядра

Paper, Leaf, Purpur, Forge и Velocity: что выбрать

Какое ядро Minecraft выбрать под свои задачи: три из пяти держат плагины, одно — моды, а пятое вообще не игровой сервер, а прокси для сети серверов.

Minecraft · тариф

Сколько игроков потянет тариф

Сколько игроков выдержит сервер Minecraft на вашем тарифе: таблица «память — игроки — дальность прорисовки» и объяснение, откуда взялись именно эти числа.

Minecraft · мир

Ад и Край: как выключить и как вернуть обратно

Как отключить Ад на сервере Minecraft и вернуть его обратно: до 1.21.8 это строка в файле, дальше — команда в консоли, а Край выключается вообще в третьем месте.

Minecraft · права

Права игрокам: оператор и LuckPerms

Как выдать права игроку на сервере Minecraft: оператор — это одна команда в консоли и доступ ко всему сразу. Когда столько отдавать не хочется, ставят LuckPerms.

Minecraft · приваты

Приваты: как закрыть постройки от чужих рук

Как сделать приваты на сервере Minecraft: в самой игре защиты нет, кроме квадрата вокруг спавна. Дальше нужен плагин — вот три, которые ставят чаще всего.

Minecraft · настройки

Сложность, PvP, спавн, время и погода: где что менять

Где на сервере Minecraft менять сложность, PvP, точку появления, время и погоду: у каждой настройки своё место — вкладка панели, строка в файле или команда в консоли.

Minecraft · вывеска

Иконка сервера: свой значок в списке

Как поставить свою иконку сервера Minecraft: картинка 64 на 64 пикселя, имя файла server-icon.png и папка, в которую его кладут. Занимает пару минут.

Minecraft · вывеска

Описание сервера (MOTD): строка под адресом

Как изменить описание сервера Minecraft — ту самую строку под названием в списке. Меняется одним полем в панели, файл править бесполезно.

Minecraft · мир

Защита спавна: почему у точки входа не строится

Почему на сервере Minecraft нельзя ломать блоки рядом с точкой появления и как изменить радиус защиты спавна или выключить её совсем.

Minecraft · версии

Какая Java на сервере и почему её не выбирают

Какая версия Java работает на сервере Minecraft, почему поля выбора Java в панели нет и что делать, если нужной версии игры нет в списке.

Minecraft · мир

Свой мир на сервере: загрузить и забрать обратно

Как перенести мир из одиночной игры на сервер Minecraft и как забрать серверный мир себе. Загрузка идёт через панель, выгрузка — через SFTP.

Minecraft · ресурс-пак

Ресурс-пак: как раздать текстуры игрокам

Как сделать, чтобы при входе на сервер Minecraft игрокам сам предлагался ваш ресурс-пак: три строки в настройках и прямая ссылка на архив.

Minecraft · доступ

Белый список: пустить на сервер только своих

Как включить белый список на сервере Minecraft и добавить в него ников: переключатель в панели, команды консоли и порядок, в котором это делают.

Minecraft · доступ

Пиратский сервер: что меняет проверка лицензии

Как открыть сервер Minecraft для пиратских клиентов, чем за это платят и что придётся поставить, чтобы ники нельзя было присвоить.

Minecraft · разбор

Ошибка «Failed to verify username»

Что означает «Не удалось проверить имя пользователя» при входе на сервер Minecraft, три её причины и что делать в каждом случае.

Minecraft · моды

Клиентские моды на сервере: почему он падает

Почему сервер Minecraft падает после установки модов, как отличить клиентский мод от серверного и как найти лишний файл в папке mods.

Minecraft · безопасность

Как не потерять сервер: права, плагины, бэкапы

Что защищает сервер Minecraft от погрома и от чужих рук: кому давать оператора, откуда брать плагины и почему бэкап важнее всех остальных мер.