Underkeep Map Helper — game version 1.05 (Steam)

Shows the whole map of the current level, your party's position and facing, and the steps you just took,
on a second monitor or as an overlay on top of the game.
Nothing to install, and no translation mod needed. It only reads game memory; it never changes the game.

Usage:
1. Put this folder anywhere (not inside the game's base folder). Keep the four files together.
2. Run UnderkeepMapHelper.exe, before or after starting the game. It finds the game by itself.
3. Inside a dungeon the map and your position appear automatically and follow you between maps.
   Play in borderless window or windowed mode (an overlay cannot cover exclusive fullscreen).

The map:
* North is up and the aspect ratio is fixed. Resize the window freely; spare space becomes black bars.
* The cyan arrow is your party and its facing; the cyan dots behind it are your last steps
  (8 by default, cleared when you change maps).
* Hover a coloured marker for a tooltip. Click it to keep the text in the line at the bottom
  (prefixed with the map name). Esc clears it.

Title bar buttons (left to right):
  Globe     Language: English (default) / 繁體中文 / 日本語
  Layers    Show or hide each marker type, area names, coordinate grid; trail length
  Sun       Window opacity
  Mouse     Click-through: clicks on the map pass through to the game; the title bar stays clickable.
            Ctrl+Alt+O also toggles it
  Pin       Always on top (on by default)
Drag the title bar to move the window and its border to resize. Position, size and settings are saved on exit.

Marker colours:
  blue = exit   purple = trap pit   green = NPC   dark red = boss   red dot = enemy
  orange square = chest / container   ochre square = fixed drop   small brown square = random drop when broken
  yellow dot = item on the ground   pink = secret spot / secret wall   white = event
  small cyan / purple squares = button, pressure plate   short brown line = door

Settings file:
UnderkeepMapHelper.settings.json next to the exe (or %APPDATA%\UnderkeepMapHelper if that folder is read-only).
The click-through hotkey is ClickThroughHotkey, e.g. "Ctrl+Alt+O" or "Ctrl+Shift+F9"; change it if another program uses it.

Notes:
* For game version 1.05 only. If the title bar says "Signature not found" after a game update,
  wait for a matching version of the helper.
* The whole map is shown, secrets included. Turn off the types you don't want to see in "Layers".
* Walkable areas are worked out from the exits; mechanism doors and paths opened by events are not shown.
* If it crashes, a log is written to %LOCALAPPDATA%\UnderkeepMapHelper\crash.log.
* If the helper flickers and disappears behind the game when you click the game (overlay mode):
  the NVIDIA driver treats a screen-filling OpenGL window as exclusive fullscreen.
  In NVIDIA Control Panel > Manage 3D settings > Program settings, add underkeep.exe and set
  "Vulkan/OpenGL present method" to "Prefer layered on DXGI Swapchain", then restart the game.
  It only affects this game. Not needed when the helper is on a second monitor.

Licenses:
Uses Avalonia, SkiaSharp, HarfBuzzSharp and ANGLE; see the LICENSES folder.
