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