Как настроить сервер Hytale (2026)

В этом руководстве мы рассмотрим установку, настройку и добавление в список серверов Hytale на Windows, Linux и macOS.

Серверы Hytale немного отличаются от других игр, для которых мы пишем гайды по серверам, по одной причине: каждый мир Hytale уже является сервером. Когда вы создаёте одиночный мир, клиент запускает локальный сервер и подключается к нему. Мультиплеер устроен так же, только с подключением других игроков. Отдельного «серверного режима», в который нужно переключаться, не существует.

Это также означает, что моды — забота сервера, а не клиента, о чём подробно рассказано в нашем гайде по модам для Hytale.

Замечание об актуальности: Hytale находится в раннем доступе с января 2026 года, и Hypixel Studios ещё не опубликовали отдельный документ по настройке выделенного сервера. Всё изложенное ниже составлено на основе официальной документации, патчноутов и Server Operator Policies, и в тексте чётко указано, где заканчиваются официальные рекомендации.

Требования

Официальные минимальные требования Hytale для клиента:

	Минимум
ОС	Windows 11 или Windows 10 x64 (1809), Linux x64 (ядро 6.15), либо Apple Silicon с macOS Tahoe 26.0
CPU	Intel Core i5-7500, AMD Ryzen 3 1200 или Apple M1
RAM	8 ГБ
GPU	Intel UHD 620, AMD Radeon Vega 6, Apple M1, либо видеокарта уровня GTX 900 / Radeon 400 series

Для сервера строку GPU можно игнорировать, а всё остальное — брать с запасом:

• RAM — главное ограничение. Сервер написан на Java, он держит в памяти загруженные чанки и сущности, а асеет-паки добавляют нагрузки сверху. 8 ГБ — это минимум для небольшой группы, а загруженному серверу с модами нужно значительно больше.
• Важна однопоточная производительность. Как и в большинстве блочных игр, значительная часть тиковой логики не распараллеливается.
• Дисковое пространство полностью зависит от того, насколько исследован мир. Сохранения мира растут постепенно.
• Лицензия Hytale, купленная на hytale.com. Игры нет в Steam.

ПРИМЕЧАНИЕ — На macOS Hytale работает только на Apple Silicon. Сборки для Intel Mac не существует.

Понимание серверной модели Hytale

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

На практике из этого следует несколько вещей, которые стоит запомнить:

• Моды устанавливаются один раз, хостом. Игроки, подключающиеся к вашему серверу, ничего не устанавливают. Их ванильный клиент отображает всё, что передаёт сервер.
• Ваш опыт из одиночной игры пригодится. Настройка мира в одиночной игре и настройка сервера — практически одно и то же умение.
• Модифицированного клиента для распространения не существует. Студия заявила, что не планирует поддерживать клиентские моды именно для того, чтобы никогда не сформировалась раздробленная экосистема клиентов под каждый сервер.

Вселенные, миры и инстансы

Hytale организует всё по иерархии, которая встречается во всех конфигах и патчноутах.

Вселенная содержит миры. Мир — это то, что игроки воспринимают как карту. Инстансы — это отдельные копии мира, используемые, например, для порталов (Portal Devices), и они могут наследовать такие настройки, как урон от падения и PvP, от мира по умолчанию во вселенной.

Эта терминология будет встречаться в конфигурации плагинов, так что её стоит знать перед тем, как начать читать конфиг-файлы.

Хостинг с клиента

Для небольшой группы этого достаточно, и дополнительный софт не нужен.

Создайте мир в клиенте, выберите нужные моды и асеет-паки в настройках New World и отправьте друзьям код приглашения. Они подключатся и будут играть с полностью ванильным клиентом.

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

Запуск отдельного (standalone) сервера

Если нужно что-то постоянно работающее без вашего участия, сервер стоит выделить отдельно.

Именно здесь официальная документация сейчас заканчивается. Hypixel Studios предоставляют справочник по Java Server API и документацию по асеетам, а также ведут Server Discovery с полноценным документом политики, так что самостоятельный хостинг серверов явно предусмотрен и поддерживается. Чего пока не опубликовано — это пошагового гайда вида «скачайте это, запустите эту команду», как у Valheim или ARK.

Пока этого нет, практические варианты такие:

• Лаунчер Hytale и менеджер аккаунта. Распространение серверов происходит через собственную платформу Hytale, а не через сторонний магазин, так что в первую очередь стоит проверить accounts.hytale.com.
• Официальный Discord. В Discord Hytale присутствуют разработчики студии, и там же находятся нынешние операторы серверов. Для настолько быстро меняющейся темы это надёжнее любого письменного гайда, включая этот.
• Управляемый хостинг. Несколько хостинг-провайдеров серверов добавили поддержку Hytale в течение 2026 года и берут настройку на себя.

