Полное руководство: Создание сервера в Hytale
Это полное руководство по установке, настройке и эксплуатации выделенных серверов Hytale. Материал предназначен для администраторов серверов и игроков, которые хотят самостоятельно создать свой сервер в Hytale.
Требования к системе
Выделенный сервер Hytale может работать на любом устройстве с минимум 4 ГБ оперативной памяти и Java 25. Поддерживаются архитектуры x64 и arm64.
Нагрузка на CPU
Большое количество игроков или сущностей (NPC, мобы)
Нагрузка на RAM
Большая загруженная область мира, высокая дальность прорисовки
В Java сложно точно определить необходимый объём памяти. Экспериментируйте с параметром -Xmx. Если памяти недостаточно — возрастает нагрузка на CPU из-за частого сборщика мусора (GC).
Установка Java 25
Для сервера обязательно требуется Java 25. Официально рекомендуемый дистрибутив — Adoptium (Temurin), скачать его можно здесь: Adoptium (Eclipse Temurin).
Вы можете проверить текущую версию Java, установленную на вашем ПК. Выполните эту команду в командной строке или терминале:
java --version
После ввода команды, вы должны увидеть что-то такое:
openjdk 25.0.1 2025-10-21 LTS OpenJDK Runtime Environment Temurin-25.0.1+8 OpenJDK 64-Bit Server VM Temurin-25.0.1+8
Рекомендация
Для серверного использования рекомендуется Adoptium (Eclipse Temurin), так как это бесплатный OpenJDK-дистрибутив без лицензионных ограничений и с удобной политикой обновлений.
Temurin предоставляет доступ к Shenandoah GC, который снижает паузы сборщика мусора и обеспечивает более стабильную работу сервера по сравнению с Oracle JDK, использующим G1.
Получение файлов сервера Hytale
На данный момент существует два способа получить оригинальную сборку сервера.
Копирование из лаунчера
Лаунчер игры скачивает сразу и клиент и сервер. Для запуска сервера вам потребуются папка Server и архив Assets.zip.
%appdata%\Hytale\install\release\package\game\latest
$XDG_DATA_HOME/Hytale/install/release/package/game/latest
~/Application Support/Hytale/install/release/package/game/latest
Hytale Downloader CLI
Рекомендуемый способ скачивания официальной сборки сервера. Это встроенная командная утилита с OAuth2-аутентификацией для загрузки серверных файлов.
| Команда | Назначение |
|---|---|
| ./hytale-downloader | Скачать последнюю версию |
| -print-version | Показать версию игры |
| -patchline pre-release | Скачать pre-release |
| -download-path game.zip | Указать путь сохранения |
Скачивание сервера с помощью Hytale Downloader
Запустите hytale-downloader-windows или, если вы используете Linux, hytale-downloader-linux — загрузка начнётся автоматически.
Во время процесса загрузчик попросит вас пройти верификацию — просто следуйте указаниям в консоли и дождитесь завершения скачивания архива.
После завершения загрузки программу можно закрыть. Далее откройте скачанный архив, в котором есть папка Server и файл Assets.zip, и распакуйте файлы в папку, где будет располагаться ваш сервер.
Запуск сервера Hytale
Вам необходимо зайти в папку сервера и запустить .jar-файл с помощью базовой команды запуска:
java -jar HytaleServer.jar --assets PathToAssets.zip
Рекомендуем использовать .bat-файл для удобного запуска. Создайте start.bat рядом с HytaleServer.jar и вставьте в него следующую команду:
@echo off java -jar HytaleServer.jar --assets PathToAssets.zip pause
В аргументе --assets укажите путь к стандартному ассет-паку вашего сервера вместо PathToAssets.zip. Пример файла «правильного» start.bat выглядит вот так:
@echo off java -jar HytaleServer.jar --assets "D:\_Tutorial\MyServer\Assets.zip" pause
| Аргумент запуска | Описание |
|---|---|
| --accept-early-plugins | Явно укажите, что сервер может работать с плагинами, находящимися на ранних стадиях разработки. |
| --allow-op | Разрешить получение оператора сервера. |
| --assets <Путь> | Директория с ресурсами (по умолчанию:..\HytaleAssets). |
| --auth-mode <authenticated|offline> | Режим аутентификации (по умолчанию:AUTHENTICATED). |
| -b, --bind <InetSocketAddress> | Локальный IP адрес устройства, на котором запускается сервер (по умолчанию:0.0.0.0:5520). |
Аутентификация сервера
Для обеспечения безопасности каждый создаваемый сервер требует привязки и подтверждения через ваш аккаунт. На одну лицензию (аккаунт) действует ограничение — не более 100 серверов.
При первом запуске сервера необходимо выполнить вход (аутентификация). Используйте эту команду в консоли сервера или в игре:
/auth login device
Чтобы постоянно не делать авторизацию девайса — выполните эту команду:
/auth persistence Encrypted
Порт и сетевые настройки
Пример смены порта с помощью аргументов запуска .jar файла:
--bind 0.0.0.0:25565
Фаервол (брандмауэр)
Иногда требуется ручная установка разрешений в брандмауэре, чтобы сервер получил доступ в сеть и к нему могли подключаться другие игроки.
Windows
New-NetFirewallRule -DisplayName "Hytale Server" -Protocol UDP -LocalPort 5520 -Action Allow
Linux (ufw)
sudo ufw allow 5520/udp
Важные замечания по сети
- Hytale использует только протокол QUIC поверх UDP. Проброс портов TCP не требуется и не будет работать.
- В большинстве случаев QUIC хорошо справляется с обходом NAT. Однако проблемы с подключением могут возникнуть у игроков, если ваш интернет-провайдер использует симметричный NAT (Symmetric NAT).
Оптимизация и советы
Обязательно прочитайте эти советы по оптимизации сервера. Зачастую учитывая эти параметры, вы можете значительно увеличить производительность игрового мира в Hytale.
Моды
Просто помещайте .jar или .zip моды в папку mods/. Сервер уже знает, как работать с модами. Моды можно скачать с CurseForge и других сайтов.
Отключение краш-репортов Sentry
Отключайте Sentry только во время активной разработки плагинов, чтобы ваши ошибки отладки не попадали в систему отслеживания ошибок Hypixel Studios.
java -jar HytaleServer.jar --assets PathToAssets.zip --disable-sentry
Дальность прорисовки
Важный параметр для оптимизации сервера.
Для сравнения: 384 блока в Hytale это примерно 24 чанка в Minecraft.
По умолчанию Hytale использует больше памяти, чем Minecraft при одинаковых настройках дальности прорисовки.
Протокол
Клиент и сервер должны быть на одной версии протокола. Несовпадение версий приведет к отказу в подключении.
| Состояние | Описание |
|---|---|
| Текущее ограничение | Требуется точное совпадение версий. После выхода обновления серверы должны обновиться немедленно, иначе игроки с новой версией клиента не смогут к ним подключиться. |
| В будущем | Планируется внедрение толерантности к версиям протокола, позволяющее расхождение в +-2 версии между клиентом и сервером. Это даст администраторам небольшое окно для обновления без потери игроков. |
Структура файлов сервера
| Путь | Назначение |
|---|---|
| .cache/ | Оптимизированный кэш |
| logs/ | Логи сервера |
| mods/ | Моды |
| universe/ | Мир и данные игроков |
| config.json | Конфигурация сервера |
| permissions.json | Права |
| whitelist.json | Белый список |
Мульти-серверная архитектура Hytale
Hytale не требует BungeeCord или Velocity для создания прокси-серверов. В Hytale уже есть поддержка шардинга из коробки!
Перенаправление
Перенаправление игроков между серверами
Редиректы
Редиректы при подключении
Fallback-серверы
Fallback-серверы при крашах
Функция автоматического переподключения игроков на запасной сервер при аварийном отключении основного находится в разработке. Ожидается, что она будет реализована в течение нескольких недель после выхода игры в ранний доступ.