HUD Clock

HUD Clock is a small overlay that tells you the time, the season, the weather, and a handful of other things about the world around you, without making you open a menu to find out.

It started as a community patch when the original Simple HUD Clock by Rhonen stopped getting updates. I picked it up with permission, kept it limping along through a couple of VS versions, and eventually decided the codebase needed a clean break - too many accumulated workarounds on top of an architecture that was never meant to grow this far. Version 4.0 was a rewrite from scratch for VS 1.22, rebuilding around something I could actually maintain and build upon. Each release since has added one feature group at a time without breaking what came before.

Client-side only. Multiplayer-safe. Vintage Story 1.22+.

---

What it shows

By default, the in-game date and time, current season, ambient temperature, and wind. Toggling on extra lines from the settings dialog gets you any combination of:

• Body temperature, with comfort signals (cool, freezing, warm, hot) rather than a raw number - the raw watched-attribute value disagrees with the character GUI, and HUD Clock takes the position that "you're getting cold" is more useful information than a precise wrong number.
• Apparent ("feels like") temperature, when an immersive-temperature mod is installed and providing it. Out of the box this works with Immersive Body Temperature by Cer0; other temperature mods can opt in via a small integration contract.
• Intoxication, current rainfall (mapped to vanilla's Rare/Light/Moderate/High/Very high buckets), current room type, and claim ownership.
• Online player count for multiplayer servers.
• Current rift activity - Calm through Very high, with optional always-on display when world config disables rifts.
• An approaching temporal storm warning, with its own toggleable HUD that can be parked in a different corner of the screen from the main one.

Plus a real-time clock if you want to know the actual hour, a Fahrenheit toggle, and three icon themes - Modern, Classic, and a Custom slot for anyone who wants to drop their own art in.

With HudShelf installed, both the main HUD and the storm dialog become freely draggable - press HudShelf's edit-mode hotkey, drag either panel wherever you want it on screen, and the position persists across sessions. HudShelf is optional; without it, the anchor dropdown in the settings dialog works exactly as before.

Everything is configurable from in-game without editing JSON. Open the settings with Shift+O.

---

Controls

Shift + O	Open settings
Ctrl + U	Toggle main HUD
Ctrl + I	Toggle storm HUD

All keybinds rebindable from the in-game Controls menu under "User Interface".

---

Compatibility

HUD Clock is designed to coexist quietly with other UI mods. It reads from VS's temporal-storm, rift, claim, and weather systems without modifying them, so it shouldn't conflict with mods that touch those subsystems. It runs alongside Status HUD Continued without any issue - they cover different ground and many people use both.

For temperature mods specifically, HUD Clock follows a small, vendor-neutral integration contract: any mod that publishes a few well-known watched-attribute keys gets extended body-temperature display and an apparent-temperature line for free. Cer0's Immersive Body Temperature is the first mod targeting it; the contract is documented in docs/integration.md for any other temperature-mod authors interested in opting in.

HudShelf is supported as an optional companion. Install it to drag the main HUD and storm dialog to any position on screen; uninstall it and HUD Clock's own anchor system takes over seamlessly.

---

FAQ

Why doesn't the body temperature line show a number?
Because the raw bodytemp watched-attribute value is computed differently from the number the character GUI displays, and getting the GUI's value back out would mean re-deriving the survival mod's full clothing/wetness/climate computation. Rather than show a number that disagrees with vanilla, HUD Clock shows the comfort signal - the line tells you whether you're cool or freezing, with the deviation from normal in the unit of your choice. With an immersive-temperature mod installed, the line extends symmetrically to warm and HOT.

Why is the apparent-temperature toggle there if I don't have a temperature mod?
The toggle is always visible so users with a compatible mod installed can find it. Without one, turning it on does nothing - there's no underlying value to display. Hiding settings dynamically based on which other mods are loaded would be more confusing than a dormant toggle.

Will it conflict with Status HUD Continued or Extended HUD Info?
Not in any way I'm aware of. They sit in different screen corners by default, and HUD Clock only reads from VS's data - it doesn't patch any vanilla subsystems other mods might also touch.

I'm on Vintage Story 1.20 or earlier and 4.x doesn't load.
The 4.x rewrite is for VS 1.22+. Legacy patch versions (1.0.x, 1.1.x) for older VS versions are still available in the Files tab  look for HudClockPatch_v1.x.

Can I add it to a server I don't admin?
Yes. HUD Clock is client-side only and doesn't need to be installed on the server.

---

Translations

HUD Clock currently ships with English, Spanish (Spain & Latin America), German, French, Italian, Japanese, Korean, Polish, Portuguese (Brazil & Portugal), Russian, and Ukrainian. If your language isn't listed and you'd like to contribute, the lang files are plain JSON - open an issue or send a PR on GitHub.

Thanks to everyone who's contributed translations over the years.

---

Source & support

Source is on GitHub under MIT. Bug reports and feature requests are welcome via the issue tracker - please include your VS version and any other HUD-related mods you have installed.

If you'd like to support continued development, I have a Ko-fi. The mod is and will always be free.

Original Simple HUD Clock by Rhonen. 4.x rewrite by Elocrypt.