Как поднять сервер Minecraft на Fabric: лаунчер сервера с fabricmc.net, версия Java, папка mods и Fabric API, почему клиентские моды вроде Sodium валят сервер и как найти виновника по логу.

Fabric — лёгкий загрузчик модов для Minecraft. Он быстро обновляется под новые версии игры, и на нём живут популярные моды на оптимизацию и контент. Сервер Fabric для игры с друзьями спокойно работает на обычном компьютере.

Установка здесь проще, чем у Forge. Больше всего времени обычно уходит на другое: какие моды класть на сервер, а какие только игрокам.

Что понадобится

Java под твою версию игры. Версии 1.20.5–1.21.x требуют Java 21, новые версии 26.x по данным разработчиков ядер требуют Java 25, старые 1.18–1.20.4 работают на Java 17. Проверь java -version.

Если сервер сразу падает с Unsupported class file major version, дело в Java. Разбор этой и других ошибок старта в статье сервер Minecraft не запускается.

Установка

Самый короткий путь — лаунчер сервера с официального сайта Fabric.

На fabricmc.net открой раздел для сервера, выбери версию игры и загрузчика и скачай .jar лаунчера.
Положи его в пустую папку.
Создай рядом start.bat:

java -Xmx4G -jar fabric-server-launcher.jar nogui
pause

Имя файла подставь то, что скачал: в нём обычно указаны версии игры и загрузчика.

Запусти. Лаунчер сам скачает ванильный сервер и библиотеки, создаст eula.txt и остановится.
В eula.txt замени eula=false на eula=true и запусти ещё раз.

Есть и второй способ, через установщик Fabric с ключом для сервера. Он создаёт fabric-server-launch.jar рядом с server.jar. Работают оба, но запускать нужно именно файл Fabric, а не server.jar, иначе сервер поднимется ванильным и моды молча не загрузятся.

Моды

Моды — это файлы .jar в папке mods. После первого запуска она появляется сама.

Большинству модов нужен Fabric API. Это отдельный мод, его тоже кладут в mods. Если в логе видишь, что моду не хватает fabric-api или fabric, значит его забыли.

Три правила:

мод должен быть под Fabric, а не под Forge или NeoForge;
версия мода должна совпадать с версией игры;
зависимости указаны на странице мода, и их тоже нужно положить.

Удобно брать моды на Modrinth: там на странице видно загрузчик, версии и сторону, на которой мод работает.

Клиентские, серверные и общие моды

Главная ловушка Fabric.

Клиентские моды меняют то, что видит игрок: графику, интерфейс, миникарты. Sodium, Iris, моды на меню и HUD — клиентские. На сервере они не нужны, а часть из них при попытке загрузиться на сервере роняет старт.

Серверные моды работают только на сервере. Например, Lithium оптимизирует логику игры и игрокам его ставить не обязательно.

Общие моды добавляют контент: блоки, предметы, мобов. Их ставят и на сервер, и каждому игроку, причём версии должны совпадать. Если у игрока мода нет или он другой версии, подключиться не получится.

◆

Самый частый сценарий «сервер не стартует» у Fabric: игрок отдал папку mods из своей сборки, и вместе с контентом туда попали Sodium, Iris и шейдерные моды. Перед копированием пройдись по списку и убери всё, что про графику и интерфейс.

Как найти виновника

Лог сервера — logs/latest.log, отчёты о падении — crash-reports.

Fabric обычно пишет прямым текстом, чего не хватает или что несовместимо: «requires fabric-api», «requires version X of minecraft», «Incompatible mods found». Эти строки стоит искать первыми.

Если явной причины нет, работает деление пополам. Убери половину модов из mods, запусти. Сервер стартовал — виновник в убранной половине. Нет — в оставшейся. Повторяй, пока не останется один мод. На сборке из сорока модов это шесть-семь запусков.

Как отдать разбор агенту

Сорок модов, у каждого своя сторона, версия и зависимости, и всё это надо свести с логом. Руками это вечер, агенту это одна задача.

Дока — ИИ-агент, который работает с файлами и терминалом на твоём компьютере. Дай ей папку сервера и попроси:

«Сервер не стартует. Прочитай лог и crash-reports и назови мод, из-за которого падает»;
«Пройди по mods, достань из каждого .jar файл fabric.mod.json и составь таблицу: версия игры, зависимости, клиентский или нет»;
«Убери из mods клиентские моды в отдельную папку и запусти сервер»;
«Сделай копию мира перед тем, как я обновлю моды».

Второй пункт показывает, чем агент удобнее чата. В каждом моде Fabric лежит fabric.mod.json с версией, зависимостями и полем environment, где указано, на какой стороне мод работает. Агент открывает все сорок архивов сам и сводит данные в таблицу.

Модель в Доке может работать локально, без отправки сборки куда-либо.

С чего начать

Запусти чистый Fabric-сервер, положи Fabric API и один контентный мод, поставь его же себе на клиент и зайди. Работает — добавляй дальше небольшими партиями. Если сервер упал и лог непонятен, скачай Доку и отдай ей папку сервера.

Сервер на плагинах вместо модов разобран в статье про Paper, на Forge — здесь.

Сервер Fabric с модами на своём компьютере: запуск, Fabric API и клиентские моды