Как создать сервер Minecraft с модами на Fabric или NeoForge
Создайте сервер Minecraft с модами на Fabric или NeoForge на VPS или выделенном Linux-сервере: установка, серверные и клиентские моды, обновления и устранение неполадок.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Моды добавляют контент или меняют работу игры. Для них нужен загрузчик: в этом руководстве 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'Затем каждый игрок должен:
- Установить ту же версию Minecraft и тот же загрузчик с помощью установщика Fabric или установщика NeoForge
- Один раз запустить созданный профиль в лаунчере
- Скопировать необходимые моды тех же версий, что и на сервере, в папку
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.