Как установить Fabric на сервер

Fabric — это легковесная платформа для модов, которая позволяет гибко расширять функционал Minecraft без оверхеда Forge. Эта инструкция подходит для выделенного сервера на proxify.cloud, работающего под управлением Ubuntu. Все действия выполняются через SSH-доступ, который можно получить прямо из панели Proxmox → вкладка Shell. Предполагается, что у вас уже есть работающий сервер Ubuntu и базовая установка Java (17 или 21).

1. Подготовка сервера

1.1. Подключение к серверу

Откройте панель proxify.cloud, выберите свой выделенный сервер и перейдите в раздел Shell (доступ через веб-терминал) или используйте любой SSH-клиент:

ssh root@<IP_вашего_сервера>

1.2. Установка Java

Fabric требует Java 17 или Java 21. Проверьте версию:

java -version

Если Java не установлена или версия ниже 17, выполните:

apt update && apt upgrade -y
apt install openjdk-17-jdk-headless -y
# или
apt install openjdk-21-jdk-headless -y

Убедитесь, что java доступна из командной строки.

1.3. Создание директории для сервера

Рекомендуется хранить всё в одной папке, например /opt/minecraft:

mkdir -p /opt/minecraft && cd /opt/minecraft

2. Загрузка установщика Fabric

Перейдите на официальный сайт Fabric (или используйте прямые ссылки). Скопируйте ссылку на установщик последней версии (на момент написания – 0.16.10). Скачайте его через wget в папку сервера:

wget https://meta.fabricmc.net/v0.3/loader/1.21/0.16.10/1.0.1/server/jar -O fabric-installer.jar

Пояснение параметров пути:
/loader/{версия_Minecraft}/{версия_загрузчика}/{версия_установщика}/server/jar

Вместо 1.21 можно указать любую поддерживаемую версию (1.19, 1.20 и т.д.). Актуальные версии смотрите на сайте.

После скачивания проверьте, что файл появился:

ls -la
# должен отображаться fabric-installer.jar

3. Установка Fabric-сервера через установщик

Выполните команду:

java -jar fabric-installer.jar server -mcversion 1.21 -downloadMinecraft
  • server — указывает, что устанавливается серверная часть.
  • -mcversion 1.21 — версия Minecraft (поменяйте на свою).
  • -downloadMinecraft — автоматически скачивает оригинальный сервер Minecraft (обязательно).

Установщик создаст fabric-server-launch.jar и скачает все необходимые библиотеки. Если вы хотите пропустить загрузку ванильного сервера (например, если он уже есть), уберите флаг -downloadMinecraft.

После завершения в папке должны появиться файлы fabric-server-launch.jar и server.jar (ванильный сервер). Не удаляйте server.jar — он используется Fabric.

4. Создание и настройка скрипта запуска

Для удобства создайте скрипт start.sh, который будет запускать сервер с нужными параметрами.

4.1. Создаём файл

nano start.sh

4.2. Содержимое скрипта

#!/bin/bash
java -Xms2G -Xmx4G -jar fabric-server-launch.jar nogui
  • -Xms2G — начальный размер оперативной памяти (можно 1G для маленьких проектов).
  • -Xmx4G — максимальный размер ОЗУ (подбирайте под доступные ресурсы сервера proxify.cloud).
  • nogui — отключает графическое окно (сервер работает в консоли).

Сохраните файл (Ctrl+O, Enter, Ctrl+X).

4.3. Делаем скрипт исполняемым

chmod +x start.sh

4.4. Автозапуск (рекомендуется)

Чтобы сервер автоматически перезапускался после остановки, можно использовать команду while или systemd. Простой вариант — изменить start.sh, добавив цикл:

#!/bin/bash
while true; do
    java -Xms2G -Xmx4G -jar fabric-server-launch.jar nogui
    echo "Сервер остановлен. Перезапуск через 5 секунд..."
    sleep 5
done

