You are viewing a potentially older version of this package. View all versions.
AndrewSha-BetterMinimap-1.2.1 icon

BetterMinimap

Rotating minimap with smooth zoom, customizable shape, size and transparency. Six HUD slots for clocks, carry weight and coordinates, plus waypoints and transport icons. Client-side, English/Russian settings.

Date uploaded a month ago
Version 1.2.1
Download link AndrewSha-BetterMinimap-1.2.1.zip
Downloads 696
Dependency string AndrewSha-BetterMinimap-1.2.1

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2351

README

Better Minimap

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

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

Screenshot

Better Minimap — референс мини-карты

Changelog

1.2.1
  • Shorter English/Russian README: screenshot first, collapsible version history and essential settings/controls only.
  • Build instructions moved to a separate document. Mod behavior and saved settings are unchanged from 1.2.0.
1.2.0
  • Six HUD slots, with separate 25–400% size controls and compact settings rows.
  • In-game clock, local computer clock and carry weight as slot content.
  • Minimap background transparency: 0–100%, without fading icons or text.
  • At 100% slot size, all text uses the biome font size; coordinates are no longer smaller by default. Existing settings are preserved.
1.1.1
  • Cart, raft and ship icons on both maps, with adjustable size.
  • Player icons above other markers; fixes for circular map edges and coordinate outlines.
  • Seven settings sections with automatic migration of saved values.
1.1.0
  • Configurable HUD slots, XYZ coordinates and a minimap visibility switch.
  • Session waypoints and blue edge arrows for off-screen pings.
  • Other players' names and a map border for both shapes.
1.0.1
  • README screenshots and clearer English/Russian language information; no gameplay changes.
1.0.0
  • First release: rotating minimap, circular/square shapes, smooth zoom, separate ship zoom, compass, lighting and English/Russian settings.

Full changelog

Features

  • Camera-up, character-up or north-up orientation; circular or square map, adjustable size and transparency.
  • Smooth zoom with custom shortcuts and separate land/ship zoom saved between sessions.
  • Six HUD slots for biome, wind, coordinates, clocks and carry weight, each with its own size.
  • Compass, waypoints and directional arrows for off-screen pings.
  • Names of other players sharing their position; nearby loaded carts, rafts and ships on both maps, including compatible Ship/Vagon-based modded vehicles.

English and Russian UI. Client-only: no server installation or changes to world saves, exploration or networking.

Requirements and installation

  • BepInEx 5 required. Built against Valheim 1.0.17 and BepInExPack 5.4.2351.
  • Install AndrewSha-BetterMinimap through r2modman/Thunderstore Mod Manager, or import the release ZIP via Settings → Profile → Import local mod with the game closed.
  • Manual install: copy plugins/BetterMinimap.dll from the ZIP into BepInEx/plugins/BetterMinimap/.

StoreAndCraft is optional and provides the in-game settings window. Other minimap/HUD overhauls may conflict. Do not keep the old Shtab Rotating Minimap DLL installed alongside this mod.

Settings and defaults

In StoreAndCraft's mod window (usually F10), select Better Minimap. Save applies changes; Close/Back discards unsaved edits.

Section Main settings and defaults
1. General Mod and minimap On; reset buttons
2. Map appearance Circle, 130% size (50–150%), camera-up, time-of-day lighting; transparency 0% (0–100%)
3. Zoom and controls ×0.1–×4, step ×1.5; smoothing and separate ship zoom On; = / − and NumPad + / −
4. Around the map Six slot contents; size 100% each (25–400%, including wind)
5. Compass and navigation Directions On, lines Off, target indicator On
6. Players Names On; font 8 (4–20), outline On
7. Transport Icons On; size 12 (5–20)
  • Show minimap hides the small HUD but keeps M available. Enable mod → Off restores the native HUD without losing settings.
  • Both reset presets preserve the master switch and reset zoom to ×1 within your limits. Reset to Vanilla is a vanilla-like preset, not a full mod disable.
  • Transparency affects only the minimap background, not icons, labels or the large map.

HUD slots and navigation

