Compass Waypoints and Clock

Plan your journey on the map. Follow it on the compass.

A configurable compass, in-game clock and numbered waypoint planner for Valheim. Use the compass, clock or both. Version 0.1.10 is a public beta.

Seven original map pins

Ore, Dungeon, Rune, Triangle, Square, Tree and Pig are included. Select a new icon beside the vanilla pin selector, then double-click the map and name it as usual. Rename, check, delete and save pins using the familiar game controls. Right-click one of our icon buttons to hide/show that type on the map. Triangle and Square are compact solid markers.

Choose your look in the [MapPins] config section: IconStyle = Crisp (default, sharp 128px artwork) or IconStyle = Integrated (softer 64px artwork, closer to the vanilla appearance). It applies to our seven icons on the map, picker and compass, including pins already placed. A compatible in-game config manager applies it immediately; restart after editing the config file externally. Your pin data stays unchanged.

Our picker clears the full Visible to other players control and moves aside for Cartur's picker. Our pins use the SavedPins map/compass category. Existing compass range, checked-pin exclusion and the nearest-sixteen-marker limit still apply.

Tested compatibility with Cartur's Map Pins

Gomisan gameplay-tested this release both on its own and with Cartur's Map Pins 1.8.8. Install Cartur's Map Pins separately if you want its much larger selection. Cartur's mod and icons are not included in this download. It is optional: our seven pins work without it.

Cartur's custom icons appear on the compass, including its per-pin colours, opacity and ore tints. Cartur retains control of its map styling, search and crowding. Its map colours take precedence over our category colours; our category visibility filters still apply. Cartur's custom types use our OtherPins category, and compass category colours remain a fallback when Cartur has no custom colour.

View gameplay: our pins beside vanilla markers. View compatibility capture: Cartur grid is NOT included; earlier picker layout.

The gallery includes Gomisan's gameplay captures. Any Cartur icon grid shown belongs to the separately installed Cartur mod. The compatibility screenshot shows an earlier picker position; 0.1.10 includes the corrected layout. Promotional pin artwork is illustrative, not a gameplay screenshot.

Plan a route

Open the large map and hold Ctrl + double-left-click to append a waypoint. Ctrl + right-click removes a nearby waypoint and renumbers the route. Ordinary saved pins are left alone. This plans destinations; it does not calculate paths around terrain.

The compass shows waypoint diamonds and distance to Next Waypoint. Reaching that point produces a notification and optional local arrival chime. Choose whether visited waypoints disappear or remain marked as visited. Arrival pauses while you plan on the large map. Routes are stored locally for each character and world, with up to 128 points.

Show the markers you need

Track encountered ships, carts and portals, plus known native map icons such as beds, bosses, deaths, players and saved pins. Map and compass visibility can be filtered independently for each category using Marker filters on the large map. Filters hide markers without deleting saved pins or routes.

The shared Display.CompassRange defaults to 300 metres for every compass category, including waypoints. MarkerMinSize and MarkerMaxSize set one pair of size bounds for all compass icons: defaults are 0.5 (50%) at the range limit and 1.2 (120%) nearby. Colours accept supported names or hex values.

Object markers show what your client has encountered, including dimmed last-seen positions outside the loaded area. They are not a live world-wide radar: another player may move or destroy an object while you are away. Unknown bosses and unshared player positions are not revealed.

Your clock and compass

Enable either display independently. Choose exact game time, a 12-hour clock, or vague descriptions such as early morning and midday. Compass and clock colours are independent. ClockOffset defaults to 50; smaller values move the clock closer to the compass. Heading, scale and position are configurable.

Installation and settings

Install using your Thunderstore mod manager with BepInExPack Valheim, or close Valheim and copy the ZIP's BepInEx folder into your game folder. Keep one CompassWaypointsClock.dll at BepInEx/plugins/CompassWaypointsClock/.

Configuration: BepInEx/config/au.tyvalheim.compasswaypointsclock.cfg. Edit with the game closed, or use a compatible live configuration manager. No config file is bundled, so existing preferences remain. Route and object records live beneath BepInEx/config/CompassWaypointsClock/; back up that directory before upgrading or reverting. Older releases may not read newer route formats.

Disable HUDCompass, Clock Mod or overlapping tracking displays if you see duplicate elements. This is client-side assistance and does not require installation on the dedicated server. Live mixed-client and dedicated-server compatibility testing remains ongoing.

Latest changes and beta limits

Version 0.1.10 adds the seven original pins, optional Cartur integration, selectable Crisp/Integrated artwork and corrected picker positioning. It includes the earlier font initialization fix.

Passed 67 targeted native pin/compatibility checks and 115 existing regression checks, followed by Gomisan's gameplay acceptance with and without Cartur 1.8.8. Mixed-client cartography sharing and broader multiplayer combinations remain unverified.

Keyboard and mouse are required for the current waypoint controls. Gamepad waypoint controls and route sharing remain roadmap features. The Fifth Beacon remains a separate mod.

The seven custom icon types save in the game's normal map data. Back up character/map data before removing a pin-providing mod: Valheim may convert unsupported custom icon types to its ordinary dot. See MANUAL.txt for details.

