Better Minimap

A configurable client-side minimap for Valheim, by AndrewSha.

Releases · Report a bug · Русский

Features

Two supported UI languages: English and Russian. Russian is selected automatically when the game language is Russian; English is used otherwise.

• Orientation: follow the camera, follow the character, or keep north up. Icons and compass letters remain readable.
• Shape and size: circular or square, 50–150%. Status effects move left when the map is enlarged.
• Zoom: smooth transitions, configurable limits and shortcuts. Custom zoom levels are anchored at ×1, so reaching a limit does not shift the scale.
• Ship zoom: separate land/ship magnifications, shared by worlds and characters in the same profile and saved between game sessions. Works for passengers too.
• Compass: independently toggle letters and lines; choose solid/dashed lines, color and thickness.
• HUD layout: place the biome label above/below the map and the wind arrow at an outside corner or top/bottom center. External outlines improve readability.
• Lighting: follow time of day, always day, or always night. Only the minimap material is changed.
• Settings: English, or Russian when the game language is Russian. Optional integration with StoreAndCraft's mod settings window.

The large M map, world lighting, exploration data, networking and world saves are not modified. Install on the client, not on the server.

Screenshots

Circular minimap

Square minimap

Ship zoom

Requirements and installation

• Valheim with BepInEx 5. Built against Valheim 1.0.17 and BepInExPack 5.4.2351.
• StoreAndCraft is optional. Its mod settings window provides the localized in-game UI; Better Minimap does not install or rebind F10.
• Other minimap/HUD overhaul mods may conflict. Compatibility with every HUD mod, resolution and game update is not guaranteed. Windows is the tested build environment.

r2modman / Thunderstore Mod Manager: download the ZIP from GitHub Releases, close the game, then use Settings → Profile → Import local mod. The package is AndrewSha-BetterMinimap.

Manual: install BepInEx 5, then copy plugins/BetterMinimap.dll from the ZIP into BepInEx/plugins/BetterMinimap/.

Do not install the old Shtab Rotating Minimap DLL alongside Better Minimap. The plugin ID and config filename remain unchanged for compatibility.

Settings and defaults

In StoreAndCraft's mod settings window (usually F10), choose Better Minimap. Changes apply after Save; closing or going back without saving discards them. Other configuration managers are not modified by our localization integration.

Sections: 1. General → 2. Map → 3. Zoom → 4. Shortcuts → 5. Compass.

• Enable mod: switches off all mod features without losing settings. The settings window remains available.
• Reset to Vanilla: stages a vanilla-like preset: square, 100%, north up, default biome/wind positions, daytime lighting, Min 0 / Max 1, and custom rotation, zoom keys, smoothing, ship zoom and compass disabled. It is only a preset, not a locked mode. Automatic outlines and the zoom indicator remain while the mod is enabled. Use the master switch for a completely unmodified minimap.
• Reset to mod default: stages the defaults in the table. Neither reset changes the master enable switch, including an unsaved manual change to it.
• Both resets apply after Save and reset saved land/ship zoom to ×1, subject to the selected limits. If the mod is disabled, the zoom reset waits until it is manually enabled.
• Min zoom = 0 removes the custom far limit, but not the technical whole-map limit. If Min exceeds Max, the bounds are swapped internally. Only the small map is affected.
• The configurable zoom step applies to this mod's keys; native game keys retain their own step and respect the limits. Shift+Equals and Shift+Minus work with the default bindings.
• The selected zoom is shown below the map for two seconds after a change. On a ship, the label identifies ship zoom.
• Line thickness is 0.1–3.0. Colors use #RRGGBB or #RRGGBBAA.
• Outside labels/arrows need screen space. Large HUD sizes and top-center combinations may extend beyond the screen; choose a different position or size if necessary.

Configuration and zoom memory

Close the game before manually editing:

BepInEx/config/net.shtab.rotatingminimap.cfg

Stable config keys retain their historical Russian names; localized labels are presentation only. Existing settings are preserved on update and older sections are migrated.

Separate land/ship magnifications are saved automatically in:

BepInEx/config/net.shtab.rotatingminimap.cfg.zoom

This contains only two zoom values, not game saves. The first time ship zoom is enabled without existing memory, both values start from the current zoom; set your preferred ship zoom aboard. Subsequent sessions restore the appropriate value, subject to Min/Max. A reset after Save resets both values to ×1.