Order: 1 → 2 → minimap → 3 → 4 → 5 → 6. Defaults: Empty / Biome / Wind / Empty / Empty / Empty.

  • Choose Empty / Biome / Wind / Coordinates / In-game time / Weight / Real time in any slot. Repeats are allowed; empty slots take no space.
  • At 100%, text uses the native biome font size and wind its native size. Reduce an individual slot's percentage if its text is too wide.
  • Both clocks use HH:mm: game time or your computer's local time. Weight shows current / capacity, including bonuses.
  • On M: Shift+left-click sets or moves a waypoint; Shift+right-click clears it without deleting pins. The target and distance are local to the current session.
  • Off-screen pings appear as blue edge arrows; nearby pings keep their normal rings.

Configuration

Without StoreAndCraft, edit BepInEx/config/net.shtab.rotatingminimap.cfg with the game closed. Saved settings migrate automatically. Land/ship zoom is stored in the adjacent .cfg.zoom file.

Development and license

Build instructions and automated tests · In-game test checklist. Automated tests do not verify Unity rendering or input.

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.

Скриншот — выше.

Changelog

1.2.1
  • Сокращён README на обоих языках: скриншот выше истории версий, версии свёрнуты, в настройках оставлено главное.
  • Инструкции сборки вынесены отдельно. Поведение мода и сохранённые настройки не изменены относительно 1.2.0.
1.2.0
  • Шесть слотов HUD, индивидуальный размер 25–400% и компактные строки настроек.
  • Игровые часы, местное время компьютера и переносимый вес в любом слоте.
  • Прозрачность фона мини-карты 0–100%, без изменения значков и текста.
  • При размере 100% все тексты используют размер шрифта биома; координаты больше не уменьшены по умолчанию. Сохранённые настройки не сбрасываются.
1.1.1
  • Иконки тележек, плотов и кораблей на обеих картах с настройкой размера.
  • Иконки игроков поверх остальных; исправлены край круглой карты и обводка координат.
  • Семь разделов настроек с автоматическим переносом сохранённых значений.
1.1.0
  • Настраиваемые слоты HUD, координаты XYZ и переключатель видимости мини-карты.
  • Цель на текущий сеанс и синие стрелки для пингов за пределами карты.
  • Никнеймы других игроков и рамка для обеих форм карты.
1.0.1
  • Скриншоты в README и информация о поддержке русского и английского языков; без изменений игровой логики.
1.0.0
  • Первый релиз: вращение, круглая/квадратная карта, плавный и отдельный корабельный зум, компас, освещение и настройки RU/EN.

Полная история изменений

Возможности

  • Вращение по камере, персонажу или север сверху; круглая/квадратная форма, размер и прозрачность карты.
  • Плавный зум, свои клавиши и отдельные масштабы суши/корабля с сохранением между сеансами.
  • Шесть слотов для биома, ветра, координат, часов и веса с индивидуальным размером.
  • Компас, цель и стрелки направления для далёких пингов.
  • Никнеймы игроков с открытой позицией; загруженные рядом тележки, плоты и корабли на обеих картах, включая совместимый модифицированный транспорт на Ship/Vagon.

Интерфейс на русском и английском. Только клиент: установка на сервер не нужна; сохранения мира, исследование карты и сеть не меняются.

Установка

  • Нужен BepInEx 5. Сборка с DLL Valheim 1.0.17 и BepInExPack 5.4.2351.
  • Установите AndrewSha-BetterMinimap через r2modman/Thunderstore Mod Manager либо импортируйте ZIP релиза: Settings → Profile → Import local mod при закрытой игре.
  • Вручную: plugins/BetterMinimap.dll из ZIP → BepInEx/plugins/BetterMinimap/.

StoreAndCraft необязателен и предоставляет окно настроек в игре. Другие моды мини-карты/HUD могут конфликтовать. Не оставляйте старую DLL Shtab Rotating Minimap одновременно с новой.

Настройки и значения по умолчанию

В окне модов StoreAndCraft (обычно F10) выберите Better Minimap. Сохранить применяет изменения; закрытие/возврат отменяет несохранённое.

