Hearth v1.9.0 — лаунчер на рабочем столе

Hearth 1.9.0 — лаунчер на рабочем столе

Hearth Launcher 1.1.0 теперь устанавливается как обычное приложение: со своей иконкой и ярлыками на рабочем столе и в меню приложений. При открытии лаунчера и выборе папки игры состояние сервера и клиентская сборка проверяются автоматически.

Для игроков

• Автоматическая проверка. Версии, режим и состояние сервера появляются после открытия. Выбор другого сервера, сайта или папки Valheim запускает новую проверку; устаревшие ответы не подменяют текущий выбор.
• Понятное состояние сборки. Лаунчер сообщает, когда нужно выбрать папку, подготовить моды, обновить или исправить файлы. Отдельно показывает готовую сборку, ванильный режим и ошибку проверки. Контрольные суммы управляемых файлов сверяются с локальным списком установки; настройки модов сохраняются.
• Установка для Windows и Linux / Steam Proton. Новые автономные установщики содержат лаунчер и иконку, устанавливают его для текущего пользователя без прав администратора и создают ярлыки. Отдельно устанавливать .NET или Python не нужно. Повторная установка обновляет приложение; удаление сохраняет профили, Steam, игру и моды.
• Подготовка и запуск через «Играть». Проверка при открытии не скачивает архивы модов и не меняет файлы игры. Нужные моды устанавливаются или исправляются после нажатия «Играть», с резервной копией и проверкой сервера перед запуском через Steam.
• Обновлённый лендинг RU / EN. Основные загрузки теперь ведут на установщики лаунчера. Портативные версии доступны отдельно; инструкции, переводы и скриншоты обновлены. Старые ссылки на установщики модов остаются совместимыми, но больше не предлагаются на лендинге.

Как установить

Windows x64: скачайте Hearth-Launcher-Setup.exe, откройте его и нажмите «Установить». После установки запускайте Hearth Launcher с рабочего стола.

Linux x64: скачайте Hearth-Launcher-Install-Linux.sh и выполните от своего пользователя, без sudo:

bash Hearth-Launcher-Install-Linux.sh

Затем откройте ярлык Hearth Launcher. Если рабочий стол попросит разрешить запуск ярлыка, подтвердите его. Для модов включите Proton в свойствах Valheim и один раз добавьте в параметры запуска Steam, сохранив свои параметры и один %command%:

WINEDLLOVERRIDES="winhttp=n,b" %command%

Добавьте HTTPS-сайт своего сервера Hearth, выберите папку Valheim и нажмите «Играть». Саму игру обновляет Steam; локальная версия игры пока не определяется. Персонаж и пароль выбираются в Valheim. Windows EXE пока без подписи издателя.

Инструкция RU · English guide

Обновление панели

Замените файлы проекта в прежнем каталоге, сохранив используемые Compose-файлы, имя проекта и том данных. Затем:

docker compose up -d --build

Для второй копии из комплектной конфигурации:

docker compose -f compose.second.yaml -p valheim-second up -d --build

Пересоздание контейнера перезапустит игру. Не используйте docker compose down -v: он удаляет том с миром и настройками. Игровой сервер, V+ и Hearth Admin автоматически этим релизом не обновляются.

Проверки и файлы

Автоматические проверки охватывают состояние сборки, отмену и устаревшие ответы, RU / EN, установку и откат Windows, реальные ярлыки Windows в тестовых папках и настоящую установку Linux без сети. Проверены повторная установка, удаление с сохранением профилей, повреждённый архив и чужие ярлыки. Владелец проекта подтвердил визуальную проверку и одобрил выпуск. Эти проверки не запускают Steam или Valheim.

В релизе восемь файлов: установщики лаунчера Windows / Linux, портативный EXE и ZIP Windows, портативный TAR.GZ Linux, Hearth-Admin-0.4.0.zip, архив проекта и SHA256SUMS.txt. Версия панели — 1.9.0, лаунчера — 1.1.0, Hearth Admin — 0.4.0. Проверенные бинарники лаунчера сохранены без пересборки; архив проекта сверен с Git, загрузки — с размером и SHA-256.

English

Hearth 1.9.0 includes Hearth Launcher 1.1.0 with desktop installation and automatic collection checks. Opening the launcher or changing the selected server/game directory refreshes server information and checks the local managed mod collection. The interface distinguishes missing directory, setup, update/repair, ready, vanilla and failed states. Late responses cannot overwrite the current selection.

The new offline Windows x64 and Linux x64 installers include the launcher and icon, install for the current user without administrator privileges, and create desktop and application-menu shortcuts. Reinstall to update; uninstall preserves profiles, Steam, game files and mods. No separately installed .NET or Python is required. Portable builds remain available.

Startup checks read server metadata and local file checksums without downloading archives or changing game files. Play installs/repairs the required collection with backups, then sends the launch and connection address to Steam. Steam updates the game; its local version remains unknown. Character selection and passwords stay in Valheim. Windows binaries are unsigned.

On Linux, run bash Hearth-Launcher-Install-Linux.sh as your desktop user, without sudo, then open the shortcut. Enable Proton for Valheim and configure WINEDLLOVERRIDES="winhttp=n,b" %command% once for mods, preserving existing launch options. The RU/EN landing, documentation and launcher screenshots now use this installation flow.

