kylepaulsen / ValheimWebMap

A Valheim dedicated server mod to host a web accessible map.
29 stars 13 forks source link

Valheim WebMap

This server side mod creates a web based map that shows live players and allows shared exploration. After port forwarding the correct port, you can share http://your_ip:port to anyone else and they can see the map too. Clients do not need to have any mods installed!

For players to show up on the map, they must set visible to other players in the in-game map screen.

This has only been tested on a Valheim dedicated server. I'm not sure this will work with the built in server inclued with the base game.

Features

Installation

Place the WebMap directory in:

Steam\steamapps\common\Valheim dedicated server\BepInEx\plugins\WebMap

Optionally, open WebMap/config.json with a text editor and change stuff in there.

Updating

If you are updating, one additional thing you and anyone else using the web map might need to do is clear your browser cache.

You may also be able to hold down the shift key and click the reload button in your browser.

Chat Commands

This mod supports placing pins with chat commands. Press Enter to start chatting in game. The commands are as follows:

If a player creates too many pins, their oldest pin will be removed. There is a setting to control how many pins a player can create in config.json.

Development

To get your environment working, you will need to find and place these .dll files in the WebMap/libs directory. These dlls are usually found in:

Steam\steamapps\common\Valheim dedicated server\valheim_server_Data\Managed

To get the fontend part building, you'll need node installed. After, just do npm install to install webpack. Then you can run npm run build to build main.js which should be included with the other web resources in WebMap/web.

I wanted to get this working as soon as possible, so apollogies for messy code.

Licence

When applicable, assume stuff is under the MIT licence ( https://opensource.org/licenses/MIT ) I am not liable for any damages and there is no warranty etc...