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

9s9s

Мечтаете создать постоянный мир для себя и друзей или организовать уникальный игровой опыт для тысяч игроков? Это руководство проведёт вас шаг за шагом через создание и настройку собственного пользовательского сервера Hytale. Hytale разработан для предоставления беспрецедентной гибкости создателям. Освоение хостинга вашего сервера — это первый шаг к раскрытию неограниченного потенциала кастомизации, от уникальных игровых правил до сложных мини-игр и пользовательских миров.

Необходимые требования

Аппаратное обеспечение

Перед началом убедитесь, что ваша машина (ПК или выделенный сервер) соответствует следующим требованиям:

Операционная система — рекомендуется Ubuntu. Также работают Windows 10/11 и macOS.

Процессор — x64 или ARM64. Обязательна 64-битная архитектура.

Оперативная память — рекомендуется 8 гигабайт. Минимум 4 гигабайта для старта. Планируйте больше для высокой дальности прорисовки.

Диск — 10 гигабайт минимум свободного места для сервера и резервных копий.

Java

Java версии 25 обязательна — Hytale не будет работать с более ранней версией.

Совет: рекомендуем установить Adoptium (Temurin) для получения Java 25. Командой java --version вы можете проверить установленную версию Java, например:

openjdk 25.0.1 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS)
OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing)

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

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

Порт по умолчанию — 5520 (UDP).

Правило файрвола — вы должны открыть порт 5520 в UDP. Открывать TCP не нужно.

Быстрые команды для открытия порта:

Linux (UFW): sudo ufw allow 5520/udp затем sudo ufw reload

Linux (iptables): sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT

Windows (PowerShell): New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

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

Существует два метода. Для надёжного и легко обновляемого сервера метод через CLI — король.

Метод А: Hytale Downloader CLI (рекомендуется)

Hytale Downloader (Linux и Windows) — это инструмент командной строки, позволяющий загружать файлы сервера и ассеты (ресурсы) с использованием безопасной OAuth2 аутентификации.

Для Linux:

Подготовьте папку: mkdir 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).

Извлечение: распакуйте полученный архив. У вас появится папка Server/ и файл Assets.zip.

Вот список всех доступных команд hytale downloader:

  • ./hytale-downloader — загружает последнюю доступную версию.

  • ./hytale-downloader -print-version — отображает версию игры без начала загрузки.

  • ./hytale-downloader -version — отображает текущую версию инструмента hytale-downloader.

  • ./hytale-downloader -check-update — проверяет, доступно ли обновление инструмента.

  • ./hytale-downloader -download-path game.zip — загружает файлы в конкретный файл (здесь game.zip).

  • ./hytale-downloader -patchline pre-release — загружает файлы из канала пре-релиз.

  • ./hytale-downloader -skip-update-check — игнорирует автоматическую проверку обновлений при запуске.

Метод Б: Вручную

Перейдите в папку, где установлена ваша игра Hytale на ПК. Путь обычно выглядит так: %appdata%\Hytale\install\release\package\game\latest

Найдите папку с названием Server и файл Assets.zip.

Скопируйте эти два элемента в новую чистую папку на рабочем столе (назовите её MyHytaleServer).

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

В отличие от других игр, ваш сервер Hytale должен быть привязан к вашему аккаунту для функционирования. Каждый аккаунт Hytale может создать максимум 100 серверов.

Шаг 1: Команда запуска

В вашем терминале перейдите в папку Server и запустите сервер этой командой:

Шаг 2: Привязка сервера к вашему аккаунту

При первом запуске сервер будет в режиме без настроенного токена. Он ожидает вашего подтверждения. Посмотрите на консоль:

Введите команду: /auth login device

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

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

Введите код.

После подтверждения консоль отобразит: Authentication successful! Mode: OAUTH_DEVICE.

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

Теперь, когда сервер работает, нужно сделать его плавным. Всё зависит от оперативной памяти и конфигурации Java.

Выделение оперативной памяти

Java не использует автоматически всю доступную память. Недостаточное выделение может вызвать замедления (лаги) и подтормаживания.

  • java -Xms<размер> -Xmx<размер> -jar HytaleServer.jar ...

  • -Xms определяет начальное выделение памяти.

  • -Xmx определяет максимальный лимит памяти.

  • Пример для 8 гигабайт оперативной памяти:

  • java -Xms8G -Xmx8G -jar HytaleServer.jar --assets ../Assets.zip