To update the panel, replace project files in the existing deployment directory, retain your Compose configuration, project name and data volume, then run docker compose up -d --build. Do not run docker compose down -v. The game server, V+ and Hearth Admin are not automatically updated by this panel release.

Windows/Linux checks and isolated installer/shortcut tests passed. The maintainer confirmed visual review and approved publication. All eight release assets are verified against sizes and SHA-256 digests.

Руководство администратора RU · English admin guide · Все изменения / Full changelog

Hearth v1.8.0 — в мир одной кнопкой

Hearth 1.8.0 — в мир одной кнопкой

У Hearth появился лаунчер для Windows и Linux / Steam Proton. Сохраните сайт своего сервера, выберите Valheim и нажмите «Играть» — лаунчер проверит моды, при необходимости обновит их и запустит игру через Steam.

Что нового

• Hearth Launcher 1.0.0. Автономные сборки для Windows x64 и Linux x64, обычный Steam и Steam Flatpak. Отдельно устанавливать .NET или Python для лаунчера не нужно.
• Одна кнопка для подготовки и запуска. Проверка и синхронизация выполняются через «Играть». Целая сборка не скачивается повторно; повреждённые файлы восстанавливаются из проверенного кеша. При новой сборке скачивается её ZIP, затем заменяются отличающиеся файлы.
• Моды выбранного сервера. Поддерживаются Valheim Plus от Grantapher, сборки BepInEx и ванильные серверы. Версии берутся с сайта сервера. В ванильном режиме поддерживаемый Doorstop отключается только для текущего запуска, без удаления модов.
• Профили и простой выбор игры. Один список «Найдено в Steam», поиск и ручной выбор папки. Можно сохранять несколько серверов, копировать адрес, открывать сайт и сообщество. RU / EN переключается сразу.
• Резервная копия и восстановление. Замена файлов сопровождается копией; предусмотрены откат при ошибке и восстановление предыдущей установки. Конфиги и сторонние моды сохраняются. Конфликты известных копий V+ и регистра путей под Proton останавливают установку и запуск с объяснением.
• Скачивание с лендинга. Обе сборки и SHA-256 доступны на странице подключения; ссылки следуют настройкам сайта. Инструкции и скриншоты обновлены на русском и английском.

Саму игру обновляет Steam. Персонаж и пароль остаются в Valheim; лаунчер передаёт Steam адрес подключения. Профили одной папки игры разделяют конфиги. Windows EXE пока без подписи издателя.

Для Linux один раз включите Proton в свойствах Valheim и добавьте в параметры запуска, сохранив свои опции и один %command%:

WINEDLLOVERRIDES="winhttp=n,b" %command%

Инструкция для игроков RU · English launcher guide

Обновление панели

Замените файлы проекта в прежнем каталоге, сохранив используемые Compose-файлы, имя проекта и том данных. Затем:

docker compose up -d --build

Для второй копии из комплектной конфигурации:

docker compose -f compose.second.yaml -p valheim-second up -d --build

Пересоздание контейнера перезапустит игру. Не используйте docker compose down -v: он удаляет том с миром и настройками. Игровой сервер, V+ и Hearth Admin автоматически этим релизом не обновляются.

Проверки и файлы

Пройдены 136 автоматических сценариев Windows и 139 Linux, включая установку перед первым запуском «Играть», повторный запуск без скачивания, повреждённые архивы, конфликты и откат. Готовые сборки проверены; Linux-интерфейс отрисован без установленного .NET и без сети. Владелец проекта подтвердил ручную проверку текущего лаунчера и одобрил выпуск.

В релизе: архив проекта, EXE и ZIP лаунчера Windows, TAR.GZ лаунчера Linux, прежние установщики Windows / Linux, Hearth-Admin-0.4.0.zip и общий SHA256SUMS.txt. Версия панели — 1.8.0, лаунчера — 1.0.0, Hearth Admin — 0.4.0. Архив проекта сверен с Git; загруженные файлы проверяются по размеру и SHA-256.

English

Hearth 1.8.0 adds Hearth Launcher 1.0.0 for Windows x64 and Linux x64 / Steam Proton, including Steam Flatpak. Save your Hearth website, select Valheim and press Play. The launcher automatically verifies and synchronizes the server's client collection before sending the game launch and connection address to Steam.

Supported modes are Grantapher's Valheim Plus, custom BepInEx collections and vanilla servers. Verified archives are cached; an intact collection is not downloaded again. Changed files are backed up, configurations and unmanaged mods are retained, and rollback can restore the previous installation. Vanilla launches disable supported Doorstop loaders for that launch without deleting mods.

The interface has one Steam/manual game selector, saved server profiles, instant RU/EN switching and website/community links. Both launcher downloads and checksums appear on the server landing page. Steam updates Valheim itself; character selection and passwords remain in the game. Profiles sharing one game folder share configurations. Windows binaries are unsigned. Linux requires a one-time Proton setup with WINEDLLOVERRIDES="winhttp=n,b" %command%, preserving existing launch options.