ПРИМЕЧАНИЕ — Сервер не обфусцирован, и студия обязалась выпустить исходный код сервера в рамках программы Hytale Shared Source, запущенной в июне 2026 года. Владельцы лицензии получают доступ к полному исходному коду сервера, сетевому протоколу и асеетам на GitHub, по модели, схожей с программой исходного кода Unreal Engine от Epic. Для технически подкованных людей это самая полная документация из существующих.

Где находятся файлы сервера

При клиентской установке серверная часть находится в UserData:

C:\Users\<user>\AppData\Roaming\Hytale\UserData

с Mods для глобально доступных модов и Saves\<World Name> для каждого мира, у каждого из которых есть своя папка mods.

Linux и macOS используют эквивалентную для платформы директорию данных приложения с той же структурой внутри.

Автономный сервер сохраняет ту же структуру: директория mods для плагинов и наборов ассетов, и данные мира рядом с ней.

Требования для Linux

Сервер Hytale написан на Java, поэтому вам понадобится JVM плюс обычные инструменты для обслуживания сервера.

Debian и Ubuntu:

sudo apt update
sudo apt install -y openjdk-21-jre-headless screen curl unzip

Fedora, RHEL и Rocky:

sudo dnf install -y java-21-openjdk-headless screen curl unzip

Проверьте, что у вас установлено, с помощью:

java -version

СОВЕТ - Перед выбором JVM проверьте версию Java, которую ожидает текущая сборка Hytale. Она менялась в ходе раннего доступа, и несоответствие приводит к невнятной ошибке.

Требование Hytale к Linux — система x64 с ядром 6.15, что новее, чем поставляют по умолчанию некоторые LTS-дистрибутивы. Проверьте с помощью uname -r перед началом.

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

Моды помещаются в директорию mods сервера, и сервер загружает их при запуске.

1. Скачайте плагин или набор ассетов, обычно с CurseForge.
2. Поместите его в директорию mods сервера. Плагины — это Java-файлы .jar; наборы ассетов — это архив zip или папка с manifest.json внутри.
3. Перезапустите сервер.

Хорошо сделанные плагины создают собственную папку в mods для конфигурации и данных. BetterMap, например, создаёт mods/bettermap/ с config.json внутри и регистрирует команды /bm, включая /bm reload для применения изменений конфигурации без перезапуска.

Игрокам ничего не нужно устанавливать. В этом и заключается смысл серверной модели.

Наш гайд по модам Hytale подробно рассказывает о четырёх категориях модов и о том, как собираются наборы ассетов.

Настройка

Конфигурация Hytale — это JSON, разбросанный по нескольким местам, а не собранный в одном файле в стиле server.properties.

• Настройки мира выбираются при создании мира и охватывают такие вещи, как урон от падения и PvP, а инстансы могут наследовать их от мира по умолчанию во вселенной.
• Игровые конфиги находятся в JSON внутри директорий конфигурации сервера. В патчноутах упоминаются такие пути, как GameplayConfigs/Portal.json, что даёт представление о структуре.
• Конфиги плагинов находятся в собственной папке каждого плагина внутри mods.

Поскольку формат и пути всё ещё меняются между обновлениями, стоит читать патчноуты на hytale.com при каждом обновлении. Например, заметки к Update 7 полностью переименовали несколько ключей конфигурации.

ПРЕДУПРЕЖДЕНИЕ - Прочтите патчноуты перед обновлением рабочего сервера. Hytale выпускает еженедельные пре-релизные патчи, которые объединяются в стабильные релизы каждые несколько недель, и ключи конфигурации между ними переименовывались и удалялись. Незамеченное переименование означает, что настройка молча сбрасывается на значение по умолчанию.

Добавление в Server Discovery

Server Discovery — это внутриигровой браузер серверов, выпущенный вместе с Update 5 в мае 2026 года. Листинг бесплатен, а процесс полностью задокументирован.

1. Войдите в Account Manager и откройте страницу Server Profiles.
2. Нажмите Create server.
3. Заполните данные:
   • Название и описание. Именно по ним игроки судят о вашем сервере, так что укажите, что он на самом деле собой представляет.
   • Тип сервера: Survival, Adventure/RPG, Creative, PvP, Minigames, Roleplay, Social, Sandbox или Other.
   • Тег аудитории: Everyone, Teen или Mature.
   • Обслуживаемые регионы, из десяти вариантов по NA, Южной Америке, ЕС, Ближнему Востоку, Азии и Океании.
   • Верификация домена через TXT-запись DNS, чтобы игроки знали, что листинг действительно ваш.
4. Отправьте заявку и дождитесь модерации. Модератор проверяет точность данных, и статус на карточке листинга обновляется по мере прохождения проверки.
5. После одобрения настройте сервер на отправку heartbeat-сигналов с использованием токена discovery с карточки листинга.