Building and tests

Use .NET SDK 8 and reference DLLs from your own installed game and BepInEx profile. These proprietary/runtime DLLs are not included in this repository.

dotnet build RotatingMinimap.csproj -c Release `
  '-p:ValheimDir=C:\Games\Valheim' `
  '-p:BepInExCore=C:\ModProfile\BepInEx\core'
dotnet run --project tests/GeometryTests.csproj -c Release
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1

Output: bin/Release/net48/BetterMinimap.dll; installable ZIP: artifacts/. Packaging uses Windows PowerShell/System.Drawing. A private local.props may supply local reference paths and is ignored by Git.

Automated checks cover geometry, zoom levels and transitions, presets, localization strings and zoom-memory file I/O. They do not launch Unity or replace in-game testing of UI, clipping, lighting, resolution changes or compatibility. Report bugs with game/mod versions, reproduction steps and screenshots; remove private data from any attached logs/configs.

License and acknowledgements

MIT, copyright 2026 AndrewSha. See LICENSE.

The implementation and generated compass icon are original. Banderi/ValheimMinimapMod, AlweStats and EvuMinimap were studied for reference; their code and game assets are not bundled.

Русский

Better Minimap — клиентский мод мини-карты Valheim от AndrewSha.

Возможности

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

• Вращение по камере, персонажу или север сверху; читаемые значки и буквы компаса.
• Круглая/квадратная форма и размер 50–150%. При увеличении карты бафы сдвигаются влево.
• Плавный зум, свои клавиши и пределы. Ступени привязаны к ×1 и не смещаются после достижения Min/Max.
• Отдельные масштабы суши и корабля с сохранением между запусками игры, в том числе для пассажиров.
• Независимые линии и буквы компаса; цвет, толщина и сплошной/пунктирный тип линий.
• Положение биома сверху/снизу, стрелки ветра — снаружи по углам или по центру сверху/снизу. Внешние обводки.
• Освещение мини-карты: по времени суток, всегда день или всегда ночь.
• Русские настройки при русском языке игры, английские — при остальных.

Большая карта M, освещение мира, исследование, сеть и сохранения мира не изменяются. На сервер мод устанавливать не нужно.

Скриншоты

Круглая мини-карта

Квадратная мини-карта

Карта в режиме корабля

Установка

Нужен BepInEx 5. Сборка выполнена с DLL Valheim 1.0.17 и BepInExPack 5.4.2351.

Скачайте ZIP из GitHub Releases, закройте игру и импортируйте через Settings → Profile → Import local mod в r2modman/Thunderstore Mod Manager.

Вручную: скопируйте plugins/BetterMinimap.dll из архива в BepInEx/plugins/BetterMinimap/.

StoreAndCraft необязателен; его окно модов (обычно F10) предоставляет локализованный интерфейс. Без него остаётся файл конфига. Не держите старую DLL Shtab Rotating Minimap одновременно с новой. Совместимость со всеми HUD-модами и версиями игры не гарантируется.

Настройки

Разделы: 1. Общее → 2. Карта → 3. Зум → 4. Клавиши → 5. Компас. В окне StoreAndCraft изменения действуют после Сохранить. Закрытие или возврат назад без сохранения отменяет изменения.

По умолчанию: мод включён, вращение по камере, круглая карта 130%, биом сверху, ветер снизу по центру, освещение по времени суток. Зум ×0,1–×4, шаг ×1,5, плавность и отдельный зум корабля включены. Клавиши = / − и NumPad + / −. Буквы компаса включены, линии выключены; линии — пунктир, толщина 0,8, цвет #505050BB.

• Мод включён — общий выключатель всех функций с сохранением настроек и доступа к F10.
• Сбросить к настройкам игры — обычный пресет: квадрат 100%, север сверху, штатные положения биома/ветра, дневное освещение, Min 0 / Max 1. Вращение, дополнительные клавиши, плавность, отдельный зум корабля и компас выключены. Обводки и индикатор остаются, пока мод включён; полностью штатную карту возвращает общий выключатель.
• Сбросить к настройкам мода — дефолты выше. Ни один пресет не меняет общий выключатель, включая несохранённый ручной выбор.
• Сбросы применяются после Save и возвращают память масштабов к ×1 с учётом пределов. При выключенном моде сброс масштаба ждёт его ручного включения.
• Min = 0 снимает пользовательский предел отдаления, но не техническую границу всей карты. При Min > Max пределы внутренне меняются местами.
• Настроенная кратность действует для клавиш мода; штатные клавиши игры сохраняют свой шаг, но учитывают Min/Max. Работают Shift+= и Shift+−.
• Индикатор автоматически появляется на две секунды после изменения масштаба. На корабле подпись указывает корабельный зум.
• Толщина линий — 0,1–3, цвет — #RRGGBB или #RRGGBBAA.
• Элементам снаружи карты нужно место. При большом размере HUD и комбинациях сверху они могут выйти за экран — измените положение или размер.

