Как открыть общую веб-карту выделенного сервера Valheim
ValheimWebMap устанавливается на сервер; игрокам клиентский мод не нужен. Карта показывает сгенерированную местность с туманом исследования, но не построенные здания и не изменения ландшафта. Не путайте её с прямой локальной связью браузера и клиентской игры.
Установка и первый запуск
- Выберите профиль Valheim Dedicated Server в менеджере модов и установите ValheimWebMap с BepInExPack Valheim.
- При ручной установке сначала установите BepInExPack Valheim на сервер, затем поместите ValheimWebMap.dll в BepInEx/plugins/ValheimWebMap.
- Запустите сервер и дождитесь загрузки мира. Конфигурация появится в BepInEx/config/com.valheimwebmap.cfg.
- Проверьте журнал: должны появиться сообщение о веб-слушателе, имя отслеживаемого мира и этапы рендера.
- Проверьте карту на настроенном адресе и порту; значение Web → Port по умолчанию — 3000.
Предварительная карта доступна раньше полного рендера. Время полной подготовки зависит от CPU, затем результат кэшируется на диске. Не принимайте низкое качество превью за окончательный результат или доказательство ошибки.
Доступ через свой reverse proxy
В моде нет собственной аутентификации. Для доступа игроков предусмотрен ваш reverse proxy с вашей авторизацией. Веб-часть использует относительные URL; при размещении в подпапке путь должен завершаться слешем, например /valheim/ с upstream http://127.0.0.1:3000/.
В конфигурации Web → Host задаёт адрес привязки, по умолчанию *. Это не настройка пароля. Выберите адрес, достижимый вашим proxy, и не считайте сам факт работающего HTTP-слушателя настроенным контролем доступа. Конфигурация читается при старте — проверяйте изменения после перезапуска сервера.
Какие данные видят игроки
| Настройка или условие | Эффект |
|---|---|
| Visible to other players в игре | Определяет, показывать ли живую позицию игрока. |
| Display → ShowHiddenPlayers | Показывает имена онлайн-игроков без открытой позиции; по умолчанию true. |
| Display → ShowCoordinates: false | Скрывает числовые координаты в списке, но не сам маркер. |
| Display → ShowHistory | Управляет вкладкой истории и /api/history. |
| History → TrackSessions: false | Отключает запись сессий и смертей, а не просто скрывает вкладку. |
Исследование фиксируется для всех подключённых игроков, даже если они не делятся живой позицией. Метки поступают из cartography tables; маркеры смерти показываются только для случаев, когда игрок делился позицией в момент смерти. Выберите эти правила до выдачи ссылки участникам.
Хранилище и проверка результата
По умолчанию данные лежат в BepInEx/config/ValheimWebMap/<world name>/: basemap_<resolution>.bin содержит кэш рендера, explored.bin — исследование, history.json — сессии и смерти. Смена видимости страницы не означает автоматического удаления уже накопленной истории.
- Проверьте нужный мир и завершение полного рендера по журналу.
- Сравните видимость игрока с его внутриигровой настройкой sharing, а не только со скрытием чисел координат.
- Проверьте метки из cartography tables и туман исследованных областей.
- Отдельно проверьте авторизацию proxy: мод не добавит её сам.
Гайд был полезен?