Листинги рассматриваются в порядке поступления. Студия также вручную отбирает рекомендуемые серверы, чтобы выделить их для сообщества.

Heartbeat-сигналы

Ваш сервер подтверждает свою активность, отправляя heartbeat-сигналы с использованием токена discovery с карточки листинга. Генерация этого токена — простая команда, которую вы выполняете как OP, в консоли или в чате, чтобы завершить связку.

Если ваш сервер перестаёт отправлять heartbeat-сигналы более чем на две минуты, он скрывается из листингов до тех пор, пока не вернётся. Это разумное решение: нестабильный сервер тихо исчезает из Discovery, вместо того чтобы разочаровывать игроков, пытающихся к нему подключиться.

ПРИМЕЧАНИЕ - Первая версия Discovery намеренно минималистична. Листинги содержат название, описание и теги, без собственных иконок, баннеров или богатого медиаконтента. Также нет отображения количества игроков онлайн или рейтинга — студия намеренно это придержала, чтобы серверы не могли подделывать или манипулировать этими показателями.

Политики операторов серверов

Hypixel Studios публикуют Политики операторов серверов, которые распространяются на любого, кто хостит сервер Hytale, а не только на тех, кто попадает в листинг. Их стоит прочитать внимательно, если вы планируете запускать что-то публичное. Основные моменты:

• Базовые правила распространяются на каждого оператора. Серверы в листинге Discovery берут на себя дополнительные обязательства сверх этого.
• Серверам из листинга требуются проверенные данные оператора, целевое время реакции на срочные сообщения о безопасности в 24 часа (там, где это разумно достижимо), минимальные технические и качественные требования, а также точная самооценка контента с родительским контролем.
• Запрещено на всех серверах: сексуальный контент, NFT, эксплуатационные блокчейн- или крипто-схемы и азартные игры на реальные деньги. Приём криптовалюты как способа оплаты разрешён.
• Серверы из листинга обязаны поддерживать официальную косметику, с ограниченными переопределениями темы, разрешёнными при условии раскрытия информации.

Монетизация и распределение доходов

Если вы берёте деньги за что-либо на своём сервере, этот раздел касается вас.

• Монетизация должна быть честной и законной. Серверы All Ages могут размещать только семейную (family-safe) рекламу. Серверы Teen, Mature и Adult обязаны раскрывать покупки, влияющие на игровой процесс.
• Платные случайные предметы требуют публикации числовых шансов, раскрытия «ожидаемой стоимости» и ведения записей в течение двенадцати месяцев. Двойные случайные покупки полностью запрещены.
• Отчисления с дохода применяются ко всем монетизирующим серверам, но составляют 0% в первые два года, до 13 января 2028 года.

Последний пункт — это реальный дедлайн, который стоит внести в календарь, если вы строите что-то коммерческое.

ПРИМЕЧАНИЕ - Если эти политики противоречат Hytale EULA или Условиям использования, то EULA и Условия использования имеют приоритет, за исключением случаев, когда политики явно обозначены как Дополнительные условия для листинговых серверов.

Переадресация портов

Hytale не опубликовали порт сервера по умолчанию в своей публичной документации, поэтому проверяйте конфигурацию собственного сервера, а не доверяйте числу, которое где-то прочитали.

Общая схема такая же, как и для любого игрового сервера:

1. Найдите порт, к которому привязан ваш сервер, из его конфигурации или вывода при запуске.
2. Перенаправьте его на роутере на внутренний IP машины сервера.
3. Разрешите его в файрволе ОС.

# Debian/Ubuntu with ufw, substituting your actual port
sudo ufw allow <port>/tcp

# Fedora/RHEL with firewalld
sudo firewall-cmd --permanent --add-port=<port>/tcp
sudo firewall-cmd --reload

Верификация домена для Discovery использует TXT-запись DNS, а не что-либо сетевое, поэтому для этой части не нужно открывать порты.

Поддержание работы на Linux

Когда у вас есть рабочая команда запуска, оберните её так, чтобы она переживала разрывы соединения и перезагрузки.

Быстрый вариант с screen:

screen -S hytale ./start.sh

Отключитесь с помощью CTRL + A, затем D, повторно подключитесь с помощью screen -r hytale.

Правильный вариант, как systemd-юнит по адресу /etc/systemd/system/hytale.service:

[Unit]
Description=Hytale Dedicated Server
After=network.target

[Service]
Type=simple
User=hytale
WorkingDirectory=/home/hytale/server
ExecStart=/home/hytale/server/start.sh
Restart=on-failure
RestartSec=15
KillSignal=SIGINT
TimeoutStopSec=120

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now hytale

KillSignal=SIGINT и щедрый TimeoutStopSec дают серверу время сохранить мир при выключении, а не быть убитым посреди записи. Это важнее, чем кажется на первый взгляд.