Раздел Главное и значения по умолчанию
1. Общее Мод и мини-карта включены; кнопки сброса
2. Вид карты Круг, размер 130% (50–150%), вращение по камере, освещение по времени суток; прозрачность 0% (0–100%)
3. Масштаб и управление ×0,1–×4, шаг ×1,5; плавность и отдельный зум корабля включены; = / − и NumPad + / −
4. Элементы вокруг карты Содержимое шести слотов; размер каждого 100% (25–400%, включая ветер)
5. Компас и навигация Направления включены, линии выключены, указатель цели включён
6. Игроки Никнеймы включены; шрифт 8 (4–20), обводка включена
7. Транспорт Иконки включены; размер 12 (5–20)
  • Показывать мини-карту скрывает малый HUD, оставляя M доступной. Выключение самого мода возвращает штатный HUD, сохраняя настройки.
  • Оба пресета сохраняют общий выключатель и сбрасывают зум к ×1 с учётом пределов. Сбросить к настройкам игры — приближённый к игре пресет, а не полное отключение мода.
  • Прозрачность меняет только фон мини-карты, не значки, подписи или большую карту.

Слоты HUD и навигация

Порядок: 1 → 2 → мини-карта → 3 → 4 → 5 → 6. По умолчанию: Пусто / Биом / Ветер / Пусто / Пусто / Пусто.

  • В любом слоте: Пусто / Биом / Ветер / Координаты / Игровое время / Вес / Реальное время. Повторения разрешены; пустые слоты не занимают место.
  • При 100% у текста штатный размер шрифта биома, у ветра — штатный размер стрелки. Если текст слишком широкий, уменьшите процент только его слота.
  • Оба варианта часов — HH:mm: игровое или местное время компьютера. Вес — текущий / грузоподъёмность, с учётом бонусов.
  • На M: Shift+ЛКМ задаёт/переносит цель, Shift+ПКМ снимает её без удаления пинов. Цель и расстояние локальны текущему сеансу.
  • Далёкие пинги — синие стрелки у края; ближние сохраняют обычные кольца.

Конфиг

Без StoreAndCraft редактируйте BepInEx/config/net.shtab.rotatingminimap.cfg при закрытой игре. Сохранённые настройки переносятся автоматически. Масштабы суши/корабля хранятся в соседнем .cfg.zoom.

Сборка и автотесты · Ручные проверки в игре. Автотесты не проверяют отрисовку и ввод Unity.

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

CHANGELOG

Changelog

1.2.1 — Documentation refresh / Обновление документации

English

  • Moved the screenshot above a single Changelog section, with a separate collapsed block for every version in each language.
  • Shortened the English/Russian README, especially settings and HUD/navigation: only essential defaults and controls remain.
  • Moved build/test instructions to docs/building.md; preserved the complete release history in this file.
  • Documentation-only update since 1.2.0. Mod behavior, defaults and saved settings are unchanged; the version bump delivers the revised README in the Thunderstore package.

Русский

  • Скриншот перенесён выше единого раздела Changelog; каждая версия — отдельный свёрнутый блок в обоих языках.
  • Сокращён README RU/EN, особенно настройки и HUD/навигация: оставлены основные значения по умолчанию и управление.
  • Инструкции сборки/тестирования вынесены в docs/building.md; полная история релизов сохранена в этом файле.
  • Только документация относительно 1.2.0. Поведение мода, дефолты и сохранённые настройки не изменены; новый номер нужен для доставки обновлённого README в пакете Thunderstore.
1.2.0 — Six HUD slots, individual sizes, clocks, weight and transparency / Шесть слотов, индивидуальные размеры, часы, вес и прозрачность

English

