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

Установка Fabric на сервер занимает пять минут, и в этом его главное преимущество перед Forge: загрузчик лёгкий, стартует быстро, обновляется под новые версии игры почти сразу после релиза. Расплата — меньше крупных контентных модов и обязательная библиотека Fabric API, без которой не запустится примерно 90% сборок.

Ниже — полный порядок: от установки загрузчика до рабочего набора модов и синхронизации с игроками.

Fabric против Forge: коротко о выборе

Fabric берут, когда нужны производительность и свежая версия игры. Lithium, Ferrite Core, Krypton и C2ME дают заметный прирост TPS на тех же ресурсах — на серверах с 30+ онлайна разница ощущается сразу.

Forge берут, когда нужен конкретный крупный мод: Create, Applied Energistics, Immersive Engineering и большая часть привычных сборок исторически живут там. Развёрнутое сравнение — в статье Forge или Fabric, а сама установка Forge описана в соседнем разделе.

Мешать одно с другим нельзя: мод собирается либо под Fabric, либо под Forge, и файл под чужой загрузчик просто не загрузится.

Шаг 1. Установка Fabric на сервер: загрузчик

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

Вручную проще всего скачать готовый серверный лаунчер на официальной странице Fabric: выбираете версию игры и загрузчика и получаете один jar для запуска. Классический вариант — серверный инсталлятор:

java -jar fabric-installer-1.0.1.jar server -mcversion 1.21.1 -downloadMinecraft

Команда создаёт fabric-server-launch.jar и папку libraries. Запуск идёт через этот jar:

java -Xms4G -Xmx4G -jar fabric-server-launch.jar nogui

Первый старт создаёт eula.txt (ставим eula=true), server.properties и пустую папку mods. Базовые параметры мира правятся там же, где обычно — разбор ключей есть в разделе про настройку server.properties.

Требования к Java те же, что у ванили: 17 для 1.18–1.20.4, 21 для 1.20.5 и новее.

Шаг 2. Fabric API — первое, что нужно поставить

Fabric сам по себе почти ничего не умеет: это тонкий загрузчик. Общие хуки и события дают отдельные библиотеки.

• Fabric API — обязателен почти для всего. Скачивается с Modrinth или CurseForge строго под вашу версию игры.
• Fabric Language Kotlin — нужен модам, написанным на Kotlin (часто у административных).
• Cloth Config / YACL — библиотеки настроек, тянутся как зависимости.

Файл кладётся в mods как обычный мод:

/mods
  fabric-api-0.102.0+1.21.1.jar

Версия в имени файла содержит и версию API, и версию игры — сверяйте вторую часть.

Шаг 3. Загрузка модов

Порядок такой же, как у любых .jar: папка mods в корне сервера, без подпапок, полный рестарт после загрузки.

Загрузить можно через файловый менеджер панели (Файлы → mods → Загрузить) или по SFTP — подключение описано в инструкции по SFTP.

Важное отличие от плагинов: /reload для модов не работает никогда. Только остановка и запуск.

Шаг 4. Что ставить на сервер, а что на клиент

Разделение у Fabric строже, чем у Forge, и это регулярно ломает запуск.

Только на клиент (на сервере вызовут краш или бесполезны):

• Sodium, Iris, Indium — рендеринг
• Mod Menu — меню настроек
• Zoomify, миникарты в клиентском режиме

Только на сервер (оптимизация тиков и памяти):

• Lithium — переписанные игровые механики, самый заметный прирост TPS
• Krypton — оптимизация сетевого стека
• FerriteCore — снижает потребление памяти на 30–40% на больших мирах
• C2ME — параллельная генерация чанков, помогает при активном исследовании карты
• Spark — профилировщик, без него диагностика лагов превращается в гадание

С обеих сторон — контентные моды: они меняют мир и должны быть идентичны у сервера и клиента.

Набор Lithium + FerriteCore + Krypton ставится почти всегда, даже на чисто выживательный сервер без контентных модов: это один из самых дешёвых способов поднять производительность. Остальные шаги по тюнингу — в разделе про оптимизацию сервера.

Шаг 5. Синхронизация с игроками

Контентные моды требуют одинакового набора у всех. Способы раздачи:

1. Сборка в лаунчере. Prism Launcher и Modrinth App импортируют .mrpack — самый удобный формат для Fabric. Один файл, игрок ставит в два клика.
2. Архив с модами. mods.zip в Discord плюс инструкция распаковать в .minecraft/mods. Подходит для 5–15 модов.
3. Modrinth-модпак. Публикуете сборку, игроки скачивают по ссылке.

Оптимизационные моды (Sodium, Iris) в сборку добавлять полезно, но помните: у сервера их быть не должно.

Шаг 6. Память и флаги запуска

Fabric-сборки обычно легче Forge при том же количестве модов. Ориентиры на 10–20 игроков:

Как правильно задать -Xms и -Xmx, разобрано в разделе про выделение памяти, а флаги сборщика мусора для стабильных тиков — в статье про Aikar's flags. С FerriteCore верхнюю планку памяти часто удаётся снизить на пару гигабайт без потери TPS.

Конфиги

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

У Lithium настройки лежат в config/lithium.properties и по умолчанию все включены; трогать их стоит, только если конкретная механика конфликтует с другим модом:

mixin.world.tick_scheduler=false

Частые ошибки

Could not execute entrypoint / Fabric API is missing. Не установлен Fabric API либо стоит версия под другую версию игры.

Incompatible mods found! В логе перечислены мод и требуемая версия загрузчика. Обновите Fabric Loader или откатите мод.

Sodium требует клиентской среды. Клиентский мод попал в серверную папку mods — удалите.

Сервер стартует, игроки вылетают с Connection Lost. Наборы модов различаются. Сверьте список файлов у себя и у игрока.

Мир не грузится после удаления мода. Пропали блоки и биомы. Восстанавливайте мод либо откатывайтесь на бэкап — поэтому бэкап делается до любых изменений в mods.

Общий разбор проблем со стартом — в статье сервер Minecraft не запускается.

Чек-лист

• Ядро Fabric установлено, версия игры совпадает с версией модов
• Fabric API лежит в mods
• Клиентских модов на сервере нет
• Lithium, FerriteCore, Krypton добавлены для производительности
• Память выставлена под размер сборки
• Бэкап сделан до загрузки модов
• Игроки получили идентичный набор

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