📁 Файловая структура Hytale на ПК: где что лежит и как это использовать

  • Автор темы Автор темы Kweebec
  • Дата начала Дата начала
Когда только начинаешь разбираться в Hytale, игра кажется просто... игрой. Запустил, поиграл, закрыл. Но стоит залезть чуть глубже — и открывается целый мир файлов, папок и конфигов, которые можно (и нужно!) использовать в своих интересах. Хочешь переносить миры между компами? Ставить моды вручную? Делать бэкапы перед крупными обновлениями? Тогда эта статья для тебя.

Разбираемся, как устроена Hytale на диске — от папки с сохранениями до серверных логов.



🗂️ Содержание

  1. Где хранятся файлы игры
  2. Папка UserData — сердце твоего клиента
  3. Сохранения (Saves)
  4. Моды (Mods)
  5. Логи и кэш
  6. Структура папки установки лаунчера
  7. Серверные файлы
  8. Как переносить миры с компа на комп
  9. Как правильно делать бэкапы
  10. Шпаргалка по путям



1. Где вообще хранятся файлы игры

Hytale разделяет хранение файлов на два уровня:

  • Файлы установки — это сам движок, ресурсы, бинарники. Сюда ты не лезешь.
  • Пользовательские данные (UserData) — сохранения, моды, логи, конфиги. Вот это уже твоя территория.

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



2. Папка UserData — главная папка клиента

Это основная директория, с которой тебе придётся работать чаще всего.

Windows:
Код:
%appdata%\Hytale\UserData\
Полный путь:
Код:
C:\Users\ИМЯ_ПОЛЬЗОВАТЕЛЯ\AppData\Roaming\Hytale\UserData\

Linux:
Код:
~/.local/share/Hytale/UserData/

macOS:
Код:
~/Library/Application Support/Hytale/UserData/

💡 Быстрый доступ на Windows:
Нажми Win + R, введи %appdata%\Hytale\UserData и нажми Enter — папка откроется мгновенно, без ручного блуждания по дискам.

Внутри UserData ты найдёшь:

ПапкаЧто там
Saves\Все твои одиночные миры
Mods\Установленные клиентские моды
logs\Логи клиента (для отладки)



3. Сохранения (Saves)

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

Windows:
Код:
%appdata%\Hytale\UserData\Saves\

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

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



4. Моды (Mods)

Клиентские моды устанавливаются в отдельную папку внутри UserData.

Windows:
Код:
%appdata%\Hytale\UserData\Mods\

Linux:
Код:
~/.local/share/Hytale/UserData/Mods/

macOS:
Код:
~/Library/Application Support/Hytale/UserData/Mods/

Как это работает:
В одиночном режиме игра запускает локальный сервер на твоей машине. Клиент автоматически подгружает все моды из этой папки при старте. Всё просто: закинул файл мода — перезапустил игру — готово.

Интересный момент: внутри папки каждого сохранённого мира (в Saves) тоже есть своя подпапка Mods. Это значит, что теоретически можно включать разные моды для разных миров. Механика пока экспериментальная, но сам факт — занятный.

⚠️ Частая ошибка: Папка Mods создаётся только после первого запуска игры. Если ты её не видишь — просто запусти Hytale один раз, она появится.



5. Логи и кэш

Логи клиента (Windows):
Код:
%appdata%\Hytale\UserData\logs\

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

Кэш (серверный):
На сервере есть папка .cache/ — она хранит оптимизированные версии игровых данных. Трогать её не нужно. Если ты вдруг её удалишь (например, при отладке), ничего страшного — сервер пересоберёт кэш при следующем запуске, просто старт займёт чуть дольше обычного.



6. Папка установки лаунчера

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

Windows:
Код:
%appdata%\Hytale\install\release\package\game\latest

Linux:
Код:
$XDG_DATA_HOME/Hytale/install/release/package/game/latest

macOS:
Код:
~/Library/Application Support/Hytale/install/release/package/game/latest

Внутри этой папки ты найдёшь:
  • Client/ — файлы игрового клиента
  • Server/ — файлы сервера (HytaleServer.jar, конфиги)
  • Assets.zip — игровые ресурсы (текстуры, звуки, модели)

Если хочешь запустить локальный сервер — тебе нужны именно папка Server/ и файл Assets.zip.



7. Серверные файлы

Если ты играешь на сервере или сам его держишь, структура немного другая. Все данные хранятся в корневой директории сервера.