Credits and AI disclosure

Compass Waypoints and Clock was developed using AI-generated code, with all gameplay design, direction and extensive playtesting by humans. OpenAI’s ChatGPT and Codex tools were used during development, including code generation and revision, documentation and packaging. Original in-game map-pin artwork was created using OpenAI image-generation tools under Gomisan’s direction. Promotional illustrations were also created using these tools under Gomisan’s direction; these are illustrations, not gameplay screenshots. Any gameplay screenshots are unaltered.

Inspired by Neobotics' HUDCompass and aedenthorn's Clock Mod. This is an independent implementation, not an official update or bundle. Their code and artwork are not bundled; Clock Mod was consulted for time semantics without copying its implementation.

Thanks to BepInEx, Harmony, Andreas Pardeike and TextMesh Pro contributors. Valheim's native fonts/icons belong to Iron Gate AB and are referenced at runtime, not redistributed. Original pin and promotional artwork was generated with OpenAI image generation under Gomisan's direction. Gameplay screenshots were captured by Gomisan. Thanks to the authors of Cartur's Map Pins for their separately distributed mod; no Cartur code or artwork is bundled.

Discord and feedback

Nexus comments/bug reports or Discord are equally welcome. Use whichever is easier; no need to cross-post. Include the mod version, reproduction steps, solo/hosted/dedicated context, relevant other mods and BepInEx/LogOutput.log.

• Gomisan's Mods Discord
• Compass Waypoints and Clock — feedback and bug reports

New members should join using the invite before opening the direct post.

More From Gomisan

Valheim

• Reliable Cooking — Cooking speed, slots and batch output with familiar controls.
• Single Berserkir — Wield a single Berserkir axe with a shield.
• Compass Waypoints and Clock — Compass, clock, map pins and waypoint planning.
• Reliable Crafting — Craft using materials from nearby permitted containers.
• Lumaheim - Gamma and Brightness Controls — In-game brightness, colour and depth-of-field controls.
• Usain's Belt — A configurable movement-focused utility belt.
• Crow's Nest — Climb to a ship-mounted lookout on Longships and Drakkars.
• Saga Lens - Photo Mode — Capture Valheim screenshots with photo-mode controls.
• The Fifth Beacon — Coloured navigation beacons and lighthouse signals.
• Smuggler's Pouch — Carry a limited quantity of portal-restricted items through portals.
• Crude Chemistry — Craft throwable alchemical bombs.
• Scalpel's Skelly Staff — Choose and recall skeleton summons.
• RPG Equipment — Additional equipment slots and weapon sets.
• Reliable Smelting — Automate smelter supplies using nearby containers.
• Magic Hammer — Build using materials from nearby chests.
• Light Azeez Light — Keep supported decorative lights fuelled.

Going Medieval

• Faster Repairs — Speed up building repairs.
• Wild Crop Recovery — Recover crop seeds through wild plants.
• Wild Growth — Encourage natural plant regrowth.
• Wild Orchards — Wild fruit and nut trees with harvests and saplings.

0.1.10 — Seven map pins and tested Cartur compatibility

• Add Ore, Dungeon, Rune, Triangle, Square, Tree and Pig pins alongside the native selector, with normal placement, naming, checking, deletion and saving.
• Show these pins on the compass; add optional Cartur's Map Pins 1.8.8 integration for its icons, per-pin colour/opacity and ore tints. Cartur remains a separate optional download and its icons are not bundled.
• Add MapPins.IconStyle: Crisp (128px, default) or Integrated (64px, softer). Live changes refresh existing map, picker and compass icons without altering saved pin data.
• Keep our picker above the full Visible to other players control, following UI scale and avoiding Cartur's picker.
• Preserve Cartur's map styling and hidden icons, independent category visibility, and familiar Ctrl-waypoint controls.
• Passed 67 targeted checks and 115 regression checks. Gameplay tested and approved by Gomisan both standalone and with Cartur's Map Pins 1.8.8.
• Includes the previously released font initialization fix. Version 0.1.9 was an unpublished development test, superseded by this release.

0.1.8 — Font initialization fix

• Assign Valheim’s existing font before activating compass, clock, control and map-label text, preventing missing LiberationSans SDF warnings during initialization.
• Tested by Gomisan; no errors observed.
• Identical release DLL supplied on Nexus and Thunderstore.

0.1.7 — Public beta

• Global MarkerMinSize and MarkerMaxSize replace the overall marker multiplier; defaults are 0.5 far and 1.2 near.
• Marker interpolation uses the shared CompassRange, default 300 metres, including waypoints. Equal bounds give fixed size; reversed bounds are safely ordered.
• Includes the stationary-map filter refresh fix, adjustable ClockOffset (default 50), and obsolete settings cleanup while retaining supported preferences.
• Gamepad waypoint controls and route sharing remain unimplemented roadmap features.
• First Thunderstore package, based on the published Nexus 0.1.7 beta. Adds store artwork, documentation and assembly AI attribution; gameplay code is unchanged.