Capture1(1).png
Description
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:
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.
The Simple Minimap Team
