Как создать свой сервер Hytale

Это руководство объясняет, как установить и настроить выделенный сервер Hytale на вашем VPS или выделенном Linux-сервере.

Заказать сервер

Для размещения вашего сервера Hytale, HostMyServers предлагает несколько вариантов, оптимизированных для игр:

• Performance VPS - Идеально для небольших серверов
• NVMe VPS - Отличное соотношение цены и качества
• Эко выделенные серверы - Для серверов с большим количеством игроков
• Выделенные серверы Performance - Максимальная производительность

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

• SSH-доступ как root или пользователь с правами sudo
• 64-битная система Linux (Ubuntu/Debian рекомендуется)
• Процессор x64 или ARM64
• Минимум 4 ГБ RAM (8 ГБ рекомендуется)
• Около 10 ГБ свободного дискового пространства (SSD рекомендуется)
• Порт 5520 UDP доступен
• Действующий аккаунт Hytale

Требуемая конфигурация

Компонент	Минимум	Рекомендуется
RAM	4 ГБ	8-16 ГБ
CPU	2 ядра	4 ядра
Хранилище	10 ГБ SSD	20 ГБ SSD
Сеть	100 Мбит/с	1 Гбит/с

Сетевой протокол

Hytale использует протокол QUIC поверх UDP (не TCP как Minecraft). Порт по умолчанию — 5520 UDP.

Обновление системы

sudo apt update && sudo apt upgrade -y

Установка Java 25

Hytale требует минимум Java 25. Более ранние версии не будут работать.

Установка Adoptium Temurin 25

# Добавление репозитория Adoptium
sudo apt install -y wget apt-transport-https gpg
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo gpg --dearmor -o /usr/share/keyrings/adoptium.gpg
echo "deb [signed-by=/usr/share/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/adoptium.list

# Установка Java 25
sudo apt update
sudo apt install -y temurin-25-jdk

Проверка установки

java --version

Создание выделенного пользователя

По соображениям безопасности создайте выделенного пользователя:

sudo adduser --disabled-password --gecos "" hytale

Настройка брандмауэра

Откройте UDP порт 5520:

С UFW

sudo ufw allow 5520/udp
sudo ufw reload

С iptables

sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

Загрузка сервера Hytale

Рекомендуемый метод: Hytale Downloader CLI

Подключитесь как пользователь hytale:

sudo -u hytale bash
cd ~

Создайте директорию и загрузите инструмент:

mkdir -p ~/hytale-server
cd ~/hytale-server
wget https://downloader.hytale.com/hytale-downloader.zip
unzip hytale-downloader.zip
chmod +x hytale-downloader-linux-amd64

Загрузка файлов сервера

./hytale-downloader-linux-amd64

Терминал попросит вас перейти на oauth.accounts.hytale.com для авторизации загрузки. Следуйте отображаемым инструкциям.

После подтверждения вы получите архив (напр.: 2026.01.13-xxxx.zip).

Извлечение файлов

unzip 2026.01.*.zip

У вас будет папка Server/ и файл Assets.zip.

Первый запуск и аутентификация

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

cd ~/hytale-server
java -jar Server/HytaleServer.jar --assets Assets.zip

Аутентификация сервера

При первом запуске сервер отображает "No Server Token Configured". Вы должны привязать его к вашему аккаунту Hytale.

1. В консоли сервера введите:

   /auth login device

2. Консоль отобразит код (напр.: ABCD-1234) и URL

3. Перейдите на https://accounts.hytale.com/device

4. Введите отображённый код

5. После подтверждения консоль покажет: Аутентификация успешна! Режим: OAUTH_DEVICE

Примечание

Каждый аккаунт Hytale может создать максимум 100 серверов.

Настройка сервера

Файл config.json

После первого запуска отредактируйте файл конфигурации:

nano ~/hytale-server/config.json

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

Параметр	Тип	Описание
ServerName	Текст	Публичное имя сервера
MOTD	Текст	Приветственное сообщение
Password	Текст	Пароль (пусто = публичный)
MaxPlayers	Целое	Макс. количество игроков
MaxViewRadius	Целое	Дистанция видимости в чанках (12-16 рекомендуется)
LocalCompressionEnabled	Булево	Сжатие данных (рекомендуется: true)
Defaults > World	Текст	Имя мира по умолчанию
Defaults > GameMode	Текст	Режим игры (Adventure или Creative)

