ValheimCompassWaypointsClock

Latest version

0.1.8

Last Updated

First Uploaded

Downloads

366

Likes

Size

223KB

Dependants

0 other mods

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.8 is a public beta.

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.8 fixes missing LiberationSans font warnings by assigning Valheim’s font before activating HUD and map text. The author tested this update and observed no errors. Version 0.1.7 introduced global minimum/maximum marker sizes. The release also includes the shared compass range, stationary-map filter refresh fix, adjustable clock spacing and cleanup of obsolete settings. Supported colour and visibility choices are retained.

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

Earlier beta validation passed 55 automated route/time/storage checks and 115 isolated Unity checks. The 0.1.8 font fix compiled with warnings treated as errors and passed author gameplay testing. These do not replace live gameplay and multiplayer acceptance. The included MANUAL.txt covers settings and known limits in detail.

Credits and AI disclosure

Concept, direction and playtesting: Gomisan. Coded with the assistance of ChatGPT 6.0. Packaging and documentation prepared with OpenAI Codex; AI attribution is included in assembly metadata.

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. Promotional artwork was generated with OpenAI image generation under Gomisan's direction and is not a gameplay screenshot.

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.

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

CompassWaypointsClock

Details

Categories