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.