Valheim
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
Downloads
141
Size
75KB
ADDatHost Valheim hosting
30% off

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

  1. 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.
  2. Each player's game sends its Travel Totems unlock list to the server whenever it changes.
  3. 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.
  4. 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.

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.