RU

Игровые серверы

Как создать сервер Minecraft с модами на Fabric или NeoForge

Создайте сервер Minecraft с модами на Fabric или NeoForge на VPS или выделенном Linux-сервере: установка, серверные и клиентские моды, обновления и устранение неполадок.

9 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

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

Оно продолжает руководство Создание сервера Minecraft и использует пользователя minecraft и сервис minecraft.service.

В итоге у вас будут:

  • сервер с модами в /opt/minecraft/modded, запускаемый обычным сервисом
  • скрипт, который загружает моды и проверяет их целостность
  • способ определить, какие моды устанавливать на сервер, а какие — игрокам
  • простой возврат к исходному серверу

Предварительные требования

  • Сервер, установленный по руководству Создание сервера Minecraft
  • Java 25, установленная, как описано в разделе Установка Java 25 руководства по Paper
  • SSH-доступ с пользователем, у которого есть sudo
  • Не менее 4 ГБ памяти для сервера и больше при большом количестве модов

Проверьте Java и установите инструменты, которые используются в этом руководстве:

Терминал
java --version
sudo apt install -y curl jq unzip

Первая команда должна вывести openjdk 25 или более новую версию.

Выбор между Fabric и NeoForge

Fabric NeoForge
Происхождение Лёгкий модульный загрузчик Проект, выросший из Forge
Общая основа Fabric API, необходимый многим модам Встроена в загрузчик
Запуск Один файл .jar Установщик, затем отдельные аргументы Java

Правильный выбор зависит прежде всего от того, какие моды вам нужны: мод выпускается под конкретный загрузчик, и мод для Fabric не работает на NeoForge, как и наоборот. Сначала проверьте их наличие на Modrinth.

Резервное копирование и остановка текущего сервера

Терминал
sudo systemctl stop minecraft.service
sudo mkdir -p /opt/minecraft/backups
sudo tar -czf /opt/minecraft/backups/avant-mods-$(date +%F-%H%M).tar.gz -C /opt/minecraft server
sudo ls -lh /opt/minecraft/backups

Если вы настроили Velocity, остановите также velocity.service, который занимает порт 25565.

Подготовка папки

Создайте папку и перенесите настройки вашего сервера:

Терминал
sudo -u minecraft mkdir -p /opt/minecraft/modded/mods
sudo -u minecraft cp /opt/minecraft/server/server.properties /opt/minecraft/modded/
sudo -u minecraft sed -i \
    -e 's/^server-ip=.*/server-ip=/' \
    -e 's/^server-port=.*/server-port=25565/' \
    -e 's/^online-mode=.*/online-mode=true/' \
    /opt/minecraft/modded/server.properties
echo "eula=true" | sudo -u minecraft tee /opt/minecraft/modded/eula.txt

Сервер с модами создаст новый мир в /opt/minecraft/modded/world.

Затем выполните только один из двух следующих разделов.

Установка Fabric

Откройте сессию minecraft, затем получите последние стабильные версии загрузчика и лаунчера:

Терминал
sudo -u minecraft bash
cd /opt/minecraft/modded
MC=26.3
LOADER=$(curl -fsSL "https://meta.fabricmc.net/v2/versions/loader/$MC" | jq -r 'map(select(.loader.stable)) | .[0].loader.version')
INSTALLER=$(curl -fsSL "https://meta.fabricmc.net/v2/versions/installer" | jq -r 'map(select(.stable)) | .[0].version')
echo "Fabric Loader $LOADER, лаунчер $INSTALLER"
curl -fL -o fabric-server.jar "https://meta.fabricmc.net/v2/versions/loader/$MC/$LOADER/$INSTALLER/server/jar"
ls -l fabric-server.jar
exit

Если версия загрузчика пуста или равна null, Fabric не поддерживает этот номер версии Minecraft: проверьте его.

Затем направьте сервис на Fabric. Этот файл дополняет minecraft.service, не изменяя его:

Терминал
sudo mkdir -p /etc/systemd/system/minecraft.service.d
sudo nano /etc/systemd/system/minecraft.service.d/modded.conf
Конфигурация
[Service]
WorkingDirectory=/opt/minecraft/modded
ExecStart=
ExecStart=/usr/bin/java -Xms2G -Xmx4G -jar /opt/minecraft/modded/fabric-server.jar nogui
SuccessExitStatus=130 143
TimeoutStopSec=180