Update the project files in your existing deployment directory, retain your Compose configuration, project name and data volume, then run docker compose up -d --build. Do not run docker compose down -v. The game server, V+ and Hearth Admin are not automatically updated by this panel release.

Automated Windows/Linux checks passed, and the project maintainer confirmed manual testing and approved the release. All eight release assets are checked against their sizes and SHA-256 digests.

Руководство администратора RU · English admin guide · Все изменения / Full changelog

Hearth v1.7.0 — Hexium и надёжная установка зависимостей

Hearth 1.7.0 — Hexium и установка зависимостей

Теперь в разделе Моды можно устанавливать пакеты из Hexium, Thunderstore и собственных ZIP-архивов. Спасибо @Tash1ro за поддержку Hexium и улучшение сравнения версий в PR #14.

Что изменилось

• Hexium в панели. Ссылка https://valheim.hexium.gg/mods/Author/Package выбирает Hexium. Для обычного идентификатора сначала проверяется Thunderstore; если пакета или выбранной версии там нет либо пакет устарел и есть действующая замена, панель проверяет Hexium. Установленный из Hexium пакет обновляется из Hexium. Загрузчик BepInEx по-прежнему берётся из Thunderstore.
• Минимальные версии зависимостей. Более новая установленная зависимость удовлетворяет более старому требованию и сохраняется. Если зависимость ещё не установлена, сначала ищется запрошенный выпуск, затем подходящий более новый. Jotunn и другие общие зависимости можно обновлять отдельно. Явно выбранный выпуск основного пакета и требования Valheim Plus остаются точными.
• Окончательный набор до скачивания. Панель сначала выбирает версии и строит граф зависимостей, а затем скачивает архивы. Зависимости промежуточного выпуска больше не попадают в набор; порядок обхода не создаёт ложных циклов. Настоящие циклы отклоняются до применения изменений.
• Сохранение действующей сборки. Ранее установленные пакеты и их необходимые области применения сохраняются. Недоступность необязательного Hexium не блокирует уже проверенный пакет Thunderstore; ошибки обязательного источника показываются пользователю.
• Документация RU / EN обновлена под выбор источников и минимальные версии.

После установки или обновления клиентских модов игрокам нужно закрыть игру и повторить установку сборки с лендинга своего сервера. Успешное разрешение зависимостей не подтверждает игровую совместимость сторонних DLL: выбирайте область установки по инструкции автора мода и проверяйте новую сборку на копии мира.

Обновление

Скачайте резервную копию и замените файлы проекта в прежнем каталоге. Сохраните свои Compose-файлы, имя проекта, параметры -p / -f и том данных. Затем выполните на Docker-хосте:

docker compose up -d --build

Для второй копии из комплектной конфигурации:

docker compose -f compose.second.yaml -p valheim-second up -d --build

Пересоздание контейнера перезапустит игру. Не используйте docker compose down -v: параметр -v удаляет том с миром и настройками.

Проверки и файлы

Прошли 70 проверок менеджера модов и HTTP-интеграции, включая 12 новых регрессионных сценариев, и 8 релизных проверок. Проверены переводы, JavaScript, оба Compose и документация. Три настоящих пакета Hexium установлены во временное хранилище; игровые DLL не запускались. Архив проекта сверен с Git, assets — по размеру и SHA-256.

В комплекте архив проекта, Hearth-Admin-0.4.0.zip, установщики Windows / Linux и SHA256SUMS.txt. Hearth Admin и установщики не менялись; изменения в выборе и установке пакетов находятся в панели.

English

Hearth 1.7.0 adds Hexium alongside Thunderstore and manual ZIP packages. Thanks to @Tash1ro for the contribution in PR #14.

Explicit Hexium links select that source. Package identifiers try Thunderstore first, then Hexium for missing releases or suitable live replacements of deprecated packages. Ordinary dependency versions are minimum requirements: newer installed versions are retained, and a missing requested release can be replaced by an available version that satisfies the minimum. Explicit root-package versions and V+ requirements remain exact.

The panel resolves the final dependency graph before downloading archives. Superseded dependencies are excluded, false cycles no longer depend on traversal order, and real cycles are rejected before application. Previously installed packages and their runtime scopes are preserved. A failed optional Hexium lookup does not invalidate a verified Thunderstore release.

Update the project files in the existing deployment directory, keep the same Compose files, project name and data volume, and run docker compose up -d --build. Do not run docker compose down -v. Players should rerun the landing page installer whenever the client mod collection changes. Third-party mod compatibility still requires testing in the game.

Руководство RU · English guide · Все изменения / Full changelog

Hearth v1.6.0 — игровые инструменты и Hearth Admin

Hearth 1.6.0 — игровые инструменты и Hearth Admin

Теперь управлять игровыми действиями можно из Hearth и прямо внутри Valheim. Встроенный Hearth Admin 0.4.0 устанавливается через раздел Моды, попадает в клиентскую сборку на лендинге и открывает меню F8 с мгновенным переключением RU / EN.

Что нового

