working on optimizations...

Feel free to help me on github ;~;

Simple Minimap adds a lightweight in-game minimap to Subnautica 2, with a player marker, heading indicator, and an optional large map view.

The minimap is rendered directly on the HUD using UE4SS Lua scripting. By default, it appears in the top-right corner of the screen and can be toggled on or off at any time. A larger centered map view is also available for quick navigation.

This mod uses UE4SS, so you need to install UE4SS - Subnautica 2 first:

https://www.nexusmods.com/subnautica2/mods/36

Features

Adds a simple minimap overlay to the HUD
Shows the player position on the map
Shows the player heading / direction
Toggleable large map view
Fully configurable size, position, opacity, keybinds, update interval, marker size and marker colors
Supports MapGenie-based projection / calibration
Lightweight Lua mod using UE4SS

Controls

Default keybinds:

M — Open / close the large map
H — Hide / show the minimap

These can be changed in config.lua.

The mod registers the configured keys from config.lua, where OpenMapKey is set to M and HideMapKey is set to H.

Installation

Download and install UE4SS - Subnautica 2 from Nexus Mods:
https://www.nexusmods.com/subnautica2/mods/36
Go to your Subnautica 2 install folder.
Open the UE4SS mods folder:

Subnautica2/Binaries/Win64/ue4ss/Mods/

For Game Pass / WinGDK versions, the folder may be:

Subnautica2/Binaries/WinGDK/ue4ss/Mods/

Create a folder named:

SubnauticaMapMod

Place the mod files inside:

SubnauticaMapMod/

├── Assets

│ ├── MapArrowRight.png

│ ├── mapgenie_world_cropped.png

│ └── pixel.png

├── Scripts

│ ├── config.lua

│ └── main.lua

└── enabled.txt

Configuration

You can edit config.lua to customize the mod.

Keybinds

OpenMapKey = "M"

HideMapKey = "H"

Change these to any valid UE4SS key name.

Startup visibility

ShowMinimapAtStartup = true

Set this to false if you want the minimap hidden when the game starts.

Update interval

UpdateIntervalMs = 500

Lower values update the marker more often. Higher values may be slightly lighter on performance.

Minimap layout

Minimap controls the small minimap shown on the HUD.

Calibration

The mod uses the game’s player position and converts it to map coordinates. By default, it uses the MapGenie projection mode configured in config.lua.

If the marker appears slightly offset, you can tune the map calibration values in the Map section of config.lua.

Important fields include:

ProjectionMode = "MapGenie"

HorizontalAxis = "X"

VerticalAxis = "Y"

ClampMarkerToMap = true

For advanced manual calibration, you can also adjust:

WorldMinX

WorldMaxX

WorldMinY

WorldMaxY

AutoCenterOnFirstPlayerPosition

Troubleshooting

The minimap does not appear

Make sure UE4SS is installed correctly.
Make sure main.lua and config.lua are directly inside the SubnauticaMapMod folder.
Make sure the assets are inside SubnauticaMapMod/Assets/.
If you are experiencing FPS issues, you can increase the UpdateIntervalMs value in the config file.