КАК ЗАПУСТИТЬ СВОЙ СЕРВЕР HYTALE НА UBUNTU

Hytale наконец вышла в Early Access 13 января 2026 года — и первое что хочется сделать настоящему геймеру это поднять свой сервер. Никаких посредников, никакой ежемесячной платы хостингу, полный контроль над миром Orbis. Этот гайд написан специально для Ubuntu и покроет всё: от железа до первого /auth.

---

1. СИСТЕМНЫЕ ТРЕБОВАНИЯ

Прежде чем что-то устанавливать — убедитесь что ваш сервер или VPS тянет Hytale. Требования официально подтверждены Hypixel Studios:

Параметр	Минимум	Рекомендуется
RAM	4 GB	8–16 GB
CPU	2 ядра (64-bit)	4+ ядра, высокая частота
Диск	5 GB	20+ GB (SSD)
Java	Java 25 (обязательно!)	Temurin 25 LTS
Архитектура	x64	x64 или arm64
Порт	UDP 5520	UDP 5520 (QUIC)
ОС	Ubuntu 20.04+	Ubuntu 22.04 LTS

ВАЖНО: Hytale использует протокол QUIC поверх UDP, а не TCP как Minecraft. Если вы случайно откроете только TCP-порт — игроки не подключатся. Только UDP!

Потребление ресурсов сильно зависит от поведения игроков. Высокий view distance и активное исследование мира быстро съедают RAM. На 5–10 игроков хватит 6–8 GB. На 20+ — закладывайте 12–16 GB.

---

2. УСТАНОВКА JAVA 25

Hytale не запустится на Java ниже 25-й версии. Стандартный OpenJDK из репозиториев Ubuntu скорее всего устарел — ставим Temurin от Adoptium.

Шаг 1. Обновляем систему:

sudo apt update && sudo apt upgrade -y

Шаг 2. Устанавливаем зависимости:

sudo apt install -y wget apt-transport-https gnupg unzip screen

Шаг 3. Добавляем репозиторий Adoptium:

wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo tee /usr/share/keyrings/adoptium.asc

echo "deb [signed-by=/usr/share/keyrings/adoptium.asc] https://packages.adoptium.net/artifactory/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/adoptium.list

sudo apt update

Шаг 4. Устанавливаем Java 25:

sudo apt install -y temurin-25-jdk

Шаг 5. Проверяем версию:

java --version

Должны увидеть примерно такой вывод:

openjdk 25.0.1 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS)
OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing)

Если версия отображается корректно — двигаемся дальше.

---

3. СОЗДАНИЕ ПОЛЬЗОВАТЕЛЯ И ПАПОК

Правило безопасности №1: никогда не запускайте игровой сервер от имени root. Создаём отдельного системного пользователя.

Создаём пользователя hytale:

sudo adduser --system --group --home /opt/hytale --shell /bin/bash hytale

Создаём структуру папок:

sudo mkdir -p /opt/hytale/server
sudo mkdir -p /opt/hytale/backups
sudo chown -R hytale:hytale /opt/hytale

Структура выглядит так:

/opt/hytale/
├── server/          ← файлы сервера (HytaleServer.jar, Assets.zip)
│   ├── config.json  ← конфиг (создаётся автоматически при первом запуске)
│   ├── worlds/      ← данные миров
│   └── logs/        ← логи
└── backups/         ← ваши бэкапы

---

4. СКАЧИВАНИЕ ФАЙЛОВ СЕРВЕРА

Hypixel Studios предоставляют официальный hytale-downloader — CLI-утилиту для скачивания и обновления сервера. Использовать именно её, а не пиратские копии!

Переключаемся на пользователя hytale:

sudo su - hytale

Переходим в папку сервера:

cd /opt/hytale/server

Скачиваем downloader:

wget -q https://downloader.hytale.com/hytale-downloader.zip
unzip hytale-downloader.zip

Даём права на выполнение:

chmod +x bin/hytale-downloader

Запускаем скачивание серверных файлов:

./bin/hytale-downloader --server

Утилита попросит авторизоваться через браузер (OAuth2). Переходим по ссылке, вводим код — downloader автоматически скачает последний релиз. Вы получите архив вида 2026.01.13-50e69c385.zip.

Распаковываем архив:

unzip 2026.01.13-50e69c385.zip

После распаковки в папке появятся:

-rw-r--r--  HytaleServer.jar   ← основной файл сервера
-rw-r--r--  Assets.zip         ← ассеты (~3.2 GB, обязательно!)
drwxr-xr-x  Server/            ← вспомогательные файлы
drwxr-xr-x  bin/               ← downloader