• Встроенный мод в один шаг. Установка на сервер и включение в клиентский набор без поиска ZIP. Для ручной установки приложен отдельный Hearth-Admin-0.4.0.zip; исходники находятся в game-mods/ValheimAdminRu.
• Игровые инструменты в браузере. Выбор подключённого исполнителя по SteamID, телепорты и возврат, сохранённые точки, помощь игрокам, выдача предметов, создание существ и очистка созданного, изменение рельефа и отмена, полёт, режимы строительства и ремонта, роли и журнал действий.
• Полноценное меню F8. Каталоги предметов и существ с поиском, инструменты мира и строительства, модерация и история. Выбранный язык сохраняется на клиенте; язык игры менять не нужно.
• Раздельные права. Администратор Hearth запускает веб-команды через выбранного подключённого клиента. Это не выдаёт игроку доступ к F8. Игровые роли назначаются отдельно; права нативного администратора Valheim по-прежнему управляются в разделе Игроки.
• Связь с игрой без дополнительного порта. Закрытый файловый мост проверяет сессию мира и срок команды; панель показывает ответ мода и журнал. Для длительных действий ответ о начале ещё не означает завершение — итог отображается на клиенте.
• Обновлённые руководства RU / EN и скриншоты нового раздела.

Как включить

1. Обновите Hearth до 1.6.0.
2. В разделе Моды установите встроенный Hearth Admin 0.4.0.
3. Игрокам нужно закрыть игру и повторить установку клиентской сборки с лендинга своего сервера. Версия мода должна совпадать на сервере и всех клиентах.
4. После подключения откройте Игровые инструменты в Hearth или F8 в игре. Доступ к F8 определяется игровой ролью.

Нужен BepInEx 5.4 или Valheim Plus, выделенный сервер и Valheim 1.0.16 / 1.0.17. В ванильном режиме игровые инструменты недоступны. При переходе с ручной установки ValheimAdminRu удалите прежнюю копию DLL на сервере и клиентах, чтобы не загружались два экземпляра.

Роли и журнал мода сохраняются в полной игровой резервной копии. Экспорт отдельного мира не переносит дополнительные плагины и их данные; клиентские сохранённые точки остаются на клиенте. Сам мод не устанавливается автоматически при обновлении панели.

Обновление панели

Скачайте резервную копию и замените файлы проекта в прежнем каталоге. Сохраните свои Compose-файлы, имя проекта, параметры -p / -f и том данных. Затем на Docker-хосте выполните:

docker compose up -d --build

Для второй копии из комплектной конфигурации:

docker compose -f compose.second.yaml -p valheim-second up -d --build

Пересоздание контейнера перезапустит игру. Не используйте docker compose down -v: параметр -v удаляет том с миром и настройками.

Проверки и файлы

Сопровождающий проекта подтвердил проверку в игре перед выпуском. DLL 0.4.0 собрана по библиотекам Valheim 1.0.17 без ошибок и предупреждений. Для интеграции ранее прошли 247 серверных тестов, затем все 19 проверок игрового моста, а также 670 проверок переводов мода и 47 проверок файлового протокола. В релизном образе 1.6.0 прошли 8 точечных проверок, сверены версии и хеши, проверен чистый запуск мастера без установки игры. Также проверены оба Compose, переводы и ссылки документации; полный набор при выпуске не повторялся.

В релизе: архив проекта, отдельный ZIP Hearth Admin, установщики Windows и Linux / Proton, SHA256SUMS.txt. Установщики сохранены из 1.5.0: поддержка клиентских наборов уже включена. ZIP мода содержит собственную DLL и публичные метаданные; библиотеки игры и BepInEx в него не входят. Windows EXE пока без подписи издателя.

English recap

• Bundled Hearth Admin 0.4.0, installable from Mods and included in the server's client bundle.
• Browser game tools and an in-game F8 menu with instant, persistent RU / EN switching: teleports, player assistance, item/mob catalogs, terrain, building, roles and audit history.
• Web administrator access and in-game roles remain separate. The private bridge adds no network port and checks the world session and command expiry.
• Requires a dedicated server, BepInEx 5.4 or Valheim Plus, and Valheim 1.0.16 / 1.0.17. Server and all clients need the same mod version; vanilla mode is unsupported. Remove older manually installed copies before installing this package.
• The project maintainer confirmed in-game testing. Automated checks cover the integration, localization and file protocol; this is not a claim that every game/mod combination was tested.

Upgrade: back up, replace project files in the existing directory and run the matching Compose command above. Keep the same project name, options and data volume. Then install Hearth Admin from Mods and have players rerun the landing page's client installer. Updating the panel does not enable the mod automatically. Do not run docker compose down -v.

Руководство RU · English guide · Исходники мода / Mod source · Все изменения / Full changelog

Hearth v1.5.0 — моды, здоровье сервера и расписания

Hearth 1.5.0 — свой набор модов и удобное обслуживание

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

Что нового

Моды из Thunderstore и своих ZIP

• Новый режим BepInEx — свой набор модов: Valheim с BepInEx 5.4 без обязательного Valheim Plus. Ванильный режим и V+ от Grantapher остаются доступны.
• В разделе Моды можно установить пакет по ссылке Thunderstore или Author-Package, закрепить конкретную версию, загрузить ZIP, обновить, включить, отключить или удалить пакет.
• Точные зависимости разрешаются автоматически; несовместимые требования к версиям и удаление используемой зависимости отклоняются.
• Для каждого пакета выбирается область: только сервер, только клиенты или обе стороны. Требования к области определяет автор мода; панель не угадывает их.
• Набор хранится в томе Docker и применяется в собственной папке BepInEx/plugins/HearthMods. Загрузчик и Valheim Plus управляются панелью отдельно.