Пустая строка ExecStart= отменяет исходную команду. Подберите -Xmx под объём памяти, затем переходите к разделу Добавление модов.

Установка NeoForge

Откройте сессию minecraft и найдите последнюю стабильную версию для вашей версии Minecraft. Для Minecraft 26.3 версии NeoForge начинаются с 26.3.0:

Терминал
sudo -u minecraft bash
cd /opt/minecraft/modded
PREFIXE=26.3.0
MAVEN=https://maven.neoforged.net/releases/net/neoforged/neoforge
NEO=$(curl -fsSL "$MAVEN/maven-metadata.xml" | grep -F "<version>$PREFIXE." | grep -v beta | sed 's/ *<[^>]*>//g' | sort -V | tail -n 1)
echo "NeoForge $NEO"
curl -fLO "$MAVEN/$NEO/neoforge-$NEO-installer.jar"
echo "$(curl -fsSL "$MAVEN/$NEO/neoforge-$NEO-installer.jar.sha256")  neoforge-$NEO-installer.jar" | sha256sum -c -
java -jar "neoforge-$NEO-installer.jar" --installServer
printf -- '\n-Xms2G\n-Xmx4G\n' >> user_jvm_args.txt
ls
exit

Установщик загружает сервер Minecraft и его библиотеки. После этого вы должны увидеть run.sh, user_jvm_args.txt и папку libraries.

Направьте сервис на NeoForge. Скрипт run.sh запускает Java с нужными аргументами и остаётся рабочим после обновления:

Терминал
sudo mkdir -p /etc/systemd/system/minecraft.service.d
sudo nano /etc/systemd/system/minecraft.service.d/modded.conf
Конфигурация
[Service]
WorkingDirectory=/opt/minecraft/modded
ExecStart=
ExecStart=/bin/sh /opt/minecraft/modded/run.sh nogui
SuccessExitStatus=130 143
TimeoutStopSec=180

Объём памяти задаётся в user_jvm_args.txt.

Добавление модов

Создайте скрипт, который получает мод с Modrinth, проверяет его контрольную сумму, отсеивает чисто клиентские моды и сообщает о зависимостях:

Терминал
sudo nano /opt/minecraft/mod-get.sh
Терминал
#!/bin/bash
# Загружает с Modrinth последнюю стабильную версию мода для сервера
set -euo pipefail

MOD="${1:?Укажите мод, например lithium}"
CHARGEUR="${2:?Укажите загрузчик: fabric или neoforge}"
MC_VERSION="${3:?Укажите версию Minecraft, например 26.3}"
UA="mon-serveur-minecraft/1.0 (https://your-domain.com)"
API="https://api.modrinth.com/v2"

cd /opt/minecraft/modded/mods

VERSION=$(curl -fsSL -H "User-Agent: $UA" -G "$API/project/$MOD/version" \
    --data-urlencode "loaders=[\"$CHARGEUR\"]" \
    --data-urlencode "game_versions=[\"$MC_VERSION\"]" \
    --data-urlencode "include_changelog=false" \
    | jq -c 'map(select(.version_type == "release")) | .[0]')
if [ "$VERSION" = "null" ]; then
    echo "Нет стабильной версии $MOD для $CHARGEUR $MC_VERSION." >&2
    exit 1
fi

ENVIRONNEMENT=$(echo "$VERSION" | jq -r '.environment // "unknown"')
case "$ENVIRONNEMENT" in
    client_only|singleplayer_only)
        echo "$MOD не устанавливается на сервер ($ENVIRONNEMENT)." >&2
        exit 1
        ;;
esac

FICHIER=$(echo "$VERSION" | jq -c '(.files | map(select(.primary)) | .[0]) // .files[0]')
NOM=$(basename "$(echo "$FICHIER" | jq -r '.filename')")
URL=$(echo "$FICHIER" | jq -r '.url')
SHA512=$(echo "$FICHIER" | jq -r '.hashes.sha512')