Рекомендации:

  • Маленький сервер — 4 гигабайта

  • Средний сервер — 6-8 гигабайт

  • Большой/Публичный — 10-16 гигабайт

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

Кэш Ahead-Of-Time (AOT)

Сервер Hytale включает AOT кэш (HytaleServer.aot), который может значительно улучшить время запуска, пропуская фазу разогрева JIT (Just-In-Time компиляции).

Использование:

  • Добавьте следующий аргумент к команде запуска вашего сервера:

  • java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets ../Assets.zip

Порт сервера

  • Порт по умолчанию — 5520. Измените его при необходимости:

  • java -jar HytaleServer.jar --assets PathToAssets.zip --bind 0.0.0.0:25565

Дальность прорисовки

Дальность прорисовки — основной фактор потребления оперативной памяти на вашем сервере.

Hytale использует дальность прорисовки по умолчанию около 384 блоков (12 чанков), что значительно выше, чем в некоторых похожих играх.

Рекомендация: для баланса производительности и геймплея рассмотрите ограничение максимальной дальности прорисовки до 12 чанков. Корректируйте это значение в зависимости от ожидаемого количества игроков и ресурсов вашего сервера.

Для изменения значения отредактируйте MaxViewRadius в общем config.json сервера.

Структура файлов

После запуска ваша папка заполнится новыми файлами. Вот наиболее важные для вас:

  • .cache/ — кэш для оптимизированных файлов

  • logs/ — файлы логов сервера

  • mods/ — установленные моды

  • universe/ — данные сохранений мира и игроков

  • bans.json — забаненные игроки

  • config.json — конфигурация сервера

  • permissions.json — конфигурация прав доступа

  • whitelist.json — игроки в белом списке

Внимание: ручные изменения этих файлов во время работы сервера могут быть перезаписаны. Всегда останавливайте сервер перед изменением этих файлов.

Глобальные настройки

Наиболее распространённые и базовые настройки сервера Hytale редактируются в файле config.json:

Информация и доступ

  • ServerName (текст) — публичное имя вашего сервера. Это то, что будет отображаться в списке серверов. Пример: Мой русский сервер Hytale.

  • MOTD (текст) — сообщение дня. Приветственное или объявляющее сообщение, отображаемое под именем сервера. Совет: используйте его для объявления технических работ или приветствия игроков.

  • Password (текст) — пароль доступа. Если заполнен, сервер становится приватным. Оставьте кавычки пустыми для публичного сервера.

  • MaxPlayers (целое число) — вместимость хостинга. Максимальное количество одновременных игроков. Предупреждение: чем выше это число, тем больше требуется оперативной памяти и процессора.

Производительность и технические аспекты

  • MaxViewRadius (целое число) — дальность прорисовки (в чанках). Критическое влияние: это настройка, которая потребляет больше всего оперативной памяти. Рекомендация: 12 (стандарт) до 16 (высокий). Избегайте больше 16 без очень мощной машины.

  • LocalCompressionEnabled (булево значение) — оптимизация пропускной способности. true включает сжатие данных. Снижает использование сети, но немного увеличивает использование процессора. Рекомендуется для публичных серверов.

  • Version (целое число) — версия конфигурационного файла. Не трогайте это число; оно позволяет игре знать, актуален ли ваш файл.

Геймплей (секция Defaults)

  • Defaults > World (текст) — имя мира по умолчанию. Если эта папка не существует в universe/, сервер создаст её при запуске. По умолчанию: default.

  • Defaults > GameMode (текст) — игровой режим для новичков. Варианты: ADVENTURE (классическое выживание) или CREATIVE (строительство).

  • Продвинутые настройки (сеть и система)

  • ConnectionTimeouts (объект) — управляет задержками перед отключением игрока, который больше не отвечает (лаг). Оставьте пустым {} для использования настроек движка по умолчанию.

  • RateLimit (объект) — защита от спама пакетов (лёгкий DDoS или баги клиента). Оставьте пустым {}, если не знаете, как настраивать точные лимиты.

  • PlayerStorage (объект) — определяет, как сохраняются данные игроков. По умолчанию: Type: Hytale (стандартное локальное сохранение).

  • DisplayTmpTagsInStrings (булево значение) — инструмент разработки. Отображает необработанные теги перевода или форматирования. Оставьте false для продакшена.

  • Существуют также выделенные конфигурационные файлы для ваших миров и модов/плагинов.

Обновление сервера

