Как запустить свой сервер Hytale: пошаговая инструкция

Оглавление

Подготовка: системные требования и сеть Шаг 1: Получение серверных файлов Шаг 2: Первый запуск и авторизация Шаг 3: Оптимизация и конфигурация Шаг 4: Управление настройками и файлами Шаг 5: Обновление сервера

Создание собственного сервера в Hytale открывает безграничные возможности для кастомизации: от изменения правил игры до создания сложных мини-игр и уникальных миров. Благодаря гибкости движка, вы можете развернуть как небольшую площадку для друзей, так и масштабный проект для тысяч пользователей.

Ниже — гайд по созданию и настройке сервера Hytale.

Подготовка: системные требования и сеть

Прежде чем приступать к установке, убедитесь, что ваше оборудование соответствует рекомендациям.

ОС: Ubuntu (рекомендуется), Windows 10/11 или macOS.
Процессор: архитектура x64 или ARM64 (64-бит обязательно).
ОЗУ: минимум 4 ГБ, рекомендуется 8 ГБ и более (зависит от дальности прорисовки).
Диск: от 10 ГБ свободного места.
Java: строго версия 25 (рекомендуется сборка Adoptium Temurin). Проверить версию можно командой java --version.

Настройка сети:

Hytale использует протокол QUIC поверх UDP (не TCP).

Порт по умолчанию: 5520 (UDP).
Брандмауэр: необходимо открыть входящий трафик для порта 5520 UDP.

Шаг 1: Получение серверных файлов

Существует два основных способа достать необходимые файлы.

Метод А: Интерфейс командной строки (Hytale Downloader CLI) — рекомендуется

Этот инструмент позволяет скачивать файлы через консоль, используя авторизацию OAuth2.

Создайте папку и скачайте загрузчик с официального сайта.
Запустите исполняемый файл. Терминал попросит вас перейти на oauth.accounts.hytale.com для авторизации.
После валидации начнется загрузка архива. Распакуйте его — внутри вы найдете папку Server/ и файл ресурсов (Assets.zip).

Метод Б: Ручной способ

Если игра уже установлена на вашем ПК:

Перейдите в папку с игрой (обычно в %appdata%).
Найдите папку Server и файл Assets.zip.
Скопируйте их в новую отдельную директорию для сервера.

Шаг 2: Первый запуск и авторизация

Ваш сервер должен быть «привязан» к вашей учетной записи (лимит — до 100 серверов на аккаунт).

В терминале перейдите в папку сервера и введите команду запуска: java -jar HytaleServer.jar --assets ../Assets.zip
Консоль выдаст сообщение о том, что токен не настроен. Введите команду: /auth login device.
Консоль покажет код (например, ABCD-1234) и ссылку.
Перейдите по адресу https://accounts.hytale.com/device, введите код и подтвердите действие.
После этого в консоли появится надпись: Authentication successful!.

Шаг 3: Оптимизация и конфигурация

Для стабильной работы сервера необходимо правильно распределить ресурсы.

Выделение оперативной памяти: Используйте аргументы -Xms (начальная память) и -Xmx (максимальная).

Пример для 8 ГБ: java -Xms8G -Xmx8G -jar HytaleServer.jar --assets ../Assets.zip.

Всегда оставляйте 1-2 ГБ памяти свободной для самой операционной системы.

Дальность прорисовки (View Distance): Это главный фактор потребления памяти. Рекомендуется установить значение MaxViewRadius в файле конфигурации (config.json) на уровне 12 чанков. Значения выше 16 требуют очень мощного оборудования.

AOT-кэш: Для ускорения запуска используйте аргумент -XX:AOTCache=HytaleServer.aot.

Шаг 4: Управление настройками и файлами

Основные параметры меняются в файле config.json.

Важно: всегда выключайте сервер перед редактированием файлов.

ServerName: имя сервера в списке.
Password: оставьте пустым для публичного доступа.
MaxPlayers: максимальное количество игроков.
Defaults > GameMode: режим игры для новых игроков ("ADVENTURE" или "CREATIVE").

Структура папок:

mods/ — для установки плагинов.
universe/ — сохранения мира и игроков.
logs/ — логи сервера.
whitelist.json — «белый список» игроков.

Шаг 5: Обновление сервера

При выходе новой версии используйте Hytale Downloader:

Полностью остановите сервер.
Проверьте обновление самого загрузчика командой -check-update.
Запустите загрузчик для скачивания свежего архива.
Распакуйте новые файлы поверх старых, заменив папку Server и Assets.zip.
Запустите сервер. При необходимости повторите авторизацию через /auth login device.

Успешный запуск сервера — это только начало. Для расширения функционала вы можете устанавливать плагины (файлы .jar) в папку mods, скачивая их с проверенных ресурсов, таких как CurseForge. Модерация игроков осуществляется стандартными командами /kick, /ban и /unban прямо в консоли или игровом чате.