curl -fL -H "User-Agent: $UA" -o "$NOM.part" "$URL"
echo "$SHA512  $NOM.part" | sha512sum -c -
mv "$NOM.part" "$NOM"
echo "$NOM установлен (окружение: $ENVIRONNEMENT)."

for ID in $(echo "$VERSION" | jq -r '.dependencies[]? | select(.dependency_type == "required") | .project_id // empty'); do
    echo "Обязательная зависимость: $(curl -fsSL -H "User-Agent: $UA" "$API/project/$ID" | jq -r '.slug')"
done

Замените your-domain.com в строке UA, затем сделайте скрипт исполняемым:

Терминал
sudo chmod 755 /opt/minecraft/mod-get.sh

Скрипту передаётся имя из адреса мода на Modrinth: из modrinth.com/mod/lithium получается lithium. Вот два примера с Lithium — модом для оптимизации, который работает без установки у игроков.

С Fabric также добавьте Fabric API, необходимый большинству модов:

Терминал
sudo -u minecraft /opt/minecraft/mod-get.sh fabric-api fabric 26.3
sudo -u minecraft /opt/minecraft/mod-get.sh lithium fabric 26.3

С NeoForge:

Терминал
sudo -u minecraft /opt/minecraft/mod-get.sh lithium neoforge 26.3

Каждая строка .part: OK подтверждает, что файл загружен без повреждений. Той же командой установите и всё, что указано в строках Обязательная зависимость.

Запуск сервера

Терминал
sudo systemctl daemon-reload
sudo systemctl start minecraft.service
sudo journalctl -u minecraft.service -f

Первый запуск занимает больше времени, так как создаётся мир. Сервер готов, когда появляется строка Done (…)! For help, type "help". Выйдите из просмотра журнала клавишами Ctrl+C.

Проверка результата

Терминал
systemctl show minecraft.service -p WorkingDirectory
sudo ls -l /opt/minecraft/modded/mods
sudo journalctl -u minecraft.service --since "15 minutes ago" --no-pager | grep -iE 'fabric loader|loading [0-9]+ mods|neoforge|done \('

Рабочей папкой должна быть /opt/minecraft/modded. С Fabric в журнале выводятся Loading Minecraft 26.3 with Fabric Loader и количество модов. При использовании NeoForge его название появляется в журнале во время запуска. В обоих случаях должна присутствовать строка Done, а выше неё не должно быть ошибок модов.

Если вы создали команду mc-console по руководству по Paper, она продолжит работать, поскольку сервис остаётся тем же: sudo mc-console list.

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

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

Окружение Сервер Игроки
client_and_server Да Да
server_only, dedicated_server_only Да Нет
server_only_client_optional Да По желанию
client_only Нет Да
client_only_server_optional По желанию Да
client_or_server Достаточно одной из сторон Достаточно одной из сторон
client_or_server_prefers_both Рекомендуется Рекомендуется
singleplayer_only Нет Только одиночная игра
unknown См. страницу мода См. страницу мода

Например, Sodium предназначен только для клиента, а FabricProxy-Lite — для выделенного сервера. Мод, добавляющий блоки или предметы, почти всегда должен быть установлен на обеих сторонах.

Для уже загруженного мода Fabric сторону может указывать и сам файл. Команда выводит client, server или * для обеих сторон и ничего, если поле отсутствует, что равнозначно *:

Терминал
sudo unzip -p /opt/minecraft/modded/mods/ИМЯ_МОДА.jar fabric.mod.json | jq -r '.environment // empty'

Затем каждый игрок должен:

  1. Установить ту же версию Minecraft и тот же загрузчик с помощью установщика Fabric или установщика NeoForge
  2. Один раз запустить созданный профиль в лаунчере
  3. Скопировать необходимые моды тех же версий, что и на сервере, в папку mods игры
Система Папка mods
Windows %APPDATA%\.minecraft\mods
macOS ~/Library/Application Support/minecraft/mods
Linux ~/.minecraft/mods

Для группы игроков модпак устраняет расхождения версий: опубликуйте точный список или пакет в формате Modrinth, который каждый импортирует в свой лаунчер. Если у модпака есть «серверная» версия, используйте её на сервере.

