
TotemPins
Add-on for Travel Totems: undiscovered totems appear on everyone's map like the trader, unlocks are shared by all players, and the server controls the map pin settings. Install on server and all clients.TotemPins
An add-on for Travel Totems that makes totems discoverable and shared across a multiplayer server.
- Undiscovered totems show on the map. Once anyone gets near enough for an area of the world to be generated, every Travel Totem in it gets a pin for every player, the same way the trader does. Pins use Travel Totems' grey "not yet unlocked" icon and don't reveal the biome.
- One unlock counts for everyone. When a player reaches a totem and unlocks it, it's unlocked for every player. Its TotemPins pin goes away and everyone sees Travel Totems' normal totem icon instead, which they can teleport to.
- The server is in charge. The server's TotemPins config decides how pins look and overrides the Travel Totems map settings for every player. Players don't need to change anything.
Installation
Install TotemPins on the server and on every player's game. Travel Totems itself must be installed, as usual.
- The server decides which totems get pins, keeps track of unlocks, and sends the same pins, unlocks and settings to every player.
- Each player's game draws the pins, applies the server's settings to Travel Totems, and tells the server which totems that player has unlocked.
- A player without TotemPins won't see TotemPins pins, won't get shared unlocks, and their unlocks won't be shared. Nothing breaks.
Existing worlds
- Totems in areas that have already been generated get pins as soon as a player joins.
- Travel Totems saves unlocks in each character, not in the world. The server learns about unlocks made before TotemPins 3.0.0 the next time that player logs in, and then shares them.
Configuration
The config file is BepInEx/config/valheimtotems.totempins.cfg. Unless a setting says otherwise, only the server's value matters: players get it from the server automatically. The server picks up changes to the file without a restart.
General
| Setting | Default | Description |
|---|---|---|
Enabled |
true |
Turns TotemPins on or off. |
LocationPrefix |
VV_TravelTotemLocation |
Locations whose name starts with this get a pin. |
UseTravelTotemsIcon |
true |
Uses the Travel Totems icons. Needs TotemPins on the server and every player. |
IconName |
StartTemple |
Vanilla icon to use when UseTravelTotemsIcon is false. |
Pins
| Setting | Default | Description |
|---|---|---|
PinStyle |
Discoverable |
Icon for totems nobody has unlocked. Discoverable is Travel Totems' grey icon. Unlocked is the normal totem icon. |
SmallPins |
true |
Draws pins at normal pin size. Set false for the large trader-icon size. |
HideDuplicatePins |
true |
Hides Travel Totems' own grey pin where a TotemPins pin already marks the same totem. |
Unlocks
| Setting | Default | Description |
|---|---|---|
ShareUnlocks |
true |
When one player unlocks a world totem, unlock it for every player. The unlock is added to each character, just as if they'd walked there. |
ShareBuiltTotems |
false |
Also share unlocks of totems players have built. When false, built totems stay per player. |
Travel Totems
These override Travel Totems' own player settings for everyone. PlayerChoice leaves each player's Travel Totems setting alone.
| Setting | Default | Description |
|---|---|---|
ShowMapPins |
On |
On always shows totem pins on the map. Off shows them only while using a totem. |
ShowDiscoverableMapPins |
On |
Grey pins for totems a player knows about but hasn't unlocked. |
AdminBypass |
PlayerChoice |
Off makes admins unlock totems like everyone else. On lets admins use and change every totem. Only affects server admins. |
Debug
| Setting | Default | Description |
|---|---|---|
LogIconNames |
false |
Player setting. Writes every map icon name the game knows to the log. |
To make every totem require a visit, keep Travel Totems' TotemAccessDefault at FindUnlock (the default; Travel Totems syncs it from the server). Also set TotemPins' AdminBypass to Off if admins shouldn't skip it.
Vanilla icon mode: with UseTravelTotemsIcon = false, players without TotemPins can see the pins using a vanilla icon. Unlock sharing and the setting overrides still need TotemPins on players. If you use StartTemple, set Travel Totems' AllowSelectDefaultSpawn to false. Otherwise the pins become selectable as spawn points on the travel map.
How it works
- On the server, TotemPins switches on Valheim's "show icon once placed" for Travel Totems locations. The server generates the world around every player and sends its location icon list to everyone, which keeps all players' pins the same.
- Each player's game sends its Travel Totems unlock list to the server whenever it changes.
- The server saves those unlocks in the world, on Travel Totems' tracker object. It drops unlocked totems from the icon list and renames the rest to a neutral name. It then sends everyone its settings and the shared unlocks.
- Each player's game adds the shared unlocks to the character, applies the server's settings to Travel Totems, and draws the pins with the Travel Totems icons.
Limitations
- Travel Totems only draws its own pins for totems a player's game knows about, and it may not know about totems in areas generated far from anyone. That's the gap TotemPins pins cover, but once a totem is unlocked, its normal pin can take a moment to show up for other players.
- Shared unlocks are saved to each character. They stay unlocked for that character in that world, even if TotemPins is removed later.
Compatibility
- Built for Valheim 1.0, with BepInExPack 5.4.23.x and Travel Totems 1.0.2.
- TotemPins hooks a few Travel Totems functions. A future Travel Totems update could break the unlock sharing and setting overrides, and TotemPins logs a warning if it does.
Credits
Travel Totems is made by OrianaVenture (VentureValheim). TotemPins is an unofficial add-on.