Совет: Хотите скачать pre-release версию для тестов? Добавьте флаг:

./bin/hytale-downloader -patchline pre-release

Выходим обратно в sudo-сессию:

exit

---

5. НАСТРОЙКА ФАЙРВОЛА (UFW)

Hytale использует UDP порт 5520 по умолчанию (протокол QUIC). Открываем его:

sudo ufw allow 5520/udp
sudo ufw reload
sudo ufw status

Вывод должен показывать:

5520/udp                   ALLOW       Anywhere
5520/udp (v6)              ALLOW       Anywhere (v6)

Если вы хотите использовать нестандартный порт — откройте тот что нужен:

sudo ufw allow ВАSH_ПОРТ/udp

Не забудьте про роутер! Если сервер стоит у вас дома, нужно также пробросить UDP-порт 5520 в настройках роутера (Port Forwarding) на IP вашего ПК.

---

6. ПЕРВЫЙ ЗАПУСК И АУТЕНТИФИКАЦИЯ

Переключаемся на пользователя hytale:

sudo su - hytale
cd /opt/hytale/server

Запускаем сервер (базовая команда):

java -Xms4G -Xmx6G -jar HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:5520

Параметры:

• -Xms4G — минимальная выделяемая RAM для JVM
• -Xmx6G — максимальная RAM (не ставьте больше 80% от доступной)
• --assets Assets.zip — путь к файлу ассетов (обязателен!)
• --bind 0.0.0.0:5520 — слушаем на всех интерфейсах, порт 5520

После запуска сервер выдаст предупреждение:

[WARNING] NO SERVER TOKENS CONFIGURED

Это нормально — нужно пройти аутентификацию. В консоли сервера вводим:

/auth login device

Сервер ответит примерно так:

=================================================================
DEVICE AUTHORIZATION
=================================================================
Visit: https://accounts.hytale.com/device
Enter code: ABCD-1234
=================================================================
Waiting for authorization (expires in 900 seconds)...

Переходим по ссылке в браузере, вводим код — и ждём сообщения:

Authentication successful!

Теперь сервер принимает подключения. Игроки могут подключиться по вашему IP и порту.

---

7. КОНФИГУРАЦИЯ CONFIG.JSON

После первого запуска в папке сервера создаётся файл config.json. Редактировать его нужно только когда сервер остановлен — иначе изменения перезапишутся!

sudo systemctl stop hytale  # или просто Ctrl+C если запускали вручную

Открываем конфиг:

nano /opt/hytale/server/config.json

Пример полного конфига:

{
  "Version": 3,
  "ServerName": "Мой Hytale Сервер",
  "MOTD": "Добро пожаловать в мир Orbis!",
  "Password": "",
  "MaxPlayers": 20,
  "MaxViewRadius": 16,
  "LocalCompressionEnabled": false,
  "Defaults": {
    "World": "default",
    "GameMode": "Adventure"
  },
  "ConnectionTimeouts": {
    "JoinTimeouts": {}
  },
  "RateLimit": {},
  "Modules": {},
  "LogLevels": {},
  "Mods": {},
  "PlayerStorage": {
    "Type": "Hytale"
  }
}

Ключевые параметры:

Параметр	Описание	Рекомендация
MaxPlayers	Максимум игроков	10–20 на 8GB RAM
MaxViewRadius	Радиус прогрузки (аналог view-distance)	12–16, снизьте при нехватке RAM
Password	Пароль на сервер	Оставьте "" для публичного
GameMode	Режим по умолчанию	"Adventure" или "Creative"

Для сравнения: MaxViewRadius 16 в Hytale ≈ 24 чанкам в Minecraft (384 блока против 160). Поэтому и требования к RAM выше. Если сервер лагает — первым делом снижайте MaxViewRadius до 10–12.

---

8. АВТОЗАПУСК ЧЕРЕЗ SYSTEMD

Чтобы сервер автоматически стартовал при перезагрузке VPS — создаём systemd-сервис.

Создаём стартовый скрипт:

sudo nano /opt/hytale/server/start.sh

Вставляем:

#!/bin/bash

cd /opt/hytale/server

# JVM параметры
JAVA_OPTS="-Xms4G -Xmx6G"
JAVA_OPTS="$JAVA_OPTS -XX:+UseG1GC"
JAVA_OPTS="$JAVA_OPTS -XX:MaxGCPauseMillis=200"
JAVA_OPTS="$JAVA_OPTS -XX:+ParallelRefProcEnabled"
JAVA_OPTS="$JAVA_OPTS -XX:+UnlockExperimentalVMOptions"
JAVA_OPTS="$JAVA_OPTS -XX:+DisableExplicitGC"

