Valheim Admin

Run your Valheim dedicated server from a web browser, and give your players a live world map.

A plain dedicated server is just a console window. With this mod you get a web page for your server:

• 🗺️ A world map anyone can open, no login needed. It shows players, portals, bosses, dungeons, traders and pins. By default only the areas players have explored are visible.
• 🛠️ An admin panel behind a password. It has a live console, an event log, player management, character backups with item restore, and config editing.

It works on rented hosts and Linux as well as on your own Windows PC, and it works with modded servers.

What you can do

On the map (for everyone)

• See where players are. Only players with "Visible on map" turned on are shown.
• See the real map of your world, including worlds changed by generation mods.
• You choose what the public sees: portals, boss altars, dungeons, traders, mob nests, cartography table pins.

In the admin panel

• See the whole world: every boss altar, dungeon, trader, vegvisir, camp and tar pit. It's like valheim.tools, but for your world, with search and filters.
• See players' own pins, including where they died.
• Console: read the server log live and run any console command on the server, including commands from other mods. Commands like @Ragnar god run on a player's game.
• Event log: joins, leaves, deaths with the cause, chat, boss kills, raids.
• Players: who is online, play time, kick, ban, whitelist, give items.
• Get lost items back: each player's inventory and skills are saved on every world save, including enchantments and other mod data (Epic Loot, Jewelcrafting, backpacks, …). Compare with the current character and restore what was lost.
• Edit mod configs in the browser.

Install on a rented host or Linux

1. Install this mod on the server.
2. Start the server. In the BepInEx log, find the line Web panel admin password: …. To set your own password, put it in [Web] AdminPassword in BepInEx/config/neocor.ValheimAdmin.cfg.
3. Allow incoming connections to TCP port 8095 in your host's panel. If your host gives you a different port, set it as [Web] Port.
4. Open http://<server-address>:8095. Share this address with your players for the map.

Install on your own Windows PC

Install this mod on the server, then download the agent from GitHub releases. The agent is a small program that runs next to the server and adds the following:

• start, stop and restart the server from the panel;
• automatic restart after a crash or a freeze;
• scheduled daily restarts, with a countdown in the game;
• game updates through SteamCMD, with a backup first.

The setup guide is on GitHub.

For players (optional)

Players can join without the mod. Players who install it get these extras:

• the admin can restore lost items and skills for them;
• their pins show up on the admin's map;
• the panel shows real item icons.

Players stay in control, in BepInEx/config/neocor.ValheimAdmin.cfg:

• [Client] AllowServerCommands: allow or refuse console commands from the admin;
• [Client] AllowRestore: allow or refuse restores and item gifts;
• [Client] SharePins: show or hide your map pins from the admin. Your pins are never shown on the public map.

The mod only accepts requests from the server you are playing on. Cheat commands permanently mark a character as having used cheats (this affects achievements), so the admin has to confirm them in the panel first.

Main settings

Server settings, in BepInEx/config/neocor.ValheimAdmin.cfg:

More information

The full guide, all settings, troubleshooting and the agent download are on GitHub: https://github.com/NeocorDK/Valheim-Admin-Tool

Please report bugs and ideas there too.

This mod was made with the help of Claude Code.

Changelog

0.4.1

Update the agent and the mod together (the public map settings use new agent routes). The world cleanup commands work on the server only, players do not need to update.

• Console: drops and cleardrops count and remove every item lying on the ground in the whole world (optionally only items older than N minutes). The game only despawns dropped items in loaded zones, so items in far zones piled up and bloated the world. Fish, food placed as decoration and items in containers are never touched. Server-side only, removal runs in the background in batches. Run save afterwards.
• Console: despawnenemycreatures [player radius] despawns every hostile creature in the whole world (or only those within a radius of an online player), so changed mob spawn settings take effect: creatures spawned by the old rules in far zones used to stay forever, and the game's own commands only reach nearby ones. Bosses, Dverger, animals, tamed creatures and traders are never touched, nothing drops loot. Panel console only, server-side only (no mod needed on players' side), runs in the background in batches. Run save afterwards.
• Console: objects and delobjects list and remove world objects by prefab inside a radius of a point or a player (or by id), e.g. traders an admin spawned by mistake; the real ones elsewhere stay. Server-side only: players don't need to update. Run save afterwards.
• Public map settings in the panel (Map tab → "Public map settings", admin only): fog, players, locations, portals, mob spawners, cartography table pins and players' own pins; applied at once, no restart.
• Visitors now see what players see on the in-game map: cartography table pins and the personal pins of players with the mod (filterable by player) are on the public map by default, inside explored areas. Players can still opt out with [Client] SharePins.
• [Map] PublicGamePins is gone (panel-only now); the other [Map] Public* entries are only starting values until the settings are saved in the panel.

0.4.0

• Every location of the world on the map, like valheim.tools but for your actual world, modded locations included: boss altars (beaten bosses greyed out), dungeons, vegvisirs, traders, camps and nests, resources, runestones and the rest; faded until someone reaches them. Layers per category, search with jump to the nearest match, details on click.
• Mob spawners (greydwarf nests, body and bone piles, modded ones) on the map.
• Pins from the game's map: cartography table pins (their explored area is added to the public fog too) and, for the admin, personal pins of players with the mod, filterable by player. Players can opt out with [Client] SharePins.
• New public map options [Map] PublicSpawners and PublicGamePins (off); PublicLocations now covers all locations.
• The map's layer panel can be collapsed.

0.3.0

• Public world map as the landing page, no login needed: drawn on the server from the world generator (world generation mods included), explored areas tracked on the server, players (respecting "Visible on map"), admin pins; portals and places optional. Unexplored areas never leave the server. Works with the nomap key; the admin sees everything, including tombstones.
• Standalone mode: on hosts where the agent cannot run (rented servers, Linux), the mod serves the panel itself: map, console, event log, players, snapshots, configs.
• Console: any game console command, vanilla or from other mods, runs on the server with its output shown; /command forces the game's command; help and autocomplete list the server's commands. Fixed @Player cheat commands, which the game refused on clients of a dedicated server. The panel asks before a cheat marks a character as cheated; server-only commands sent to a player run on the server.
• Snapshots work with any mod: items are rebuilt through the game's own item loading; inventories that mods add to the player are included; mod skills are named properly; restoring a skill whose mod is missing no longer corrupts the character; real item icons; Compare can ignore volatile mod data and marks look-alike items. Epic Loot support is now an optional extra.
• Admin sign-in from the menu, rate limits, optional HTTPS for the agent, warning when agent and mod versions differ.

0.2.0

• Character snapshots and restores, event log, players, configs, scheduled restarts, watchdog, SteamCMD updates.