Конфиг: BepInEx/config/net.shtab.rotatingminimap.cfg. Редактировать вручную при закрытой игре. При обновлении выбранные значения сохраняются, старые разделы мигрируют.

Память масштабов: BepInEx/config/net.shtab.rotatingminimap.cfg.zoom. Записывается автоматически; общая для миров, персонажей и кораблей внутри профиля. При первом включении без памяти оба масштаба берутся из текущего; настройте корабельный масштаб после посадки. При следующих входах восстанавливается подходящее значение с учётом Min/Max.

Для сборки нужны .NET SDK 8 и DLL своего клиента; команды приведены в английском разделе. Автотесты проверяют математику, пресеты, переводы и файл памяти, но не запускают Unity. В багрепорте укажите версии, шаги воспроизведения и скриншоты; удалите личные данные из логов и конфигов.

Лицензия MIT, автор AndrewSha.

Changelog

1.1.1

Changes since 1.1.0; consolidates the unpublished local test builds.

• Added Transport → Show transport, default On: carts, rafts and ships on both maps, including parked vehicles and modded vehicles using standard Ship/Vagon components. Only nearby client-loaded objects are shown; no saved pins, additional network messages or world-wide tracking. Completely custom vehicle systems require separate support.
• Added Transport icon size, range 5–20, default 12, on both maps. Player icon sizes are unchanged; edge clearance accounts for the selected size. The controlled ship has no duplicate native marker; disabling the mod restores it.
• Player icons now render above all other map icons and labels, with the local arrow highest. Clipping and pointer pass-through are preserved.
• Fixed terrain pixels protruding beyond the circular brown border: a 256-segment geometric stencil shares the frame contour. Border color/thickness are unchanged, with no extra black outer band.
• Fixed missing/stale coordinate outline copies caused by the shipped TextMeshPro numeric text buffer. Coordinates retain font size 9 and a 3-pixel outline, without a background rectangle.
• Regrouped all 30 settings into seven sections: General, Map appearance, Zoom and controls, Around the map, Compass and navigation, Players, Transport. Both reset buttons are under General; slot-order and ping help were added.
• Existing settings migrate automatically; saved values in the new sections take precedence. Renamed the keyboard-zoom toggle to Zoom with extra keys, preserving its historical config key and behavior.
• Updated English/Russian documentation, automated regression checks and the manual testing checklist.

Изменения относительно 1.1.0; объединены неопубликованные локальные тестовые сборки.

• Добавлен «Транспорт → Показывать транспорт», по умолчанию включён: тележки, плоты и корабли на обеих картах, включая припаркованные и модифицированные на компонентах Ship/Vagon. Только загруженные клиентом объекты рядом с игроком, без постоянных меток, дополнительных сетевых сообщений и поиска по всему миру. Полностью нестандартный транспорт требует отдельной поддержки.
• Размер иконок транспорта — 5–20, по умолчанию 12. Иконки игроков не меняются; отступ от края учитывает выбранный размер. Метка управляемого корабля не дублируется и восстанавливается при выключении мода.
• Иконки игроков теперь поверх остальных значков и надписей на обеих картах; своя стрелка выше всех. Обрезка и пропуск кликов сохранены.
• Исправлено выступание пикселей карты за круглую коричневую рамку: маска и рамка используют согласованную геометрию. Цвет и толщина сохранены, чёрный внешний слой не добавлен.
• Исправлена неполная обводка координат из-за числового буфера TextMeshPro. Шрифт 9, обводка 3 пикселя, без прямоугольной подложки.
• 30 настроек сгруппированы в семь разделов: Общее, Вид карты, Масштаб и управление, Элементы вокруг карты, Компас и навигация, Игроки, Транспорт. Кнопки сброса в «Общем»; добавлены схема слотов и подсказка про пинги.
• Сохранённые значения автоматически переносятся; значения в новых разделах имеют приоритет. Переключатель переименован в «Зум через доп. клавиши», старый ключ конфига и поведение сохранены.
• Обновлены RU/EN-документация, автотесты и список ручных проверок.