Когда доступна новая версия Hytale, Hytale Downloader CLI облегчает обновление вашего сервера. Важно убедиться, что сам downloader обновлён перед его использованием для обновления сервера:

  • ./hytale-downloader-linux-amd64 -check-update (или исполняемый файл, соответствующий вашей ОС)

После того как downloader обновлён, вы можете приступить к обновлению файлов сервера:

Остановите ваш сервер Hytale — перед любым обновлением убедитесь, что ваш сервер полностью остановлен, чтобы избежать повреждения данных.

Запустите Hytale Downloader для загрузки последней версии сервера Hytale и связанных файлов ассетов:

  • ./hytale-downloader-linux-amd64 (или исполняемый файл вашей ОС)

  • Downloader загрузит самый свежий архив (например, 2026.01.13-50e69c385.zip или 2026.01.15-c04fdfe10.zip) в вашу текущую директорию. Он может использовать CACHE_DIRECTORY (.cache/) для избежания избыточных загрузок.

  • Извлеките новые файлы:

  • unzip [ИМЯ_СКАЧАННОГО_АРХИВА].zip (пример: unzip 2026.01.15-c04fdfe10.zip)

  • Это извлечёт папки Server/ и файл Assets.zip.

  • Совет: если вы хотите загрузить конкретную версию или канал пре-релиза, используйте опции:

  • ./hytale-downloader -patchline pre-release

  • ./hytale-downloader -download-path my_custom_server.zip

  • Замените старые файлы — скопируйте извлечённые новые папки Server/ и файл Assets.zip в основную директорию вашего сервера, перезаписав предыдущие версии.

  • Запустите сервер Hytale:

  • java -jar Server/HytaleServer.jar --assets Assets.zip

Ваш сервер перезапустится с новой версией. Возможно, вам потребуется повторно аутентифицироваться, если токены истекли или новая процедура безопасности этого требует. Используйте /auth login device в консоли сервера, если появится предупреждение NO SERVER TOKENS CONFIGURED.

Получение прав администратора сервера

Чтобы дать себе права администратора сервера, обратитесь к нашему выделенному руководству.

Рекомендуемые моды и плагины

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

Где найти моды и плагины для Hytale?

Первый шаг — найти надёжные моды и плагины.

CurseForge — это референсная платформа для модов Hytale (а также для других игр). Вы найдёте там обширный выбор паков и плагинов.

Modtale — ещё одна развивающаяся директория сообщества для открытия контента Hytale.

GitHub и сообщества — некоторые разработчики публикуют свои проекты напрямую на GitHub или делятся ими через выделенные Discord-серверы по моддингу Hytale.

Совет: перед загрузкой всегда проверяйте описание мода на совместимость (версия Hytale) и требуемые зависимости. Всегда загружайте из надёжных источников, чтобы избежать вредоносного ПО.

Установка модов и плагинов

Java-плагины (.jar) устанавливаются на стороне сервера. Шаги немного различаются в зависимости от того, используете ли вы размещённый сервер или хостите свой собственный.

Остановите ваш сервер, чтобы избежать повреждения файлов во время передачи.

Перейдите в папку mods/. Здесь хранятся плагины.

Загрузите файл .jar вашего плагина.

Запустите ваш сервер. Плагин будет автоматически загружен при запуске.

Настройте плагин: при запуске файл config.json был создан в директории mods/pluginname/.

Рекомендуемые плагины

Вот несколько рекомендуемых плагинов для ваших серверов:

  • Nitrado:WebServer — базовый плагин для веб-приложений и API.

  • Nitrado:Query — предоставляет статус сервера (количество игроков и так далее) через HTTP протокол.

  • Nitrado:PerformanceSaver — динамически ограничивает дальность прорисовки на основе использования ресурсов сервера.

  • ApexHosting:PrometheusExporter — предоставляет детализированные метрики по серверу и JVM (виртуальная машина Java).

Модерация вашего сервера: кик и бан

Hytale делает управление игроками простым благодаря трём важным командам: kick, ban и unban. Чтобы забанить или разбанить игрока на вашем сервере:

  • /ban <имя_игрока_или_uuid>

  • /unban <имя_игрока_или_uuid>

  • Чтобы кикнуть игрока:

  • /kick <имя_игрока_или_uuid>

Защита доступа к серверу с помощью белого списка

Белый список (whitelist) позволяет вам контролировать, кто может подключаться к вашему серверу. Только игроки, добавленные в белый список, смогут войти. Это особенно полезно для приватных серверов для друзей или закрытых сообществ.

Looking for Hytale servers?

Find the best servers to play in our catalog

Browse servers
← All posts