Руководство по скачиванию и установке модов в Hytale на Windows, Linux и macOS.
Моддинг Hytale работает иначе, чем практически в любой другой игре, для которой мы пишем эти руководства, и в этом различии стоит разобраться, прежде чем вы что-либо скачаете. Hypixel Studios построили Hytale по принципу server-side first (в первую очередь на стороне сервера). Моды устанавливает тот, кто хостит мир, а не каждый игрок по отдельности, и студия прямо заявила, что не намерена поддерживать клиентские моды вообще.
Звучит ограничивающе, пока не поймёшь, что это даёт: вы можете зайти на любой моддированный сервер Hytale, ничего не устанавливая. Никаких клиентских паков, никакой возни с версиями, никаких профилей лаунчера.
В качестве примера мы возьмём BetterMap — серверный плагин, который добавляет игровой карте постоянное исследование, метки и рендеринг пещер.
Требования
- ПК под управлением Windows, Linux или macOS. У Hytale есть нативные сборки для всех трёх систем.
- Копия Hytale, купленная через hytale.com. Игра находится в раннем доступе и отсутствует в Steam.
- Достаточно свободного места под то, что вы устанавливаете. Asset-паки с большим количеством моделей и текстур могут быть довольно объёмными; плагины обычно небольшие.
- Архиватор для
.zip, хотя во многих случаях распаковывать вообще ничего не придётся.
ПРИМЕЧАНИЕ - Hytale находится в раннем доступе с января 2026 года и всё ещё быстро развивается. Hypixel Studios открыто и самокритично говорят о состоянии инструментов моддинга, отмечая пробелы в документации и то, что некоторые системы всё ещё сыроваты. Ожидайте изменений и того, что мод время от времени будет ломаться после обновления.
Моддинг на стороне сервера: как это устроено
Hypixel Studios изложили несколько принципов, публикуя свою стратегию моддинга, и два из них определяют всё содержание этого руководства:
- Server-side first. Весь моддинг Hytale основан на хосте сервера или хосте игры. Вы должны иметь возможность зайти на любой моддированный сервер Hytale, не скачивая внешние моды и не переключая клиентские паки.
- Одно сообщество, один клиент. Они хотят избежать экосистемы, в которой каждому серверу нужен собственный моддированный клиент, поэтому клиент остаётся стабильным и единообразным, а разнообразие обеспечивают серверы.
На практике это означает, что мод устанавливается один раз, хостом, и каждый подключающийся игрок получает моддированный опыт при полностью ванильном клиенте.
Одиночная игра — это тоже сервер
Вот момент, из-за которого всё остальное встаёт на свои места.
В Hytale нет отдельного режима одиночной игры в традиционном понимании. Когда вы создаёте одиночный мир, вы фактически подключаетесь к локальному серверу, предназначенному только для вас. Так что «хост» — это вы, и установка модов для одиночной игры — та же операция, что и установка их на сервер, только в другую папку.
Затем вы выбираете, какие моды нужны, для каждого сохранения отдельно, и это действительно удобная модель: один мир с глобальным изменением, другой ванильный, без переключения профилей.
Подключение к чужому моддированному серверу
Вы ничего не устанавливаете. Просто подключаетесь к серверу и играете.
Плагины и asset-паки хоста определяют весь игровой опыт, а ваш клиент отображает то, что говорит ему сервер. Именно поэтому встроенный в игру браузер серверов может проверять совместимость и показывать вам только те серверы, к которым вы действительно можете подключиться.
Четыре вида модов Hytale
Моддинг Hytale делится на четыре технические категории, и понимание того, с какой из них вы имеете дело, подсказывает, чего ожидать.
| Вид | Формат | Что делает |
|---|---|---|
| Серверные плагины | Java .jar |
Программно расширяют сервер. Мини-игры, экономика, команды, кастомная логика. Самая мощная категория. |
| Data assets | JSON | Определяют базовый контент: блоки, предметы, NPC, генерацию мира, лут и таблицы дропа. |
| Art assets | Модели, текстуры, звуки | Внешний вид и звучание всего. Hytale поддерживает Blockbench для моделей и анимаций. |
| Файлы сохранений | Миры и префабы | Целые миры или готовые структуры, используемые в творческих инструментах и генерации мира. |
Asset Packs — это формат упаковки для двух средних категорий. Asset pack — это zip-архив или папка с manifest.json внутри, содержащая набор ресурсов, которые переопределяют или дополняют базовую игру. Их можно создавать во встроенном в игру Asset Editor или вручную в файловом менеджере, хотя студия рекомендует именно редактор, поскольку структура папок весьма строгая.
BetterMap — это серверный плагин, так что он относится к первой категории.
ПРИМЕЧАНИЕ - В Hytale нет Lua или другого текстового скриптинга, и студия заявила, что его не будет. Их план — визуальный скриптинг в духе Unreal Blueprints, наряду с Java для программистов.
Куда устанавливаются моды
Важны две локации.
Глобальная папка модов, используемая для всего:
C:\Users\<user>\AppData\Roaming\Hytale\UserData\Mods
Папка модов для конкретного мира, которая есть у каждого сохранения:
C:\Users\<user>\AppData\Roaming\Hytale\UserData\Saves\<World Name>\mods
На Linux и macOS папка UserData находится в эквивалентном расположении для пользовательских данных вашей системы, со схожей структурой внутри.
Всё, что находится в глобальной папке Mods, доступно для любого мира. Всё, что находится в собственной папке mods мира, принадлежит только этому миру.
СОВЕТ - На Windows вставьте %appdata%\Hytale\UserData в адресную строку Проводника, чтобы сразу перейти туда.
Установка мода для одиночной игры
- Перейдите в раздел Hytale на CurseForge и найдите мод. Для этого руководства откройте BetterMap.
- Скачайте его.
- Откройте папку
UserData\Mods. - Поместите скачанный файл туда. Пак ассетов можно оставить в виде zip-архива или распаковать в папку; плагины добавляются как файл
.jar. - Запустите Hytale.
- Откройте меню New World и найдите раздел Options. Там появятся установленные моды и паки ассетов.
- Включите нужные для этого мира и создайте его.
Последний шаг — тот, который чаще всего упускают. Помещение мода в папку делает его доступным; но выбирать его для конкретного мира всё равно нужно при создании мира.
CurseForge — основная площадка, что неудивительно, учитывая, что Hypixel Studios провели с ними конкурс модов New Worlds Modding Contest с призовым фондом $100,000. К началу 2026 года на платформе было более 5,000 модов для Hytale, суммарно набравших свыше 20 миллионов скачиваний.
Установка мода на выделенном сервере
Для сервера, который вы запускаете для других игроков, принцип тот же самый, только папка — это папка самого сервера.
- Скачайте мод.
- Поместите его в папку
modsсервера. - Перезапустите сервер.
BetterMap хранит там всё необходимое, создавая при первом запуске папку mods/bettermap/ для своей конфигурации и данных.
Игрокам, подключающимся к вашему серверу, ничего устанавливать не нужно. В этом и заключается весь смысл модели.
Если вы только настраиваете сервер, наше отдельное руководство по установке сервера Hytale поможет с этим.
Установка через TMC App
Поскольку менеджера модов для Hytale пока не существует, об этом стоит упомянуть. TMC App — это наш собственный менеджер модов и браузер серверов, с установкой в один клик и песочницами (sandboxes): именованными профилями модов для каждой игры, у каждого из которых свой порядок загрузки и метод развёртывания, переключаемыми без повторного скачивания чего-либо.
Hytale пока нет в списке поддерживаемых игр, но она хорошо подходит для этого. Приложение работает, зная, куда устанавливаются моды игры и как она запускается, а это всего лишь четыре JSON-файла, а не код, и папка Hytale UserData\Mods без какого-либо загрузчика — это одна из самых простых целей, с которыми может работать эта система. Песочницы также хорошо ложились бы на посуточный выбор модов для каждого мира в Hytale.
Честная позиция такова: приложение находится на очень ранней стадии разработки. В его README сказано, что оно протестировано частично, и мы не будем это приукрашивать. Сама Hytale находится в раннем доступе и обновляется еженедельно, так что это две молодые вещи, направленные друг на друга. Если вы готовы к этому, попробовать и рассказать о результатах — действительно полезно.
Это проект с открытым исходным кодом под лицензией GPL-3.0, доступный на github.com/modcommunity/tmc-app. Сообщения об ошибках и запросы функций отправляются в issue tracker, pull request'ы приветствуются, а в репозитории описан формат для каждой игры, если вы хотите добавить поддержку Hytale раньше, чем это сделаем мы.
Установка:
- Linux: одна строка, без root и без пакетного менеджера.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows:
setup.exeилиsetup.msiсо страницы релизов. Есть также портативная сборка, но она не регистрирует запись в лаунчере и обработчик ссылокtmc://. - macOS:
.dmgс той же страницы релизов.
Настройка модов
Единого стандарта нет, но обычно используется JSON-конфиг внутри собственной папки мода под mods.
BetterMap — хороший пример. Его настройки находятся в mods/bettermap/config.json, и он предоставляет такие параметры, как радиус исследования, качество карты, частота обновления и то, делится ли исследование между игроками:
{
"explorationRadius": 16,
"updateRateMs": 500,
"mapQuality": "MEDIUM",
"shareAllExploration": false,
"radarEnabled": true
}
Хорошо сделанные плагины также добавляют команды администратора и права. BetterMap регистрирует команды /bm, включая /bm reload, чтобы подхватить изменения конфигурации без перезапуска, хотя отмечается, что некоторым настройкам всё равно нужен полный перезапуск.
Читайте описание мода на CurseForge. Учитывая, насколько молодой ещё моддинг Hytale, эта страница очень часто является единственной документацией.
Моды для конкретного мира
Паки ассетов, созданные в игре с помощью Asset Editor, попадают в собственную папку mods этого мира, а не в глобальную. Это удобно, пока вы что-то создаёте, и сбивает с толку в первый раз, когда вы запускаете второй мир и удивляетесь, куда делся ваш пак.
Чтобы использовать пак, созданный в одном мире, в другом мире, скопируйте его из:
UserData\Saves\<World Name>\mods
в:
UserData\Mods
Как только он окажется в глобальной папке, он появится в опциях для каждого нового мира.
Платформы
Hytale вышла в ранний доступ на Windows, macOS и Linux, и это полный список. Нет ни консольной, ни мобильной версии, и игры нет в Steam.
Кроссплатформенная игра между этими тремя десктопными платформами присутствует, и более широкая кроссплатформенная поддержка была частью плана с момента повторного приобретения игры, но сегодня для установки модов нет ничего, кроме десктопа.
Обновление и удаление модов
Менеджера модов для Hytale пока нет, так что обе операции выполняются вручную.
- Обновление: скачайте новую версию с CurseForge и замените старый файл в
Mods. Проверьте страницу мода на предмет того, сохранится ли ваша конфигурация. - Удаление: удалите файл из
Mods, либо просто снимите галочку с мода для конкретного мира. - Отключение только для одного мира: оставьте файл на месте и снимите галочку в опциях этого мира.
ПРЕДУПРЕЖДЕНИЕ - Удаление мода, добавившего блоки, предметы или существ, из мира, в котором они использовались, может привести мир в нерабочее состояние, как и в любой другой игре про блоки. Сделайте резервную копию папки сохранения перед тем, как убирать моды из уже существующего мира.
Устранение неполадок
Мой мод не отображается в опциях New World. Неправильная папка. Он должен находиться в UserData\Mods или в собственной папке mods этого мира, а пак ассетов должен иметь корректный manifest.json.
Я установил мод, но мир, в котором я уже нахожусь, не изменился. Моды выбираются при создании мира. Существующие миры не подхватывают вновь установленные моды самостоятельно.
Пак, созданный мной в игре, отсутствует в другом моём мире. Паки Asset Editor сохраняются в тот мир, в котором они были созданы. Скопируйте его в глобальную папку Mods.
Плагин загружается, но его команды ничего не делают. Проверьте права доступа. Плагины Hytale используют permission-ноды, и командам, как правило, нужен OP или явно выданное разрешение.
После обновления Hytale всё сломалось. На этом этапе это ожидаемо. Hytale выпускает еженедельные пре-релизные патчи, которые объединяются в стабильные релизы каждые несколько недель, и модам нужно время, чтобы догнать изменения.
Игроки говорят, что им нужно установить мод, чтобы подключиться. Это не так. Если кто-то говорит вам иначе, он описывает то, как работает другая игра.
Можно ли использовать клиентские моды? Нет. Поддержки клиентских модов не существует, и студия заявила, что таких планов нет.
Заключение
Моддинг Hytale сводится к одной идее: хост устанавливает моды, все остальные просто играют. Положите файл в UserData\Mods, включите его при создании мира — и всё готово. Для выделенного сервера это тот же файл, только в собственной папке mods сервера.
Это по-настоящему иная модель по сравнению с настройками BepInEx и загрузчиков модов из наших других гайдов, и, когда её поймёшь, работать становится значительно проще. Инструментарий пока молодой, а документация местами скудная — сама Hypixel Studios это признаёт, — так что опирайтесь на описания модов и docs.hytale.com, пока всё не устоится.
Если хотите помочь с чем-то, TMC App — open source проект, находящийся на очень раннем этапе разработки, и любой фидбэк по нему будет по-настоящему ценен.
Смотрите также
- Hytale на CurseForge
- Документация Hytale - Официальная документация по запуску серверов и созданию модов.
- Создание контента в Hytale - Asset-паки, генерация мира и редакторы.
- Стратегия и статус моддинга Hytale - Собственный рассказ студии о том, как обстоят дела с моддингом и куда всё движется. Стоит прочитать полностью.
- Официальный Discord Hytale
- Вики Hytale
- TMC App
Hytale находится в раннем доступе и быстро меняется, так что этот гайд будет устаревать быстрее большинства других. Если вы обнаружите инструкцию, которая больше не соответствует тому, что вы видите, пожалуйста, сообщите об этом или откройте pull request в GitHub-репозитории этого гайда.
Присоединяйтесь к нашему Discord-серверу, если у вас есть вопросы или нужна помощь по любым темам, связанным с моддингом!