Резервное копирование сервера с модами

Скрипт backup.sh из базового руководства не знает об этой папке. Добавьте эту строку в /opt/minecraft/backup.sh после существующей строки tar. Благодаря префиксу world_ такие архивы будут учитываться при автоматической очистке:

Терминал
tar -czf $BACKUP_DIR/world_modded_$DATE.tar.gz -C /opt/minecraft/modded world mods config server.properties

Обновление

Всегда делайте резервную копию перед обновлением, при остановленном сервере:

Терминал
sudo systemctl stop minecraft.service
sudo tar -czf /opt/minecraft/backups/modded-$(date +%F-%H%M).tar.gz -C /opt/minecraft modded

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

Терминал
sudo ls /opt/minecraft/modded/mods
sudo -u minecraft rm /opt/minecraft/modded/mods/lithium-fabric-СТАРАЯ_ВЕРСИЯ.jar
sudo -u minecraft /opt/minecraft/mod-get.sh lithium fabric 26.3
sudo systemctl start minecraft.service

Чтобы обновить загрузчик, повторите команды из раздела его установки (для NeoForge без строки printf), затем проверьте объём памяти в user_jvm_args.txt. Сообщайте игрокам об изменениях, если мод или загрузчик установлен и у них.

Возврат к исходному серверу

Удалите дополнение к сервису. Ваша папка /opt/minecraft/server не изменялась:

Терминал
sudo systemctl stop minecraft.service
sudo rm /etc/systemd/system/minecraft.service.d/modded.conf
sudo systemctl daemon-reload
sudo systemctl start minecraft.service

Папка /opt/minecraft/modded остаётся на месте: вы сможете вернуться к ней, создав файл modded.conf заново. Если вы используете Velocity, перезапустите также velocity.service.

При возникновении проблем

Терминал
sudo journalctl -u minecraft.service -n 200 --no-pager
sudo less /opt/minecraft/modded/logs/latest.log

Отчёты о сбоях находятся в /opt/minecraft/modded/crash-reports.

«Incompatible mods found!» (Fabric)

В сообщении перечислены затронутые моды со строками вида requires … which is missing! или but only the wrong version is present. Установите недостающую зависимость, часто это fabric-api, или возьмите совместимую версию.

«Cannot load class … in environment type SERVER»

На сервере находится чисто клиентский мод. Удалите мод, указанный в отчёте. В NeoForge та же проблема часто проявляется как NoClassDefFoundError для класса net/minecraft/client/….

«Mod … requires …» (NeoForge)

Зависимость отсутствует или имеет неподходящую версию. В сообщении указаны мод, который нужно установить, и ожидаемая версия.

«Mod … is present in multiple files»

В NeoForge это значит, что в mods находятся две версии одного мода. Оставьте более новую. В Fabric также держите только один файл на мод.

«You are trying to connect to a server that is running NeoForge, but you are not»

Игрок запускает игру без NeoForge. Ему нужно установить указанную версию и выбрать этот профиль в лаунчере.

«Your client is missing the following mods»

В NeoForge на экране подключения перечислены моды, которые игроку нужно добавить. Пометка The following mod versions do not match указывает на различие версий: приведите их в соответствие с серверными.

«Received a registry entry that is unknown to this client»

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

«Incompatible client! Please use …»

Клиент использует не ту версию Minecraft, что сервер. Выберите нужный профиль в лаунчере.

«UnsupportedClassVersionError»

Java слишком старая для этого сервера или мода. Проверьте java --version, затем обратитесь к разделу Установка Java 25.

«FAILED TO BIND TO PORT»

Порт 25565 занят другим сервисом, часто Velocity. Найдите его командой sudo ss -ltnp | grep 25565.

Скрипт mod-get.sh завершается с ошибкой

  • Нет стабильной версии: мода нет для этого загрузчика и этой версии
  • curl сообщает об ошибке 404: неверное имя мода
  • не устанавливается на сервер: этот мод устанавливается только у игроков
  • sha512sum: WARNING: загруженный файл повреждён. Запустите скрипт снова

Подробнее читайте в документации Fabric, руководстве по серверу NeoForge и объяснении окружений на Modrinth.