Поддерживаются плагины BepInEx 5.4: DLL и ресурсы, ZIP до 128 МиБ. Пакеты с отдельными patchers, собственным runtime или нативными компонентами этим менеджером не устанавливаются. Плагины выполняются игровым процессом — выбирайте доверенные источники.

Перед изменением работающего сервера создаётся копия мира, конфигурации и набора модов. При ошибке запуска панель пытается восстановить прежнее состояние; проверка запуска не гарантирует совместимость всех игровых механик.

Одинаковая клиентская сборка у игроков

• Лендинг показывает включённые клиентские пакеты и их точные версии.
• Обновлены установщики Windows и Linux / Steam Proton: они получают сборку с выбранного сервера, проверяют SHA-256 и сохраняют заменяемые файлы.
• Для V+ дополнительные плагины устанавливаются поверх официального WindowsClient нужной версии; для собственного набора скачиваются загрузчик и плагины вместе.
• Устаревшие неизменённые файлы, ранее установленные в HearthMods, убираются с резервной копией. Пользовательские изменения автоматически не удаляются.

После изменения клиентской сборки игрокам нужно скачать актуальный установщик с лендинга и повторить установку. Игру по-прежнему обновляет Steam. Для установщиков нужен HTTPS-адрес сервера на порту 443; Windows EXE пока без подписи издателя.

Здоровье сервера

Отдельный раздел показывает игровой процесс и свежий ответ A2S, CPU и RAM игры, память контейнера, свободный диск, время изменения сохранения и последнюю успешную резервную копию. При проблемах появляются пояснения и рекомендации. Неизвестные измерения не подменяются нулём; A2S не заменяет проверку подключения реальным клиентом.

Повторяющееся обслуживание

• До 20 ежедневных или еженедельных расписаний: перезапуск, остановка, копия или обновление игры/мода.
• Местное время, дни недели и часовой пояс IANA, например Asia/Krasnoyarsk; пауза, возобновление, редактирование и удаление расписаний.
• Ближайшие запуски на семь дней и история последних результатов.
• Задачи ждут свежего A2S и минуты без игроков. Окно ожидания — 2–1440 минут; по истечении запуск пропускается без принудительного отключения игроков.
• Пропущенные при выключенной панели запуски не наверстываются, прерванные операции автоматически не повторяются.

Копии из новых расписаний учитываются в лимите плановых копий. Прежний интервальный график продолжает работать независимо — отключите его, если перенесли всё копирование в новые расписания. Автоматического одобрения несовпадающих версий V+ нет.

Модерация и Discord

К существующему управлению по SteamID добавлены баны на срок с причиной, карточки с псевдонимами и заметками, история действий. Постоянные баны сохраняются; игровые права администратора остаются отдельными от доступа к веб-панели.

В Discord можно включить события модерации, включая снятие и истечение бана. В такие уведомления попадают SteamID, причина и срок; пароли и заметки модераторов не отправляются. Автоматического сопоставления SteamID с именами персонажей нет.

Документация

Новые README на RU / EN, обзор возможностей со скриншотами и подробные руководства администратора: настройка, перенос миров, копии, ограничения модов и установщиков, обновления и диагностика.

Копии и перенос мира

Новые полные игровые .tar.gz-копии включают saves/, config/, mods/ и manifest.json. При восстановлении старой копии без mods/ текущий набор дополнительных модов сохраняется.

Экспорт отдельного мира не переносит дополнительные плагины. Он сохраняет мир и правила, а для V+ — конфиг мода. Установите дополнительные пакеты на принимающем сервере отдельно либо используйте полную копию подходящего игрового релиза. Параметры входа в веб-панель, Discord и заметки модераторов в игровые копии не входят; для аварии всего хоста сохраняйте весь том отдельно.

Как обновиться

1. Создайте и скачайте резервную копию через текущую панель.
2. Замените файлы проекта из этого релиза в прежнем каталоге. Сохраните свой Compose-файл, имя проекта, том данных и параметры -p / -f.
3. Для основной копии выполните:

docker compose up -d --build

Для второй копии из комплектной конфигурации:

docker compose -f compose.second.yaml -p valheim-second up -d --build

Команды выполняются на Docker-хосте; панель не обновляет себя автоматически. Пересоздание контейнера перезапустит игру, но само обновление панели не устанавливает новую версию Valheim/V+. Не используйте docker compose down -v: -v удаляет том с миром и настройками.

Для перехода на собственный набор выберите режим BepInEx в Настройки → Сервер, сохраните его и выполните обновление игры через панель. Совместимость модов проверяйте по документации авторов и в игре. Автоматический откат — попытка восстановления, а не гарантия; храните внешние копии.

Проверки выпуска

Приложены архив проекта, обновлённые установщики Windows и Linux / Proton и SHA256SUMS.txt.

