Admin Tool
RavenEye
The vanilla map, for admins only, on a world that has none — with every player on it.
About RavenEye
For server owners running the nomap modifier, RavenEye gives the people on the
server’s own adminlist.txt the ordinary minimap and large map back, drawn exactly as the
game draws them — and on it, the ordinary player pin for every player online, whether or
not that player ever chose to share their position.
It does nothing for a player who joins someone else’s server without being on that list. The one exception is whoever runs the world: a host, or a player alone on a single-player no-map world, is that world’s admin and gets the map too (see Hosts And Solo Players below). Nothing new is drawn. Remove it and the world is exactly what it was.
What It Does
🗺️ The Map Itself
An admin’s minimap and large map return, running on the game’s own code — no overlay, no
second map. Their own exploration still counts (the game records it even on a no-map world),
their own pins still work, and the large map on M still zooms.
📍 Every Player Pinned
Every online player gets the ordinary vanilla player pin — name and icon — moving on the same two-second cadence the game uses for shared positions, whether that player has sharing switched on or not. Names show on the large map at zoom, same as vanilla.
💀 Where They Died
A player who dies stays on the map, by default for three minutes, at the place they fell,
marked “(dead)” — because on a world with no map, “help me find where I died” is the
question an admin hears most. The server sets the length with DeathGraceSeconds
(0 turns it off), and the pin goes early if that player disconnects.
🔐 The Server Decides
Whoever the server’s adminlist.txt says is an admin gets the map — the same check the game
runs before it honours a remote console command, a kick, or a ban. RavenEye keeps no list of
its own to configure or keep in step: add an ID and the map appears within seconds,
remove it and the map is gone within seconds. The roster travels to each admin over that
admin’s own connection, the one channel no other client can address, so no other player can
intercept or forge it.
🎭 Playing Honestly
An admin who wants to play their own no-map world the hard way can turn the grant down:
ShowMap = false in the client config, or raveneye map off in the console. The server
keeps offering the map; the client just doesn’t take it. raveneye map on takes it back —
and also clears the character’s own nomap preference, the one vanilla’s nomap command
sets on the character itself and carries to every world after.
While RavenEye grants you the map, the game does not credit your trips to the world’s edges
as no-map exploration — even if your character’s own nomap has the map hidden. With
RavenEye’s map switched off, the game counts them as it always did.
🏠 Hosts And Solo Players
The game treats whoever runs the world as its admin, and so does RavenEye. A player hosting
from their own game, or alone on a single-player no-map world, gets the map with RavenEye
installed — whether the world got its no-map rule from the “No map” setting at creation or
from the nomap command. To keep a solo run map-less, set ShowMap = false, type
raveneye map off, or leave RavenEye out of that profile. A host who made the world no-map
by typing nomap has also switched off their own character’s map; raveneye map on clears
that too.
Technical Specifications
| Parameter | Detail |
|---|---|
| Runs On | Client & Server — one DLL, both roles |
| Target Runtime | BepInEx 5.4.2333+ |
| Engine Target | Valheim (Unity Engine) |
| Current Version | 0.2.2 |
| Prefabs Added | None |
| Roster Data | Per player: name, character id, position, dead flag — nothing else about a player is ever sent |
Console
| Command | Effect |
|---|---|
raveneye status |
Role, grant, and in words why the map is or isn’t showing |
raveneye roster |
Every player the current roster carries |
raveneye map on|off |
Use, or refuse, the granted map on this client; on also clears the character’s own nomap opt-out |
Installation
Server: required — nothing happens without it.
Admins’ clients: required, to receive the roster and show the map. On a Gale-managed
client the plugin folder is
%APPDATA%\com.kesomannen.gale\valheim\profiles\<profile>\BepInEx\plugins\, not the Steam
folder.
Everyone else: nothing needed. If a modpack installs RavenEye on every client anyway, it stays inert for a player who joins someone else’s server without being on its admin list — no map, no pins, no change of any kind. Hosting your own world or playing solo is different; see Hosts And Solo Players above.
Requires BepInExPack Valheim.
Built against Valheim 1.0.16. On a game at 1.0 or newer you need 0.2.0 or later; 0.1.0 loses
its raveneye console command there.
Compatibility
RavenEye patches three game decisions, all as postfixes that yield to any other mod: the
game’s own map-permission decision, the list of players to pin, and the game’s check for the
no-map exploration credit, which reads “no” while RavenEye grants you the map. (A fourth
patch only registers the raveneye console command.) It never touches EnvMan, map
rendering, or world generation, so the season and weather mods are unaffected. A mod that
unlocks the map for everyone makes RavenEye’s own unlock redundant — the pins still work.
Each patch installs on its own. If a Valheim update moves one of the game methods RavenEye hooks, only that part switches off, the BepInEx log names it, and the rest carries on. That does not cover every kind of change: a renamed game class, or a changed method RavenEye calls rather than hooks, can take out more.
Reading a Vegvisir behaves for a granted admin exactly as it would on a map world: it pins the location and opens the map, instead of turning your head toward it.
Cairn and RavenEye are complementary — Cairn is for players finding their own way on a world with no map, RavenEye is for the person on duty. RavenEye shares a name’s worth of resemblance with The Raven’s Call and nothing else: no code, no data, no connection between them.
Part of the RavenIron Suite
Every RavenIron project is engineered server-authoritative in C# and .NET, and shares the same forge.