Структура серверной папки:
Код:
/server-root/
├── HytaleServer.jar       ← сам движок сервера
├── HytaleServer.aot       ← оптимизированная сборка
├── Assets.zip             ← игровые ресурсы
├── config.json            ← основной конфиг сервера
├── permissions.json       ← права и ранги
├── whitelist.json         ← белый список игроков
├── bans.json              ← забаненные
├── mods/                  ← серверные моды
├── universe/              ← все миры и данные игроков
│   ├── worlds/
│   │   ├── world1/
│   │   │   └── config.json
│   │   └── world2/
│   └── players/           ← данные каждого игрока
├── logs/                  ← серверные логи
└── .cache/                ← кэш (не трогать)

Файл / ПапкаНазначение
config.jsonОсновные настройки сервера (порт, имя, режим и т.д.)
permissions.jsonРанги, права операторов и групп
whitelist.jsonСписок игроков, допущенных на сервер
bans.jsonСписок заблокированных игроков
mods/Серверные моды (загружаются автоматически при старте)
universe/worlds/Данные каждого мира на сервере
universe/players/Инвентарь, позиция, прогресс каждого игрока

⚠️ Важно: Конфигурационные файлы читаются только при запуске сервера. Не редактируй их на ходу — изменения могут быть перезаписаны или вовсе проигнорированы.



8. Как переносить миры с компа на комп

Это одна из самых частых задач — и она проще, чем кажется. Hytale не использует облачные сохранения, поэтому всё делается вручную.

Пошаговая инструкция:

  1. На старом компе: Полностью закрой Hytale.
  2. Открой папку с сохранениями:
    Код:
    %appdata%\Hytale\UserData\Saves\
  3. Найди нужный мир — это папка с именем твоего мира.
  4. Скопируй всю папку целиком на флешку, в облако (Google Drive, Яндекс Диск) или передай через мессенджер.
  5. На новом компе: Установи Hytale и запусти его хотя бы один раз, чтобы создалась структура папок.
  6. Закрой игру, открой ту же папку Saves и вставь скопированную папку мира.
  7. Запусти игру — мир появится в списке.

💡 Совет по переносу модов:
Если ты играл с модами — не забудь перенести и папку Mods\ тем же способом. Без неё мир может не открыться или работать некорректно.

Частая ловушка: не клади папку мира в папку с таким же именем. То есть структура должна быть:
Код:
Saves\МойМир\[файлы мира]
а не
Код:
Saves\МойМир\МойМир\[файлы мира]
Если вложить папку дважды — игра просто не увидит мир.



9. Как правильно делать бэкапы

Hytale — Early Access. Это значит, что обновления могут прийти в любой момент, и лучше подстраховаться заранее.

Минимальный бэкап (одиночка):
  1. Закрой игру.
  2. Зайди в
    Код:
    %appdata%\Hytale\UserData\
  3. Скопируй папки Saves\ и Mods\ в безопасное место.

Полный бэкап (свой сервер):
  1. Останови сервер. Никогда не копируй файлы, пока сервер работает — получишь битый бэкап.
  2. Скопируй папку universe/ полностью.
  3. Дополнительно скопируй: config.json, permissions.json, whitelist.json, bans.json, mods/.

💡 Лайфхак: Заархивируй бэкап в ZIP с датой в названии — например, hytale_backup_2026-04-11.zip. Так ты всегда найдёшь нужную версию.

Что делать, если сервер после восстановления запускает новый мир:
Скорее всего, нарушена вложенность папок. Проверь, что внутри universe/ сразу идут данные, а не ещё одна папка universe/. Если так и есть — просто подними содержимое на уровень выше.

Что делать, если сервер падает после восстановления:
Почти всегда виноват несоответствие модов. Если мир создавался с модами, эти же моды должны быть в папке mods/ при восстановлении.



🗒️ Шпаргалка: все пути в одном месте

ЧтоWindowsLinux
Сохранения
Код:
%appdata%\Hytale\UserData\Saves\
Код:
~/.local/share/Hytale/UserData/Saves/
Моды (клиент)
Код:
%appdata%\Hytale\UserData\Mods\
Код:
~/.local/share/Hytale/UserData/Mods/
Логи
Код:
%appdata%\Hytale\UserData\logs\
Код:
~/.local/share/Hytale/UserData/logs/
Файлы установки
Код:
%appdata%\Hytale\install\...\latest
Код:
$XDG_DATA_HOME/Hytale/install/.../latest
Миры сервераuniverse/worlds/universe/worlds/
Данные игроковuniverse/players/universe/players/
Моды (сервер)mods/mods/



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

Следи за новостями и гайдами на HubTale — мы продолжаем разбирать Hytale по косточкам.


© HubTale — русскоязычное сообщество Hytale · hubtale.org
 
Назад
Верх