Перед выпуском собран Linux-образ с версией 1.5.0. Прошли 8 точечных проверок мастера, версии панели, публичного API и загрузок, клиентской сборки, модерации и диагностики; проверены переводы и оба файла Compose. Чистый контейнер отвечает на /health и показывает мастер без загрузки и запуска игры. Состав архива и контрольные суммы файлов сверены с релизным коммитом и загруженными assets GitHub.

Для слитых изменений ранее прошли 229 серверных тестов, 58 проверок Windows-установщика и 32 теста Linux / Proton; при выпуске полный набор повторно не запускался. Вход настоящими игровыми клиентами и живые уведомления Discord в рамках этого релиза не проверялись.

English recap

• New BepInEx 5.4 custom mod mode and a Thunderstore / ZIP manager with exact dependencies and server/client scopes. Packages requiring patchers or native runtimes are unsupported.
• Updated Windows and Linux/Proton installers fetch the server's matching client bundle and verify SHA-256. Players must download the current installer and rerun it after client-pack changes.
• Server health diagnostics, daily/weekly maintenance with IANA time zones, timed bans, player notes, moderation history and Discord moderation events.
• Recurring tasks wait for an empty server; an expired waiting window skips the run without kicking players. Missed runs are not replayed after downtime.
• Full game backups now include additional mods; individual world exports do not. Startup checks and rollback attempts cannot guarantee gameplay compatibility or recovery.
• Bilingual READMEs and administrator guides with screenshots.

Upgrade: download a backup, replace project files in the existing directory, then run the Compose command above using the same project name, -p / -f options and data volume. Rebuilding restarts the game; it does not automatically upgrade Valheim/V+. Do not run docker compose down -v.

Руководство RU · English guide · Все изменения с 1.4.0

Hearth v1.4.0 — управление игроками по SteamID

Управление игроками по SteamID64

В разделе «Игроки» добавлено управление доступом по точному идентификатору Steam:

• Бан и снятие бана.
• Выдача и снятие прав администратора игры.
• Запрос отключения игрока через временную блокировку.
• Отдельные списки администраторов, постоянных банов и временных блокировок.

Принимаются SteamID64 из 17 цифр и формат Steam_<SteamID64>. Баны и игровые права можно менять для отсутствующего игрока. Ники из статистики не используются для определения аккаунта. Подтверждения показывают точный SteamID; новые элементы и сообщения поддерживают мгновенное переключение RU / EN.

Как применяются изменения

Используются штатные adminlist.txt и bannedlist.txt, без дополнительного мода и перезапуска игры. Неизвестные записи, комментарии и permittedlist.txt сохраняются. SteamID и действия доступны только авторизованному администратору панели; на лендинг они не выводятся. Изменения записываются в журнал.

Игровая админка не открывает доступ к веб-панели. После выдачи или снятия игровых прав игроку нужно переподключиться.

Отключение реализовано через временный бан на 30 секунд. Valheim перечитывает списки периодически, поэтому отключение и последующий повторный вход происходят с задержкой. После истечения срока панель удаляет временную запись на очередной проверке, затем игра перечитывает список. Ответ панели подтверждает изменение списка, а не фактическое отключение конкретного клиента. При остановленном сервере запрос отключения недоступен.

Постоянные баны автоматически не снимаются. Действие «Заблокировать» для временно заблокированного SteamID превращает блокировку в постоянную. Временные записи переживают перезапуск панели и очищаются даже во время долгого обновления сервера. Перед полной резервной копией временные баны снимаются; при восстановлении архива со старой временной меткой запись очищается до запуска игры.

Обновление

1. Скачайте резервную копию из панели.
2. Распакуйте архив релиза и замените файлы проекта в прежнем каталоге.
3. Из этого каталога выполните команду с прежним именем проекта, файлами Compose и томом данных:

docker compose up -d --build

Для второй копии из инструкции:

docker compose -f compose.second.yaml -p valheim-second up -d --build

Сохраните свои параметры -p / -f. Пересоздание контейнера перезапустит игру и отключит игроков, поэтому выберите подходящее время. Не выполняйте docker compose down -v: эта команда удаляет том с игровыми данными.

Файлы и проверка

Приложены архив проекта, установщики Windows и Linux / Proton и SHA256SUMS.txt. Установщики не изменились относительно v1.3.0; контрольные суммы сверены.

Изменения прошли 151 тест в Linux-контейнере, включая 17 новых сценариев управления доступом, очистку во время занятой операции и восстановление старого архива с временной меткой. Проверены JavaScript, переводы, оба Compose-файла и действия в браузере. Поведение native-списков проверено по установленной официальной Valheim 1.0.16; отключение живого игрового клиента не проверялось.

Для выпуска изменена только версия с 1.4.0-dev на 1.4.0. Повторный полный прогон тестов не выполнялся. Релизная сборка Docker прошла; содержимое архива сверено с релизным коммитом.

Изменения: v1.3.0...v1.4.0

Hearth v1.3.0 — обслуживание, Discord и обновления панели

Новые возможности

Проверка обновлений панели

В разделе «Обновления» теперь видна версия панели. Кнопка проверяет последний стабильный релиз GitHub и показывает ссылку на описание и команду для основной или второй копии сервера.