# Запуск сервера
java $JAVA_OPTS -jar HytaleServer.jar \
  --assets Assets.zip \
  --bind 0.0.0.0:5520

Даём права на выполнение:

sudo chmod +x /opt/hytale/server/start.sh
sudo chown hytale:hytale /opt/hytale/server/start.sh

Создаём systemd unit файл:

sudo nano /etc/systemd/system/hytale.service

Вставляем:

[Unit]
Description=Hytale Game Server
After=network.target

[Service]
User=hytale
Group=hytale
WorkingDirectory=/opt/hytale/server
ExecStart=/opt/hytale/server/start.sh
Restart=on-failure
RestartSec=10
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

Активируем и запускаем:

sudo systemctl daemon-reload
sudo systemctl enable hytale
sudo systemctl start hytale

Проверяем статус:

sudo systemctl status hytale

Просматриваем логи в реальном времени:

sudo journalctl -u hytale -f

Управление сервером:

sudo systemctl stop hytale     # остановить
sudo systemctl restart hytale  # перезапустить
sudo systemctl status hytale   # статус

---

9. ОБНОВЛЕНИЕ СЕРВЕРА

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

Важно: Пока Hytale в Early Access — обновляйте сервер сразу после каждого патча. Hypixel Studios обещают добавить tolerance ±2 версии, но пока этого нет.

Алгоритм обновления:

# 1. Останавливаем сервер
sudo systemctl stop hytale

# 2. Переключаемся на пользователя hytale
sudo su - hytale
cd /opt/hytale/server

# 3. Проверяем наличие обновлений
./bin/hytale-downloader -check-update

# 4. Скачиваем новую версию
./bin/hytale-downloader --server

# 5. Распаковываем новый архив (замените имя на актуальное)
unzip 2026.XX.XX-xxxxxxxxx.zip

# 6. Выходим обратно
exit

# 7. Запускаем обновлённый сервер
sudo systemctl start hytale

---

10. ОПТИМИЗАЦИЯ И СОВЕТЫ

JVM параметры для производительности

-XX:+UseG1GC                    # G1 сборщик мусора (лучший для серверов)
-XX:MaxGCPauseMillis=200        # Максимальная пауза GC (мс)
-XX:+ParallelRefProcEnabled     # Параллельная обработка ссылок
-XX:+UnlockExperimentalVMOptions
-XX:+DisableExplicitGC          # Отключает System.gc() из кода

Сколько RAM выделять серверу

Игроков	-Xmx	RAM VPS
1–5	4G	6 GB
5–15	6G	8 GB
15–30	10G	16 GB
30+	14G+	32 GB

Частые проблемы и решения

• Игроки не подключаются — проверьте что открыт именно UDP (не TCP), и что прошла аутентификация (/auth login device)
• Сервер лагает — снизьте MaxViewRadius в config.json до 10–12
• OutOfMemoryError — увеличьте -Xmx или снизьте MaxPlayers
• "NO SERVER TOKENS CONFIGURED" — сервер не авторизован, введите /auth login device в консоли
• Connection refused после обновления — версии клиента и сервера не совпадают, обновите сервер
• Нет доступа к config.json — убедитесь что редактируете файл когда сервер остановлен

Быстрые бэкапы миров

#!/bin/bash
# Сохранить в /opt/hytale/backup.sh и добавить в cron

DATE=$(date +%Y-%m-%d_%H-%M)
tar -czf /opt/hytale/backups/world_$DATE.tar.gz /opt/hytale/server/worlds/
echo "Backup created: world_$DATE.tar.gz"

# Удаляем бэкапы старше 7 дней
find /opt/hytale/backups/ -name "*.tar.gz" -mtime +7 -delete

Добавляем в cron (бэкап каждые 6 часов):

sudo crontab -u hytale -e

# Добавляем строку:
0 */6 * * * /opt/hytale/backup.sh

---

ГОТОВО! СЕРВЕР ЗАПУЩЕН

Поздравляем — ваш сервер Hytale работает на Ubuntu. Теперь зовите друзей и исследуйте Orbis вместе.

Есть вопросы? Пишите в комментариях — отвечаем в течение 24 часов.
Нашли ошибку в гайде? Кнопка "Сообщить об ошибке" внизу страницы.​

---

Источники: Официальная документация Hypixel Studios (support.hytale.com), Hytale Server Manual (January 2026), ZAP-Hosting Docs, PiMyLifeUp Linux Guide.[/CENTER]