Оптимизация запуска

Выделение памяти

java -Xms4G -Xmx8G -jar Server/HytaleServer.jar --assets Assets.zip

Размер сервера	Рекомендуемый RAM
Маленький (1-10 игроков)	4 ГБ
Средний (10-20 игроков)	6-8 ГБ
Большой (20+ игроков)	10-16 ГБ

Кэш AOT (Ahead-Of-Time)

Для улучшения времени запуска:

java -XX:AOTCache=HytaleServer.aot -Xms4G -Xmx8G -jar Server/HytaleServer.jar --assets Assets.zip

Настройка как сервис systemd

Создание файла сервиса

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

Содержимое файла:

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

[Service]
Type=simple
User=hytale
Group=hytale
WorkingDirectory=/home/hytale/hytale-server
ExecStart=/usr/bin/java -Xms4G -Xmx8G -XX:AOTCache=HytaleServer.aot -jar /home/hytale/hytale-server/Server/HytaleServer.jar --assets /home/hytale/hytale-server/Assets.zip
Restart=on-failure
RestartSec=20

[Install]
WantedBy=multi-user.target

Активация и запуск сервиса

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

Команды управления

# Проверить статус
sudo systemctl status hytale.service

# Остановить сервер
sudo systemctl stop hytale.service

# Перезапустить сервер
sudo systemctl restart hytale.service

# Просмотр логов
sudo journalctl -u hytale.service -f

Команды консоли

Команда	Описание
/auth login device	Аутентифицировать сервер
/stop	Остановить сервер
/save	Сохранить мир
/kick <игрок>	Выгнать игрока
/ban <игрок>	Забанить игрока
/unban <игрок>	Разбанить игрока
/whitelist add <игрок>	Добавить в белый список
/whitelist remove <игрок>	Удалить из белого списка
/op <игрок>	Дать права админа
/deop <игрок>	Забрать права админа

Автоматическое резервное копирование

Скрипт резервного копирования

sudo nano /home/hytale/backup.sh

#!/bin/bash
BACKUP_DIR="/home/hytale/backups"
SERVER_DIR="/home/hytale/hytale-server"
DATE=$(date +%Y-%m-%d_%H-%M-%S)

mkdir -p $BACKUP_DIR

# Резервная копия вселенной и конфига
tar -czf $BACKUP_DIR/hytale_$DATE.tar.gz -C $SERVER_DIR universe config.json bans.json whitelist.json permissions.json

# Удаление резервных копий старше 7 дней
find $BACKUP_DIR -name "hytale_*.tar.gz" -mtime +7 -delete

echo "Резервное копирование завершено: hytale_$DATE.tar.gz"

sudo chown hytale:hytale /home/hytale/backup.sh
sudo chmod +x /home/hytale/backup.sh

Планирование резервного копирования

sudo crontab -u hytale -e

Добавьте:

# Резервное копирование каждые 6 часов
0 */6 * * * /home/hytale/backup.sh

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

Игроки могут подключиться через:

1. Запустить Hytale
2. Перейти в "Сетевая игра"
3. Ввести адрес: IP_СЕРВЕРА:5520
4. Если настроен пароль, ввести его

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

Сервер не запускается

• Проверьте версию Java: java --version (должна быть 25+)
• Проверьте логи: sudo journalctl -u hytale.service -n 100
• Проверьте наличие файлов Assets.zip и Server/

Ошибка аутентификации

• Повторно выполните /auth login device в консоли
• Проверьте, что ваш аккаунт Hytale действителен
• Проверьте интернет-соединение сервера

Игроки не могут подключиться

• Проверьте, что порт 5520 UDP открыт: sudo ufw status
• Проверьте, что сервер слушает: ss -ulnp | grep 5520
• Протестируйте с nc -zvu IP_СЕРВЕРА 5520

Проблемы с производительностью

• Увеличьте выделенную RAM (-Xmx)
• Уменьшите MaxViewRadius в config.json
• Включите LocalCompressionEnabled
• Запланируйте регулярные перезапуски