Установка модов Forge на сервер

Установка модов Forge на сервер: выбор версии ядра, папка mods, синхронизация клиента, память под модпак и разбор ошибок запуска.

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

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

Что нужно до установки модов Forge на сервер

Сервер с ядром Forge нужной версии (не Vanilla и не Paper)
Java, соответствующая версии игры: 17 для 1.18–1.20.4, 21 для 1.20.5 и выше
Доступ к файлам сервера — через панель или по SFTP
Запас памяти: модпак примерно вдвое прожорливее ванили — 4 ГБ хватит на небольшую сборку и пару-тройку игроков, крупные сборки начинаются от 12 ГБ

Если ядро ещё не Forge, сначала меняем его. Порядок смены описан в разделе про смену версии и ядра. Выбор между Forge и Fabric, если он ещё не сделан, разбирался в статье Forge или Fabric.

Шаг 1. Установка ядра Forge

В панели управления выбирается ядро Forge и конкретная версия игры. Версия Forge жёстко привязана к версии Minecraft: мод для 1.20.1 не запустится на 1.20.4, даже если разница кажется мелкой.

При ручной установке скачивается инсталлятор с официального сайта Forge и запускается в режиме сервера:

код

java -jar forge-1.20.1-47.3.0-installer.jar --installServer

После этого в папке появляются libraries/, run.sh и файл вида forge-1.20.1-47.3.0-shim.jar. Именно его (или сгенерированный скрипт) сервер использует для старта.

Первый запуск нужно сделать без модов — он создаст структуру папок, включая mods, и попросит принять EULA:

код

eula=true

Шаг 2. Куда класть моды

Моды — это .jar-файлы в папке mods в корне сервера. Подпапок быть не должно, вложенность Forge не читает.

код

/mods
  jei-1.20.1-forge-15.3.0.4.jar
  create-1.20.1-0.5.1.f.jar
  journeymap-1.20.1-5.9.18.jar

Загрузка через панель: раздел Файлы → папка mods → Загрузить. Через SFTP — тот же путь, порядок подключения описан в инструкции по SFTP.

После загрузки — полный рестарт сервера, не /reload. Моды подгружаются только при старте JVM.

Шаг 3. Серверные и клиентские моды

Не все моды нужны на сервере, и не все нужны на клиенте.

Общие (большинство) — Create, Twilight Forest, Applied Energistics: ставятся с обеих сторон, версии обязаны совпадать
Только клиент — оптимизация и интерфейс: Sodium/Embeddium, Rubidium, миникарта в режиме клиента. На сервер их класть не надо, они там либо бесполезны, либо ломают запуск
Только сервер — административные и оптимизационные: Spark, FerriteCore (можно и на клиент), Ledger

Библиотеки-зависимости (Architectury, Cloth Config, Balm, Kotlin for Forge) ставятся туда же, куда и мод, который их требует. Отсутствие библиотеки — самая частая причина краша при старте.

Шаг 4. Синхронизация с клиентами

Игроки должны получить ровно тот же набор модов. Варианты по удобству:

Лаунчер со сборкой. CurseForge, Prism, GDLauncher — модпак публикуется, игроки ставят в один клик. Самый надёжный путь для сборок больше 20 модов.
Архив в Discord. Готовый mods.zip, инструкция «распакуйте в .minecraft/mods». Работает для небольших наборов.
Готовый модпак с CurseForge. Если вы просто ставите All the Mods или Better MC, серверная версия сборки скачивается там же и разворачивается целиком.

Ресурспаки и текстуры удобнее раздавать отдельно — механика описана в статье про раздачу ресурспака.

Шаг 5. Память и параметры запуска

Модпаки требуют примерно вдвое больше памяти на игрока, чем ваниль. Ориентиры на 10–15 игроков:

Размер сборки	Память тарифа
10–20 модов	6 ГБ
50–80 модов	8 ГБ
150+ модов (All the Mods, Create-сборки)	12 ГБ и больше

Выставляется это через -Xmx и -Xms; подробности и типичные ошибки — в разделе про выделение памяти серверу. Для модпаков дополнительно имеет смысл поставить флаги сборщика мусора — набор и объяснение в статье про флаги JVM Aikar's.

Пример строки запуска для сборки среднего размера:

код

java -Xms6G -Xmx6G -XX:+UseG1GC -jar forge-server.jar nogui

Шаг 6. Конфиги модов

После первого запуска с модами появляется папка config — там .toml и .json файлы каждого мода. Именно здесь отключается ненужная генерация, правится баланс и режутся тяжёлые механики.

Полезная привычка: править конфиги после первого успешного запуска, а не до. Многие моды перезаписывают файл при старте, и ваши изменения потеряются.

Некоторые моды разделяют настройки на три уровня:

config/*-common.toml — общие, применяются и на клиенте, и на сервере
config/*-server.toml — только сервер, могут храниться в world/serverconfig/
config/*-client.toml — на сервере не используются

Если правка в config не применяется, проверьте world/serverconfig — для конкретного мира настройки берутся оттуда.

Ошибки, которые встречаются чаще всего

Missing or unsupported mandatory dependencies. В логе перечислены недостающие библиотеки и требуемые версии. Скачиваем их и кладём в mods.

Mod X requires minecraft 1.20.1 and you have 1.20.4. Мод не той версии. Совпадать должны и версия игры, и загрузчик (forge, а не fabric).

The server has mods that require Forge to be installed on the client. Игрок заходит без модов или с другим набором. Сверьте списки.

Exit code 1 сразу после старта. Чаще всего — несовместимая Java. Forge для 1.20.1 не запустится на Java 21 в части сборок, а для 1.21 требует именно 21.

OutOfMemoryError: Java heap space. Мало памяти под сборку. Поднимайте -Xmx или сокращайте набор модов.

Общий разбор проблем со стартом собран в статье сервер Minecraft не запускается. Читать при этом надо не последнюю строку консоли, а первое сообщение с Caused by — там причина.

Обновление модов

Порядок безопасного обновления:

Сделать бэкап мира и папки mods
Обновлять моды пачкой под одну версию игры, не по одному
Запустить сервер и проверить лог на предупреждения о потерянных блоках
Только потом раздавать обновление игрокам

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

Чек-лист

Ядро Forge поставлено, версия совпадает с версией модов
Java нужной версии
Все моды и их библиотеки лежат в mods без подпапок
Клиентские моды на сервер не загружены
-Xmx соответствует размеру сборки
Игроки получили идентичный набор
Бэкап сделан до, а не после

Дальше стоит заняться производительностью — модпаки почти всегда упираются в тики, и базовые шаги описаны в разделе про оптимизацию сервера.

Если сборке не хватает памяти на текущем тарифе, подобрать конфигурацию под модпак можно на странице тарифов.