You are viewing a potentially older version of this package. View all versions.
DrakosDJ-BifrostBeacon-1.0.2 icon

BifrostBeacon

Heimdall is keeping his eye on you. Set persistent 3D waypoints on map pins with vertical shifting rainbow beams, configurable proximity beeping, and zoom-scaled toggle controls.

Date uploaded 2 weeks ago
Version 1.0.2
Download link DrakosDJ-BifrostBeacon-1.0.2.zip
Downloads 75
Dependency string DrakosDJ-BifrostBeacon-1.0.2

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2333 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2333

README

Bifröst Beacon

Heimdall is keeping his eye on you.

Bifröst Beacon is a Valheim utility mod that allows you to set any map pin as a persistent 3D waypoint. When active, it projects a beautiful, vertical shifting rainbow beam from the target pin directly into the sky, plays configurable proximity audio beeps as you approach, and automatically turns off once you reach your destination. In multiplayer, it automatically synchronizes waypoints and beeps across players.

Features

  • Map Pin Waypoint Selection: Hold your configurable modifier key (default LeftShift) and middle-click on a map pin to set it as your active waypoint beacon.
  • Precise Zoom-Scaled Toggles: Pin selection scales dynamically with the map's current zoom level. Click directly on a pin to set it, click it again to clear it, or click in empty space next to it to easily toggle the waypoint off.
  • Persistent 3D Waypoint & HUD Info: Displays the waypoint name, horizontal distance, and vertical height difference (e.g. Home\n123m, +5m) in the world space HUD. Unlike normal pings, this text remains persistent.
  • Animated Rainbow Light Column: Projects a vertical shifting rainbow light beam from the waypoint coordinates up to 1000m in the sky, making it visible from anywhere in the world.
  • Configurable Proximity Beeps: Plays wishbone-like audio beeping that speeds up and gets sharper as you get closer to the destination. It uses a pitched-up tone to prevent confusion with standard silver/treasure wishbone sounds.
  • Auto-Disable: The waypoint automatically turns off and notifies you once you arrive within 5.0 meters of the coordinates.
  • Multiplayer Sync & Name Identification: Automatically broadcasts your beacon to other players in multiplayer. Your HUD waypoints automatically append your character name (e.g., Base (Thor)), allowing players to easily identify whose beacon is whose.
  • Beep Perception Replication: When you approach your beacon, you emit beeps and a visual ping cue on your character. Nearby players will naturally hear and see these cues emitting from your character model at your custom configured pitch.

Compatibility

  • Standard Map Pins: Works with all vanilla map pins and mods that register their icons as standard Minimap.PinData entries (such as AutoMapPins).
  • Non-Standard Overlays (e.g. XPortal): Mods like XPortal that draw custom portal icons directly over the map without registering them in the standard Minimap.PinData registry are not compatible. The beacon cannot lock onto these icons because they do not exist in the game's map pin registry.

Installation

Bifröst Beacon requires BepInEx to run.

  1. Install BepInExPack Valheim.
  2. Place BifrostBeacon.dll and icon.png into the BepInEx/plugins/ directory (or download directly via r2modman).

Configuration

You can customize the mod's behavior by editing BepInEx/config/com.drakosdj.bifrostbeacon.cfg (or using the in-game Configuration Manager / r2modman's Config Editor).

Keybinds

  • ModifierKey: The modifier key held during map middle-click to set or toggle the beacon waypoint (default: LeftShift).

General

  • ModEnabled: If true, the entire mod is active. If false, disables all beacons, visual beams, and audio sounds (default: true).
  • ShowHudMessage: If true, displays the distance and height difference to the beacon on the 3D HUD waypoint text (default: true).
  • ShowVisualBeam: If true, projects the vertical shifting rainbow light beam from the beacon waypoint (default: true).

Audio

  • PlayAudioBeeps: If true, plays proximity audio beeps that speed up as you approach (default: true).
  • AudioRange: Maximum distance in meters at which the proximity audio beeping starts (default: 100.0).
  • AudioPitch: Pitch of the proximity audio beep. 1.0 is the default wishbone pitch; the default is 1.5 for a sharper, distinct magical chirp.

Multiplayer

  • ShowPeerHudMessage: If true, displays other players' active waypoints on your 3D HUD (default: true).
  • ShowPeerVisualBeam: If true, projects vertical rainbow light beams from other players' waypoints (default: false).

Discord

Join our Discord Server for discussion, suggestions, and bug reports!

CHANGELOG

1.0.2

  • Added multiplayer network synchronization of beacons using ZRoutedRpc so players can see each others' waypoints and hear beeps.
  • Added configuration option to globally enable or disable the mod.
  • Added configuration options to toggle visibility of other players' HUD messages and visual multicolor beams (beams default to false).
  • Appended the player's character name to HUD waypoint text (e.g. Waypoint (Name)) for both local and peer beacons.
  • Ensured peer beacons always play proximity audio beeps directly on their respective player characters using their custom configured pitch.
  • Fixed cleanup hooks to clear peer waypoints and visual objects when other players disconnect.

1.0.1

  • Fixed a bug where the beacon would get cleared when other players in multiplayer disconnected, died, or went out of range.
  • Moved world cleanup hook to ZNet.OnDestroy to prevent active beacons from clearing on local player death.
  • Guarded waypoint auto-disable so that teleporting or being dead does not prematurely clear nearby beacons.
  • Added visual beam auto-recreation to recover if the beam GameObject is destroyed during teleportation or scene load.

1.0.0

  • Initial release.