BifrostBeacon

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.

• Install BepInExPack Valheim.
• 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 bea