1.1.0

Changes since 1.0.1; consolidates the unpublished local test builds.

• Four configurable HUD slots replace separate biome/wind positions. Defaults: Empty / Biome / Wind / Empty. Centered wind, compact spacing, collapsed empty rows and vertical viewport fitting. Native biome font and wind size are retained; biome labels no longer disappear due to text truncation or animated transparency.
• X/Y/Z coordinates as slot content, without a separate switch: font size 9 and a black 3-pixel outline.
• General → Show minimap (default On) hides the small HUD while keeping the large M map accessible. Disabling the mod restores native visibility and layout.
• Session-only waypoints: Shift+left-click anywhere on the large map to set/move; Shift+right-click to clear without deleting pins. Gold markers, a minimap edge arrow, horizontal distance and selection confirmation with rounded distance.
• Clipped/distant player ping rings become blue directional edge arrows. Fully visible pings and native ping lifetimes are preserved.
• Other players' nicknames close below their minimap icons; no local-player name. Players settings: visibility, font size 4–20 (default 8), optional 2-pixel outline. Only public-position players are labeled; names clip to the map and do not change large-map labels.
• One thin brown border for circular and square maps, without a dark outer band.
• Updated RU/EN settings, presets and old HUD configuration migration. Expanded automated geometry/UI checks and manual testing checklist.
• Replaced the old screenshot gallery with one current reference image; documented the changes in the English and Russian README sections.

Изменения относительно 1.0.1; объединены неопубликованные локальные тестовые сборки.

• Четыре слота вместо отдельных положений биома/ветра: Пусто / Биом / Ветер / Пусто. Ветер по центру, компактные отступы, пустые строки без зазоров, подгонка блока по высоте экрана. Штатные размеры биома и ветра сохранены; исправлено исчезновение биома.
• Координаты X/Y/Z выбираются в слоте: шрифт 9, чёрная обводка 3 пикселя, без отдельного переключателя.
• «Показывать мини-карту» в разделе «Общее» скрывает малую карту, не блокируя M. По умолчанию включено.
• Цель на текущий сеанс: Shift+ЛКМ задаёт/переносит, Shift+ПКМ снимает без удаления меток. Золотые маркеры, стрелка у края, горизонтальное расстояние и подтверждение выбора с расстоянием.
• Не помещающиеся пинги игроков заменяются синими стрелками у края; ближние кольца и штатное время жизни сохранены.
• Никнеймы других игроков близко под иконками; своё имя скрыто. Показ, размер 4–20 (по умолчанию 8) и обводка 2 пикселя настраиваются в разделе «Игроки».
• Одна тонкая коричневая рамка без чёрного внешнего слоя для обеих форм карты.
• Обновлены RU/EN-настройки, пресеты, миграция старого HUD и проверки. В README добавлен список изменений и оставлен один актуальный скриншот.

1.0.1

• Added circular, square and ship-zoom screenshots to the README.
• Highlighted English and Russian UI support.
• No gameplay changes.

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

1.0.0

First public release.

• Camera-up, character-up and north-up minimap orientation.
• Circular/square shapes, adjustable size and status-effect spacing.
• Smooth zoom, configurable shortcuts and zoom levels anchored at ×1.
• Separate land/ship zoom saved between game sessions.
• Compass letters and configurable line color, thickness and style.
• Biome/wind positions with external outlines.
• Time-of-day, always-day and always-night minimap lighting.
• English/Russian integration with StoreAndCraft's settings window.
• Master enable switch and two reset presets that preserve its state.

Первый публичный релиз.

• Вращение мини-карты по камере/персонажу или север сверху.
• Круглая/квадратная форма, размер карты и сдвиг бафов.
• Плавный зум, свои клавиши и ступени с опорой на ×1.
• Отдельные масштабы суши/корабля с сохранением между сеансами.
• Компас, цвет/толщина/тип линий, положения биома/ветра и внешние обводки.
• Освещение по времени суток, постоянный день или ночь.
• Настройки RU/EN в окне StoreAndCraft, общий выключатель и два пресета.