Omni Map

A minimap, full map, markers and routes for Risk of Rain 2 (BepInEx 5). Press F7 in game for the settings.

Features

• Minimap with a real render of the level – a top-down camera draws the actual terrain, roofs and ceilings are cut away so caves stay readable. Round or square, rotates with the camera or stays north-up, any screen corner, size, opacity, zoom, border colour and width, camera view cone, distance rings, north marker, arrows for objects far above / below, important icons pinned to the edge. While the settings window is open you can drag the minimap with the mouse and zoom with the wheel.
• Location name under or above the minimap – stage number, dark plate, colour, font size, optional second line with your coordinates and the distance to the teleporter.
• Icons for everything: other players, drones/minions, enemies, elites, bosses (with portrait), every kind of chest, multishops, shrines, printers and cauldrons, scrappers, broken drones, barrels, teleporter (with charge radius and %), portals, dropped items (with their real icons). Each kind can be switched off, given another icon (22 to choose from, many are the game's own), colour and size. Arrow icons point where the character is looking – by default other players are shown that way, enemies can be too.
• Full map (M): drag to pan, wheel to zoom, tooltips, names.
• Markers and routes: place a marker at the crosshair (N) or with right click on the full map; left click an icon on the full map to route to it. Routes follow the game's own navigation graph and are drawn on both maps and in the 3D world. Automatic route to the teleporter, nearest chest / shrine / dropped item / portal / interactable. Marker and route colours are independent.
• Settings in the style of Omni Mod Menu – themes (accents, gradients, rainbow, custom colours), hotkeys with a main and an extra key and conflict detection with the game's keys.
• 12 languages: English, Українська, Русский, Deutsch, Español, Français, Italiano, Português (BR), Türkçe, 日本語, 한국어, 简体中文. "Auto" follows the game language until you pick one.

Installation

1. Install BepInEx 5 (BepInExPack) for Risk of Rain 2, or use r2modman / Thunderstore Mod Manager.
2. Extract the manual archive into the game folder (it contains BepInEx/plugins/OmniMap/OmniMap.dll and the lang folder), or install through the mod manager.
3. Start the game and press F7.

Default keys (changeable in Settings → Hotkeys)

Key	Action
F7	Settings
M	Full map
N	Marker at the crosshair
B	Clear markers and routes
Num + / Num -	Minimap zoom
Esc	Close the full map

Settings are stored in BepInEx/config/user.omni.map.cfg.

Other languages

Put a lang/<code>.json file next to the plugin (key = English text, value = translation). Codes: de es fr it pt tr ja ko zh; see the shipped files for the format.

Building

powershell -ExecutionPolicy Bypass -File build.ps1 builds and installs into the game folder (the game must be closed; it uses Roslyn from the .NET SDK and the game's Managed assemblies). powershell -ExecutionPolicy Bypass -File package.ps1 creates the release archives in release/. Translations live in tools/tr_uk.py and tools/tr_other.py; python tools/gen_lang.py regenerates src/Strings.cs and lang/*.json.

Notes

• The game renders with deferred shaders, which do not work with an orthographic camera, so the map camera is a narrow-FOV perspective camera high above the player; icons use the same projection.
• Rendering the map costs about 0.3 ms per frame with the default settings. Lower Updates per second / Texture size in the Terrain tab for more FPS.
• In multiplayer the mod only reads game state locally; it does not change anything for other players.

License

MIT – see LICENSE.