Следите за логом с помощью journalctl -u hytale -f.

Резервное копирование

Hytale не заявляет о наличии автоматической системы резервного копирования, как это делает Valheim, так что считайте резервное копирование своей задачей.

Делайте резервную копию всей директории с данными сервера, включая миры и mods, по расписанию. Задача cron с rsync или tar на другой диск — вполне достаточно:

0 */6 * * * tar czf /backups/hytale-$(date +\%Y\%m\%d-\%H\%M).tar.gz /home/hytale/server/UserData

Две причины, специфичные для Hytale, почему это важнее обычного:

• Раннее раннее раннее... Раннего доступа. Обновления выходят еженедельно на предрелизном этапе, и что-то действительно ломается.
• Моды пишут в миры. Удаление мода, добавившего блоки или сущности, может оставить мир в плохом состоянии, точно так же, как в любой другой блоковой игре.

Делайте резервную копию перед каждым обновлением, а не только по расписанию.

Написание собственных плагинов

Если вы планируете серьёзно вести сервер, в итоге вы напишете что-то для него.

Плагины Hytale написаны на Java, и документация Server API генерируется из самого сервера, охватывая пакеты в com.hypixel.hytale. Справочник по ассетам документирует формат JSON каждого ассета, который загружает сервер, сгенерированный из собственных кодеков сервера.

Две вещи, о которых стоит знать в отношении выбранного направления:

• Текстовый скриптинг отсутствует и не появится. Студия утверждает, что скриптинг в стиле Lua — это ложный компромисс, из-за которого программисты жонглируют двумя языками, а дизайнеры всё равно учатся программировать.
• Вместо этого планируется визуальный скриптинг, в духе Unreal Blueprints, с возможностью для программистов расширять его, открывая новые ноды из Java. Инструмент Trigger Volume, выпущенный в Update 5, — это раннее воплощение данной идеи, и он был явно построен с поддержкой модов, чтобы моддеры могли добавлять собственные эффекты.

Устранение неполадок

Не могу найти загрузку выделенного сервера. Как было сказано выше, опубликованного руководства по настройке автономного сервера пока не существует. Проверьте accounts.hytale.com и спросите в официальном Discord.

Мой сервер не отображается в Discovery. Проверьте его статус на карточке листинга. Он может ещё находиться в очереди на модерацию, которая может идти медленно во время волны запусков. Если он был принят, а затем пропал, ваш сервер, вероятно, перестал отправлять heartbeats.

Игроки говорят, что им нужны моды, чтобы присоединиться. Это не так. Моддинг в Hytale работает на стороне сервера, и любой, кто говорит иначе, описывает другую игру.

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

Сервер не запускается после обновления. Проверьте версию Java, которую ожидает текущая сборка, и прочитайте патчноуты на предмет обратно несовместимых изменений. Если он начал происходить сразу после добавления плагина, удалите плагин и протестируйте снова.

Слишком старое ядро Linux. Hytale требует ядро 6.15 x64. Некоторые LTS-дистрибутивы поставляются со старыми версиями. Проверьте с помощью uname -r.

Могу ли я запустить сервер на macOS? Клиент работает только на Apple Silicon в macOS, а серверная сторона — наименее документированная часть этой и без того молодой игры. Виртуальная машина Linux или арендованный сервер — путь наименьшего сопротивления.

Заключение

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

Для группы друзей хостинг с клиента с помощью инвайт-кода — это действительно достаточно. Для чего-то постоянного и публичного полностью документированными на сегодняшний день частями являются Server Discovery и Server Operator Policies, и обе стоит внимательно прочитать перед запуском чего-либо. Настройка автономного сервера — это та часть, которая всё ещё ждёт официальной документации, и Discord — честный ответ на этот вопрос, пока она не появится.

Мы полностью перепишем этот раздел, когда Hypixel Studios опубликуют её.

См. также

• Hytale Documentation - Официальный хаб документации по запуску серверов и созданию модов.
• Hytale Server API reference - Java API для разработчиков плагинов.
• Asset reference - JSON-формат каждого ассета, загружаемого сервером.
• Server Operator Policies - Обязательно к прочтению всем, кто хостит публичные серверы.
• Hytale Account Manager - Где находятся Server Profiles и листинги Discovery.
• Official Server Lists announcement - Полный процесс Discovery, источник этого раздела.
• Hytale Modding Strategy and Status
• Official Hytale Discord
• Hytale Wiki
• TMC App - Наше собственное приложение с браузером серверов, живыми графиками задержки и RCON. Открытый исходный код под лицензией GPL-3.0, находится на очень ранней стадии разработки, так что попробовать его или оставить отзыв будет действительно полезно.

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

Присоединяйтесь к нашему Discord-серверу, если у вас есть вопросы или нужна помощь по серверам или моддингу!