5. Запуск сервера и первичная настройка

5.1. Первый запуск

Выполните:

./start.sh

При первом запуске сервер завершится с ошибкой из-за отсутствия лицензионного соглашения (EULA). В папке появится файл eula.txt.

5.2. Принятие EULA

nano eula.txt

Замените eula=false на eula=true и сохраните.

5.3. Настройка server.properties

После повторного запуска будет создан server.properties. Остановите сервер (комбинация Ctrl+C) и отредактируйте параметры под свой проект:

nano server.properties

Основные параметры:

  • server-port=25565 (стандартный порт, при необходимости сменить).
  • online-mode=true (если хотите, чтобы заходили только лицензионные игроки).
  • max-players=20.
  • motd=Ваш сервер на Fabric.

После правок сохраните файл.

5.4. Запуск в фоне

Для фонового запуска можно использовать screen:

apt install screen -y
screen -dmS mc ./start.sh

Подключиться к сессии: screen -r mc. Отключиться без остановки: Ctrl+A, затем D.

6. Установка Fabric API и модов

Сервер с голым Fabric не расширяет ванильный функционал. Для работы большинства модов требуется Fabric API.

6.1. Создание папки mods

mkdir -p mods

6.2. Скачивание Fabric API

Перейдите на CurseForge или Modrinth и скопируйте ссылку на скачивание прямой файла .jar для вашей версии Minecraft. Скачайте его через wget:

wget https://cdn.modrinth.com/data/P7dR8mSH/versions/0.104.0%2B1.21/fabric-api-0.104.0+1.21.jar -O mods/fabric-api.jar

Или загружайте через любой другой способ (SCP, FTP — панель proxify.cloud предоставляет файловый менеджер в разделе Files).

6.3. Установка прочих модов

Любые .jar-файлы модов помещайте в ту же папку mods:

wget <ссылка на мод> -O mods/имя_мода.jar

Важно: моды должны быть серверными (или универсальными) и предназначены для той же версии Minecraft и загрузчика Fabric. Клиентские моды (например, мини-карты, OptiFine) ставить бессмысленно.

6.4. Перезапуск сервера

После добавления модов перезапустите сервер, чтобы они загрузились. Если сервер запущен в screen, выполните:

screen -r mc
# внутри screen нажмите Ctrl+C, затем:
./start.sh
# отключитесь Ctrl+A, D

Или проще: pkill -f fabric-server-launch и затем screen -dmS mc ./start.sh.

7. Проверка работоспособности

Подключитесь к серверу через любой Minecraft-клиент с установленным Fabric (требуется та же версия). Введите IP вашего сервера и порт (по умолчанию 25565).

Если вы всё сделали правильно, в консоли сервера будет видно:

[main/INFO] (FabricLoader) Loading 3 mods: fabric-api, fabric-api-base, ...
[User Authenticator] UUID of player YourName is ...

Откройте порт в брандмауэре (если нужен доступ извне). В панели proxify.cloud перейдите в раздел Firewall и разрешите входящий порт (например, 25565). Если используется ufw на самом сервере:

ufw allow 25565/tcp
ufw reload

Возможные проблемы и решения

Java не найдена или неподходящая версия

  • Ошибка: java: command not found или Unsupported class file major version
  • Установите корректную Java 17+: apt install openjdk-17-jdk-headless

Не удаётся скачать установщик

  • Ссылка могла устареть — перейдите на fabricmc.net/use/server и скопируйте актуальную.
  • Проверьте интернет-соединение сервера: ping google.com

Ошибка "Failed to load mods" при запуске

  • Несовместимость версий модов и Minecraft.
  • Отсутствует Fabric API для вашей версии.
  • В папке mods лежат клиентские моды (например, REI без серверной версии). Удалите их.

Недостаточно памяти

  • Ошибка: java.lang.OutOfMemoryError
  • Увеличьте -Xmx в start.sh до 6G или 8G, если сервер