Обновление выполняется администратором: сначала нужно заменить файлы проекта в прежнем каталоге, затем запустить предложенную команду с прежними параметрами Compose. Панель не получает доступ к Docker.

Обслуживание с учётом игроков

• Планирование перезапуска, остановки, резервной копии или обновления игры/мода на ближайшие 30 дней.
• По умолчанию — ожидание минуты без игроков по свежим A2S-ответам. Неизвестный онлайн не считается пустым сервером.
• Повторная проверка перед выполнением; при обновлении также после загрузки и проверки кандидата. Если на этой проверке появились игроки или онлайн неизвестен, операция отменяется до остановки работающего сервера.
• Ожидающую задачу можно отменить. Она сохраняется при перезапуске панели; уже начатые прерванные задачи автоматически не повторяются.
• Запланированное или текущее обслуживание отображается на лендинге.

Это проверка состояния сервера, без блокировки новых подключений и сообщений внутри игры. Одобрение несовпадающих версий Valheim и V+ остаётся ручным через обычное обновление.

Уведомления Discord

Webhook настраивается в разделе «Обслуживание». Можно выбрать события доступности сервера, обновлений и отката, резервных копий, обслуживания и ошибок, а также отправить проверочное сообщение.

Webhook не возвращается в API и не переносится с миром. Уведомления содержат краткое описание без паролей, имён игроков и игрового журнала; массовые упоминания отключены. Отправка выполняется в фоне, а ошибка Discord не прерывает игровую операцию. Автоматических повторов доставки пока нет.

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

Обновление

1. Скачайте резервную копию из панели.
2. Распакуйте архив релиза и замените файлы проекта в прежнем каталоге.
3. Из этого каталога выполните команду с прежним именем проекта, файлами Compose и томом данных:

docker compose up -d --build

Для второй копии из инструкции:

docker compose -f compose.second.yaml -p valheim-second up -d --build

Сохраните свои параметры -p / -f. Пересоздание контейнера перезапустит игру и отключит игроков, поэтому выберите подходящее время. Не выполняйте docker compose down -v: эта команда удаляет том с игровыми данными.

Файлы и проверка

Приложены архив проекта, установщики Windows и Linux / Proton и SHA256SUMS.txt. Установщики не изменились относительно v1.2.2; проверено совпадение контрольных сумм.

Перед слиянием прошли 134 теста в Linux-контейнере, проверки переводов и JavaScript, обоих файлов Compose и проверки интерфейса в браузере. Для релиза изменена только версия с 1.3.0-dev на 1.3.0; повторный полный прогон не выполнялся. Релизная сборка Docker прошла, содержимое архива сверено с коммитом. Реальная доставка Discord и работа обслуживания с подключёнными игровыми клиентами не проверялись.

Изменения: v1.2.2...v1.3.0

Loki v1.2.2

Исправлен перенос миров нового формата

Экспорт мог завершаться ошибкой «Для экспорта нужны непустые .db и .fwl выбранного мира», хотя сохранение существовало: миры нового формата находятся в отдельной папке с .db2, .fwl2, .chunks, .ok и .chunk.

• Экспорт теперь переносит все поддерживаемые файлы папки выбранного мира, его правила и конфиг Valheim Plus, если используется V+.
• Импорт заменяет папку целиком, без смешивания старых и новых чанков. Остатки другого формата того же мира удаляются после резервного копирования.
• Перед импортом создаётся pre-import копия. При ошибке записи панель возвращает прежние файлы мира, настройки и конфиг V+.
• Старые экспорты с парой .db / .fwl продолжают поддерживаться.
• Обновлены пояснения в панели на русском и английском и инструкция.

Совместимость

Обновите панель на обоих серверах до v1.2.2 или новее, чтобы переносить папки миров в новом архиве Hearth v2. На источнике и принимающем сервере должны совпадать установленные версии Valheim, режим и версия V+.

Старые архивы Hearth v1 поддерживаются. После импорта сервер остаётся остановленным: проверьте настройки и запустите его из панели. Лимиты: ZIP до 1 ГиБ, распакованные данные до 2 ГиБ, конфиг V+ до 2 МиБ, до 10 000 файлов в папке мира.

Обновление

Скачайте резервную копию, обновите файлы проекта в прежнем каталоге и выполните:

docker compose up -d --build

Сохраните прежнее имя проекта Compose, том данных и используемые -p / -f. Не выполняйте docker compose down -v: эта команда удаляет том с игровыми данными.

Файлы и проверка

Архив проекта, установщики Windows и Linux / Proton и SHA256SUMS.txt приложены. Установщики не изменились относительно v1.2.1.

Исправление ранее прошло 118 тестов на Windows и Linux, включая перенос нового формата с V+, сохранение старого формата, замену папки и откат при ошибках. Перед выпуском подтверждено совпадение исходников с проверенным коммитом, целостность ZIP и контрольные суммы установщиков. Полный набор тестов повторно не запускался. Проверка с настоящими файлами мира Loki и игровым клиентом не выполнялась.

Изменения: v1.2.1...v1.2.2

Loki v1.2.1

Что изменилось

Мастер первого запуска теперь доступен сразу по удалённому адресу и через reverse proxy. Ограничение на localhost и запрет заголовков Forwarded / X-Forwarded-* удалены; SSH-туннель больше не требуется.

