Hytale предоставляет официальный выделенный сервер HytaleServer.jar (Java 25, не менее 4 ГБ памяти, UDP 5520 по QUIC), который нужно аутентифицировать аккаунтом Hytale. Игра в раннем доступе, поэтому сверяйтесь с официальным руководством поддержки Hytale; ниже — сопоставление поддержки и руководств хостеров.
Пошаговая установка
Проверьте машину: Java 25 (x64/arm64), 4 GB RAM min..
Получите файлы сервера: папку Server (с HytaleServer.jar) и Assets.zip из установки игры либо через официальный Hytale Downloader (вход по коду).
Установите Java 25 и проверьте командой java -version.
Запустите java -jar HytaleServer.jar --assets Assets.zip; config.json, logs/ и universe/ создаются при первом запуске.
В консоли выполните /auth login device, подтвердите код на accounts.hytale.com/device, затем /auth persistence Encrypted.
Отредактируйте config.json при остановленном сервере (ServerName, MOTD, Password, MaxPlayers, MaxViewRadius).
Откройте порты 5520/UDP в брандмауэре и на роутере.
Заходите по адресу вверху консоли (IP:5520); DNS SRV пока не поддерживаются, используйте A-запись.
Настройте автозапуск (планировщик задач или служба systemd).
Запланируйте резервные копии universe/ и обновления.
Требования
- Java 25 (x64 или arm64); не менее 4 ГБ памяти, главный потребитель RAM — дальность прорисовки (MaxViewRadius, рекомендуется не более 12 чанков)
- Аккаунт Hytale с игрой; одна лицензия ограничена 500 серверами
- Клиент и сервер должны использовать одну версию протокола
Локальная установка (Windows)
Создайте папку (например, C:\HytaleServer), скопируйте в неё папку Server и Assets.zip из %appdata%\Hytale\install\release\package\game\latest и выполните команду. Для сервера на одном ПК с игрой нужно не менее 16 ГБ RAM суммарно.
cd C:\HytaleServer
java -Xms4G -Xmx4G -jar HytaleServer.jar --assets Assets.zipУстановка на Linux VPS / выделенный сервер
В Ubuntu/Debian: пользователь без root, Java 25 (например, Eclipse Temurin 25), затем Hytale Downloader для получения сервера (вход по коду, токен в .hytale-downloader-credentials.json; при ошибках аутентификации удалите этот файл). Точные опции downloader здесь не описаны: читайте его справку.
sudo adduser --disabled-password --gecos "" hytale
sudo -iu hytale
mkdir -p ~/hytale-server && cd ~/hytale-server
java -version # doit afficher 25 / must show 25
java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zipПорты для открытия
- 5520/UDP: порт игры по умолчанию (QUIC), меняется через --bind; TCP открывать не нужно
Брандмауэр Linux (ufw)
В Ubuntu/Debian сначала разрешите SSH, чтобы не потерять доступ, затем порты игры.
sudo ufw allow OpenSSH
sudo ufw allow 5520/udp
sudo ufw enable
sudo ufw statusБрандмауэр Windows (netsh)
В PowerShell от имени администратора (или «cmd» администратора):
netsh advfirewall firewall add rule name="Hytale 5520/UDP" dir=in action=allow protocol=UDP localport=5520Брандмауэр хостера и проброс портов (NAT)
Если сервер у хостера (OVH, Hetzner, Scaleway…), откройте те же порты в его сетевом брандмауэре («security group»). При домашнем хостинге пробросьте порты (NAT) с роутера на постоянный локальный IP машины. Проверяйте извне (мобильный интернет или друг): проверка из своей сети ничего не доказывает.
Автозапуск и мониторинг
Создайте /etc/systemd/system/<имя>.service и выполните: sudo systemctl daemon-reload && sudo systemctl enable --now <имя>. Логи: journalctl -u <имя> -f.
[Unit]
Description=Hytale server
After=network-online.target
Wants=network-online.target
[Service]
User=hytale
WorkingDirectory=/home/hytale/hytale-server
ExecStart=/usr/bin/java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zip
Restart=on-failure
RestartSec=15
[Install]
WantedBy=multi-user.targetАвтозапуск в Windows (планировщик задач)
Создайте задачу планировщика «При запуске системы», выполняющую скрипт запуска, с наивысшими правами и «Выполнять вне зависимости от входа пользователя».
Обновления, резервные копии и перезапуски
Остановите сервер, снова выполните Hytale Downloader и перезапустите. Перед крупным обновлением копируйте universe/. Сервер проверяет новую версию при каждом запуске: обычно достаточно перезапуска. Делайте бэкап перед сменой patchline (release/pre-release): миры пре-релиза могут не открываться в старых сборках.
# backup
tar czf ~/backup-$(date +%F).tar.gz -C ~/server universe/Как добавить и найти сервер
Когда сервер станет публичным, добавьте его на https://game-rank.com/jeux/hytale (сайт владельца этого инструмента), чтобы игроки могли найти его, следить за ним и голосовать.
Устранение неполадок
- Недоступен снаружи, но работает на localhost: нет правила в брандмауэре ОС, у хостера или проброса NAT, либо неверный протокол (UDP/TCP). Проверьте каждый уровень по очереди.
- Подключение отклонено после обновления игры: версии клиента и сервера должны совпадать. Обновите сервер ещё раз и перезапустите его.
- Сервер сразу закрывается: запустите из консоли, чтобы прочитать ошибку, и проверьте свободную RAM, диск и программные требования.
- «Требуется аутентификация» или вход пропадает после перезапуска: повторите /auth login device и проверьте /auth persistence (Memory — теряется при перезапуске; выберите Encrypted).
- Нехватка памяти или лаги: уменьшите MaxViewRadius (/maxviewradius <радиус>), прежде чем наращивать RAM.
Частые вопросы
- Есть ли у Hytale официальный выделенный сервер?
- Да: HytaleServer.jar, описан поддержкой Hytale. Игра в раннем доступе, опции и форматы (config.json…) могут меняться.
- Почему нет генератора config.json?
- Только несколько полей (ServerName, MOTD, Password, MaxPlayers, MaxViewRadius, бэкапы) описаны сторонними источниками, официальной схемы нет: мы её не выдумываем. Редактируйте созданный файл при остановленном сервере.
- Что нужно копировать?
- Папку universe/ (миры и данные игроков), а также config.json и permissions.json.
- Можно ли запустить без аккаунта (офлайн-режим)?
- В руководствах упоминается --auth-mode offline для разработки; для публичного сервера это не обычный путь. Проверьте через --help.