About MiniMapHeeler
From ThunderstoreClient-side HUD minimap resizer with 1:1 terrain scaling, expanded zoom range, and clean HUD alignment for Valheim.
MiniMapHeeler
In native Valheim, the HUD minimap is locked to a fixed 200x200 square with a narrow zoom range, offering no way to adjust its size to fit your display or UI preferences. MiniMapHeeler unlocks minimap sizing while keeping the surrounding HUD clean and properly aligned.
This mod runs client-side on your local HUD. It does not need to be installed on servers and works in multiplayer.
Features
- Custom dimensions: Freely adjust width (100-1920) and height (100-1080) larger or smaller without texture distortion.
- Wider zoom range: Expands zoom boundaries with balanced steps so zooming in and out stays consistent.
- HUD alignment: Automatically offsets status effect icons to prevent overlap, with an optional layout to place the minimap below them.
- Live in-game tuning: Settings changed in BepInEx Configuration Manager (
F1) apply immediately without restarting. - Client-side only: Safe for local worlds and multiplayer servers with no server installation needed.
Configuration
Settings can be changed in-game using the BepInEx Configuration Manager (F1) or by editing BepInEx/config/dreamwraith.MiniMapHeeler.cfg:
| Section | Key | Type | Default | Description | | :--- | :--- | :--- | :--- | :--- | | 1 - General | EnableMod | bool | true | Enable or disable the mod. | | 2 - Dimensions | MinimapWidth | float | 200.0 | Minimap width in UI units (native default is 200; scales with UI scale). | | 2 - Dimensions | MinimapHeight | float | 200.0 | Minimap height in UI units (native default is 200; scales with UI scale). | | 3 - HUD Placement | ShiftBelowStatusEffects | bool | false | When true, aligns status effects to the right edge and places the minimap below them. | | 3 - HUD Placement | PositionOffsetX | float | 0.0 | Horizontal offset in UI units from default position. | | 3 - HUD Placement | PositionOffsetY | float | 0.0 | Vertical offset in UI units from default position. | | 9 - Debug | EnableDebugLogs | bool | false | Enable verbose diagnostic logging in console and Player.log. |
Compatibility
- Client-side only: Runs locally on the game HUD; safe to use on any multiplayer server.
- Single-player: Fully functional in local worlds.
- Mod managers: Compatible with Gale, Thunderstore Mod Manager, and r2modman.
- UI scaling: Fully compatible with Valheim's built-in UI scale slider (dimensions and offsets scale proportionally with the rest of the HUD).
Installation
Mod Manager (Recommended)
Install through Gale, Thunderstore Mod Manager, or r2modman.
Manual Installation
- Install BepInExPack Valheim.
- Download the latest release from GitHub or Thunderstore.
- Place
MiniMapHeeler.dllintoValheim/BepInEx/plugins/. - Launch Valheim.
Building from Source
Build using the .NET SDK:
dotnet build -c Release
The compiled assembly is output to bin/Release/net48/MiniMapHeeler.dll. Building with the Release configuration also creates a distribution zip in bin/Publish/.
Custom & CI Paths
For custom installations, non-standard Steam paths, or mod manager profiles, copy Environment.props.example to Environment.props in the project root to configure your paths:
VALHEIM_INSTALL: Root Valheim installation folder.BEPINEX_PATH: Root BepInEx folder (containingcore,plugins, etc.).
Highlights
From source dataLoaders
Runs on BepInEx.
Footprint
Rated a light load on a server.
Last update
Its author last shipped an update 33d ago.
MiniMapHeeler on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Valheim servers, for BepInEx servers. We download it from Thunderstore, place it, and restart the server.
- Server type needed
- BepInEx
- Server load
- light
- Smallest plan we suggest
- Valheim — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 1.1.0, released 2026-10-20
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| BepInEx |
From 3 recorded builds of MiniMapHeeler.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 1.1.0 | 2026-10-20 | n/a | BepInEx |
| 1.0.1 | 2026-10-19 | n/a | BepInEx |
| 1.0.0 | 2026-10-19 | n/a | BepInEx |
Dependencies
- Required: BepInExPack Valheim
Declared by the newest build that lists any. Required ones are installed with it on one-click installs.
Run MiniMapHeeler on a Valheim server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogWorld generation
Changes or adds to how new terrain, biomes and structures are created.
Compatibility
- Game
- Valheim
- Loaders
- BepInEx
- Requires
- One-click install needs a BepInEx server.
Verified at the source
- ✓ThunderstoreOfficial listing, checked 2026-10-20Open ↗
- ✓AuthorDreamWraith, as published on Thunderstore
- ✓LicenseNot published by the sourceFree