Changes since 1.1.1; consolidates the unpublished local test builds.

  • Added Slot 5 and Slot 6 below Slot 4: two upper and four lower slots, with new slots empty by default. Existing choices are preserved; empty rows collapse and the zoom popup stays below the last filled row.
  • Each slot has its own size, 25–400%, default 100%, including biome text and the wind arrow. All text contents share the native biome font size at 100%; coordinates are no longer smaller by default. Wind scales from its native size; outline widths are unchanged. Sizes persist across content changes; both presets reset them to 100%. Row heights follow the text metrics or scaled wind diagonal.
  • Compact StoreAndCraft slot rows combine content selection and size on one line with a short label and no per-slot description. Narrow windows use two compact lines. Native Save/Cancel and input widgets are retained; other mods are not changed.
  • Added In-game time, Real time and Weight to all six HUD slots. In-game solar time follows the game's day/night cycle and sleep transitions; real time shows the computer's local clock, both in HH:mm. Weight shows current / maximum, rounded up like the native inventory and including the current carry-capacity bonuses. All three use white text with a 2-pixel outline. Existing slot-content defaults remain unchanged; saved Time selections remain the in-game clock.
  • Added Map appearance → Map transparency (%), 0–100, default 0% (opaque). Only the minimap terrain/background fades; icons, border, compass, slot labels and the large map are unchanged. Both presets restore 0%.
  • At 1–99% transparency, terrain is rendered separately with the game's shader and composited with UI alpha. At 100%, terrain is hidden without running that pass. At 0%, the original rendering path is retained and the extra resources are released.
  • If transparency rendering fails, the background falls back to opaque without disabling the other mod features or changing the saved setting. One warning per failure; no per-frame retries. Save 0%, then the desired value to retry. Partial setup is cleaned up too.
  • The seven settings sections now contain 39 entries. Existing saved settings and local-test slot sizes are preserved; new size entries start at 100%. Plugin ID, DLL/config names and client-only installation are unchanged.
  • Updated RU/EN documentation and settings, automated clock/weight/opacity, fallback, six-slot layout and size checks, and the in-game checklist. Automated tests do not verify Unity rendering or input.

Русский

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

  • Добавлены Slot 5 и Slot 6 ниже Slot 4: два верхних и четыре нижних слота, новые по умолчанию пустые. Прежние значения сохраняются; пустые строки схлопываются, индикатор зума остаётся ниже последней заполненной строки.
  • У каждого слота свой размер 25–400%, по умолчанию 100%, включая биом и стрелку ветра. При 100% все тексты имеют штатный размер шрифта биома; координаты больше не уменьшены по умолчанию. Ветер масштабируется от штатного размера; толщина обводок не меняется. Размеры сохраняются при смене содержимого; оба пресета возвращают 100%. Высота строк учитывает метрики текста или диагональ увеличенной стрелки.
  • В StoreAndCraft содержимое слота и размер объединены в одну компактную строку: короткая подпись, без описания под каждым слотом. На узком окне — две компактные строки. Штатные элементы управления и Save/Cancel сохранены; другие моды не затронуты.
  • Во все шесть слотов добавлены «Игровое время», «Реальное время» и «Вес». Игровые солнечные часы следуют за циклом дня/ночи и переходом ко сну/утру; реальные показывают местное время компьютера, оба варианта — HH:mm. Вес — текущий / максимальный, с округлением вверх как в инвентаре и учётом действующих бонусов к переносимому весу. Белый текст с обводкой 2 пикселя. Содержимое прежних слотов по умолчанию не изменено; сохранённое значение Time остаётся игровыми часами.
  • Добавлено «Вид карты → Прозрачность карты», 0–100%, по умолчанию 0% (непрозрачная). Меняется только фон мини-карты; значки, рамка, компас, подписи слотов и большая карта сохраняют свой вид. Оба пресета возвращают 0%.
  • При прозрачности 1–99% фон отрисовывается штатным шейдером в отдельную текстуру, затем накладывается с нужной прозрачностью. При 100% фон скрыт без этого прохода отрисовки. При 0% используется прежняя отрисовка, дополнительные ресурсы освобождаются.
  • При ошибке отрисовки прозрачности возвращается непрозрачный фон, остальные функции продолжают работать, сохранённая настройка не меняется. Одно предупреждение при сбое, без повторных попыток каждый кадр. Для повтора сохраните 0%, затем нужное значение. Частично созданные ресурсы также освобождаются.
  • В семи разделах теперь 39 настроек. Сохранённые значения и размеры слотов из локальных тестовых сборок сохраняются; новые настройки размера получают 100%. ID плагина, имена DLL/конфига и установка только на клиент не изменены.
  • Обновлены RU/EN-документация и настройки, автотесты часов/веса/прозрачности, обработки сбоев, раскладки шести слотов и размеров, а также ручной checklist. Автотесты не проверяют отрисовку и ввод Unity.

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, общий выключатель и два пресета.