• Основная копия: http://IP_СЕРВЕРА:8080 или домен с настроенным прокси.
• Вторая копия: http://IP_СЕРВЕРА:8081 или её домен.
• Compose публикует веб-порты 8080 / 8081 на всех интерфейсах хоста.
• Одноразовый токен мастера, проверка запросов и запрет повторного назначения администратора после завершения настройки сохранены.
• Обновлены инструкция и сообщение ошибки на русском и английском.

Установка и обновление

Распакуйте valheim-server-v1.2.1.zip и выполните в каталоге проекта:

docker compose up -d --build

Откройте адрес сервера или домен. При прямом доступе разрешите соответствующий веб-порт в firewall. Если нужен доступ только через прокси на том же хосте, укажите публикацию 127.0.0.1:8080:8080 (для второй копии — 127.0.0.1:8081:8080).

При обновлении сохраните прежнее имя проекта Compose и том данных, а также используемые -p / -f. Перед обновлением скачайте резервную копию. Не используйте docker compose down -v: он удаляет том с данными. Уже настроенный сервер повторно проходить мастер не просит.

При переходе с v1.1.0 учитывайте инструкцию миграции v1.2.0: новый Compose не читает .env, поэтому параметры, существовавшие только в окружении, нужно проверить в мастере. Ограничение на локальный доступ из той инструкции в v1.2.1 снято.

Проверки и файлы

109 серверных тестов прошли на Windows и в Linux-контейнере, включая настройку по публичному Host, через reverse proxy и запрет повторной настройки. Проверены локализация RU / EN и обе конфигурации Compose; Docker-образ собран из релизного коммита.

Приложены архив проекта, установщики Windows и Linux / Proton и SHA256SUMS.txt. Установщики не изменились относительно v1.2.0, контрольные суммы проверены. Windows EXE по-прежнему без подписи издателя. Запуск реального игрового клиента в рамках этой проверки не выполнялся.

Все изменения: v1.2.0...v1.2.1

Loki v1.2.0

Что нового

• Первый запуск через браузер: запустите Docker Compose и пройдите мастер — пароли, сервер, мир, режим Valheim Plus или vanilla, лендинг и резервные копии. Копировать и заполнять .env больше не нужно. Настройки сохраняются в томе Docker.
• Перенос миров: экспорт и импорт пары .db / .fwl, правил мира и, для Valheim Plus, конфигурации мода. Перед импортом выполняются проверка архива и резервное копирование. После импорта сервер остаётся остановленным для проверки настроек.
• Русский и английский: мгновенный переключатель на лендинге, в панели, на странице входа и в мастере настройки. Выбор сохраняется, синхронизируется между вкладками; несохранённые поля остаются на месте. Для лендинга можно задать отдельное английское описание.

Новая установка

Распакуйте valheim-server-v1.2.0.zip и выполните в каталоге проекта:

docker compose up -d --build

Откройте http://localhost:8080. На удалённом хосте сначала создайте SSH-туннель со своего компьютера:

ssh -L 8080:127.0.0.1:8080 user@server

Первичная настройка доступна через прямой локальный доступ, без reverse proxy. После настройки можно использовать публичный домен. Игровые порты по умолчанию: UDP 2456–2457.

Обновление с v1.1.0

1. Создайте и скачайте резервную копию через прежнюю панель.
2. Обновите файлы в прежнем каталоге, сохранив имя проекта Compose и том данных.
3. Выполните docker compose up -d --build с прежними -p / -f, если использовали их.
4. Если появился мастер, откройте его локально или через SSH-туннель, назначьте пароль администратора и проверьте имя мира, режим, пароль игры и адреса.

Новый Compose не читает старые .env: настройки, сохранённые через панель, подхватываются из тома, а параметры, существовавшие только в окружении, нужно проверить в мастере. Не выполняйте docker compose down -v: эта команда удаляет том с игровыми данными. Обновление панели само по себе не обновляет игру.

Перенос мира

На обоих серверах должны совпадать установленная версия игры, режим и, для V+, версия мода. Используйте ZIP, созданный функцией экспорта; произвольные ZIP и старые резервные TAR.GZ этим импортом не поддерживаются. Пароли, статистика игроков, настройки сайта и игровые бинарники в экспорт не входят.

Для загрузки больших миров через nginx добавьте в конфигурацию прокси:

client_max_body_size 1g;
proxy_read_timeout 300s;

Предусмотрите до 3 ГиБ свободного места для обработки архива плюс место для резервной копии. Экспортированные архивы сохраняются отдельно и не удаляются автоматически.

Проверки и файлы

• 108 автоматических серверных тестов на Windows и в Linux-контейнере; проверки мгновенной локализации и обеих конфигураций Compose.
• Docker-образ собран из исходников релизного коммита.
• Windows- и Linux/Proton-установщики не изменились относительно v1.1.0; контрольные суммы проверены. Windows EXE по-прежнему без подписи издателя.
• SHA256SUMS.txt содержит суммы архива проекта и обоих установщиков.

Проверки переноса и отката автоматизированы; подключение реального игрового клиента в рамках этой релизной проверки не выполнялось.

Изменения: v1.1.0...v1.2.0