Mods / Status Hud Continued

Category: #QoL #Utility
Author: Gravydigger
Side: Client
Created: Jan 5th at 9:40 AM
Last modified: Jan 18th at 11:33 AM
Downloads: 5722
Follow Unfollow 224

Latest file for v1.19.0: 1-click install

A continuation of Rangelost's original Status HUD:

This is a not-so-simple mod with the objective of relaying information to the player. If your character can feel it, then you should see it.

Now configurable in-game with a GUI! Requires ConfigLib as a dependancy. Press [P] to configure in-game!
For those wanting a version without dependancies, you can find it here (althought updated less frequently).

Works on both singleplayer & multiplayer!


Status HUD Continued offers a collection of various elements to display on the HUD. The available elements are:

  • altitude: displays the player's current height (in meters) in relation to sea level;
  • armour: displays the equipped armour durability average (in %). If there is no armour equipped, this element is hidden;
  • bodyheat: displays the player's current drop in body heat. If it is at normal body head (37°C), this element is hidden);
  • compass: displays the player's current facing direction (in degrees) in relation to the north;
  • date: displays the current date (e.g. 1 Jul) and an icon for the current season (sprout for spring, sun for summer, leaf for autumn, and snowflake for winter);
  • durability: displays the currently selected item's remaining durability. If there is no durability, this element is hidden;
  • latitude: displays the player's current latitude (in degrees);
  • light: displays the light level at the currently selected block. If no block is selected, this element is hidden;
  • ping: displays your server ping in milliseconds. If you are on singleplayer, this element is hidden;
  • players: displays the number of players currently online;
  • riftactivity: displays the number of hours until the next change in activity, and changes icons depending on the current activity. If rifts are turned off, this element is hidden. When adding this element to the HUD, a reload may be required;
  • room: displays a house icon when the player is inside a room (house for large room, cabin for small room or cellar), and a sun icon above when inside a greenhouse. If the player is outside, this element is hidden;
  • sleep: displays a countdown until the next time the player is able to sleep. If the player can sleep, this element is hidden;
  • speed: displays the player's current speed (in m/s);
  • stability: displays the temporal stability (e.g. 76%) at the player's position if it is below 150%. If the temporal stability is 150%, this element is hidden;
  • tempstorm: displays a timer when a temporal storm is approaching or in progress. Otherwise, this element is hidden. When adding this element to the HUD, a reload may be required;
  • time: displays the current time (e.g. 19:43) and an icon for the position of the sun relative to the horizon. Support both 24 & 12 hour time;
  • time-local: displays the system's local time;
  • weather: displays the current temperature (e.g. 21°C) and an icon for the current condition (clear, fair skies, cloudy, rain, snow or hail). Supports multiple temperature scales;
  • wet: displays how wet (e.g. 72%) the player is. If the player is dry, this element is hidden;
  • wind: displays the current wind speed (e.g. 20%) and direction at the player's position.

Active elements are bound to an identifier. Only one element can be bound to an identifier at a time, and only one instance of an element can be active at a time.

Note: A default layout is installed on first run. Use the commands listed below or in the in-game GUI (Press [P]) to customize the elements to your liking.


Note: Commands remain as legacy functionality for those familiar with them. It is strongly recommended to use the in-game GUI (Press [P]) to configure your HUD.

The available commands are:

  • .shud default
    Reverts to the default layout.
  • .shud set [#] [element]

    Activates the element [element] and sets its identifier to [#].

    Variable Description Values
    [#] Identifier. Non-zero integer between -16 and 16
    [element] Element name. See Description section for list of possible values
  • .shud unset [#]

    Deactivates the element with the identifier [#].

    Variable Description Values
    [#] Identifier. Non-zero integer between -16 and 16
  • .shud clear
    Deactivates all elements from all identifiers at once.
  • .shud pos [#] [halign] [x] [valign] [y]

    Sets the position of the element with the identifier [#].

    Variable Description Values
    [#] Identifier. Non-zero integer between -16 and 16
    [halign] Horizontal alignment. left, center or right
    [x] Offset from horizontal alignment. Any number
    [valign] Vertical alignment. top, middle or bottom
    [y] Offset from vertical alignment. Any number
  • .shud repos [#]

    Resets the position of the element with the identifier [#].

    Variable Description Values
    [#] Identifier. Non-zero integer between -16 and 16
  • .shud list
    Lists all currently active elements and their identifier.
  • .shud info [element]

    Displays the element [element]'s description.

    Variable Description Values
    [element] Element name. See Description section for list of possible values
  • .shud hidden [value]

    Shows or hides hidden elements.

    Variable Description Values
    [value] Visibility value. show or hide
  • .shud options [option] [value]

    Configure's the formats the elements display.

    .shud options timeformat [value]

    Set element's time to either 24 or 12 hour time.

    Variable Description Values
    [value] Time format. 24hr or 12hr
    .shud options tempscale [value]

    Set element's temperature scale to either Celsius, Fahrenheit or Kelvin.

    Variable Description Values
    [value] Temperature scale. C,F, or K
  • .shud help
    Displays a summary of these instructions and the list of available elements.


These examples all use the identifier 1 for simplicity's sake, but you can use another identifier of your choice.

  • To remove all default elements and start from scratch, use:
    .shud clear

  • To restore the default layout, use:
    .shud default

  • To recreate the Room Indicator mod with no changes, use:
    .shud clear
    .shud set 1 room

  • To display your computer's time in the bottom-right corner of the screen, use:
    .shud set 1 time-local
    .shud pos 1 right 24 bottom 12


Upon running the mod, a statushud.json config file will be created or updated in the game's ModConfig directory. The available options are:

Variable Description Values Default value
iconSize Icon size (in px). Any number 32
showHidden Show hidden elements. true to show, false to hide false
text/colour/r Text colour's red value. Between 0.0 and 1.0 0.91
text/colour/g Text colour's green value. Between 0.0 and 1.0 0.87
text/colour/b Text colour's blue value. Between 0.0 and 1.0 0.81
text/colour/a Text colour's alpha value. Between 0.0 and 1.0 1.0
text/size Text font size (in pt). Any number 16.0
text/bold Text boldness. true for bold, false for normal true
text/offsetX Text horizontal offset (in px). Any number 0.0
text/offsetY Text vertical offset (in px). Any number -19.0
text/align Text alignment. 0 for left, 1 for right, 2 for center 2
months Month names. 12 strings (3 chars max recommended) "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"
The temperature scale used. Either C, F or K C
options/timeFormat Display the time in 24 hour or 12 hour time. Either 24hr or 12hr 24hr
compassAbsolute Make compass element's needle point to the player's absolute direction. true for absolute direction, false for relative north false
elements Element save data. - -
installed Whether or not mod has been run at least once. true if installed, otherwise false false


Creating your own icon pack
  • In your Mods folder (.../VintagestoryData/Mods/), create a new folder with the name of your choice. In this example, it will be called myiconpack;
  • In this new myiconpack folder, create a file called modinfo.json, and open it in the text editor of your choice;
  • In this new modinfo.json file, enter the following:
    	"type": "theme",
    	"name": "My Icon Pack",
    	"modid": "myiconpack",
    	"version": "1.0.0",
    	"authors": ["Your name here"],
    	"description": "This is my icon pack!",
    	"side": "Client",
    	"dependencies": { 
    		"statushudcont": "1.0.0"
    Note: You can edit the name, modid, authors and description fields to your liking in accordance with the Vintage Story Wiki.
  • Save the changes and close the modinfo.json file;
  • Open this mod's file, copy the assets folder into your myiconpack folder, then close the file;
  • You should now have all texture files available in .../myiconpack/assets/statushudcont/textures/ ready to be modified. Edit one of them to your liking;
  • When you next launch Vintage Story, make sure that your mod is enabled in the Mod Manager. Your edited icon should now replace the default one. Congratulations, you have created an icon pack!
  • Notes:
    • While you can create icons of any size, they will utlimately be resized to squares matching the specified size in the configuration file.
    • If an icon is missing from your pack, then the default will be used 24 bottom 12

Version For Game version Downloads Release date Changelog Download 1-click mod install*
v2.1.1 4257 Jan 18th at 11:33 AM Show Install now
v2.1.0 488 Jan 9th at 11:10 PM Show Install now
v2.0.3 120 Jan 9th at 9:40 AM Show Install now
v2.0.1 154 Jan 8th at 11:48 AM Show Install now
v2.0.0 85 Jan 8th at 8:16 AM Show Install now
v1.5.3 328 Jan 6th at 4:24 AM Show Install now
v1.5.2 59 Jan 6th at 3:55 AM Show Install now
v1.5.1 88 Jan 5th at 11:12 PM Show Install now
v1.5.0 143 Jan 5th at 10:45 AM Show Install now

36 Comments (oldest first | newest first)

💬 Linrox, May 12th at 4:14 AM

Has the issue that GON raised, "crashing if rifts disabled" been fixed???

💬 Alastair_Corsair, Apr 11th at 11:38 PM

Gravydigger Any word on compatibility with 1.19.7 or if that is in the works? This looks great and doesn't clutter up your screen either!

💬 GON, Apr 6th at 12:50 AM

Looks like the mod crashes and burns if you have surface rifts disabled in the world config.

5.4.2024 18:50:20 [Error] [statushudcont] An exception was thrown when trying to start the mod:
5.4.2024 18:50:20 [Error] [statushudcont] Exception: Object reference not set to an instance of an object.
at StatusHud.StatusHudText.Set(String value) in D:\Git Repositories\statushud\statushud\text.cs:line 191
at StatusHud.StatusHudRiftAvtivityRenderer.setText(String value) in D:\Git Repositories\statushud\statushud\elements\riftactivity.cs:line 149
at StatusHud.StatusHudRiftActivityElement..ctor(StatusHudSystem system, Int32 slot, StatusHudTextConfig config) in D:\Git Repositories\statushud\statushud\elements\riftactivity.cs:line 44
at StatusHud.StatusHudSystem.instantiate(Int32 slot, String name) in D:\Git Repositories\statushud\statushud\system.cs:line 107
at StatusHud.StatusHudSystem.Set(Int32 slot, String name) in D:\Git Repositories\statushud\statushud\system.cs:line 285
at StatusHud.StatusHudConfigManager.LoadElements(StatusHudSystem system) in D:\Git Repositories\statushud\statushud\config.cs:line 115
at StatusHud.StatusHudSystem.StartClientSide(ICoreClientAPI capi) in D:\Git Repositories\statushud\statushud\system.cs:line 156
at Vintagestory.Common.ModLoader.TryRunModPhase(Mod mod, ModSystem system, ICoreAPI api, ModRunPhase phase) in VintagestoryLib\Common\API\ModLoader.cs:line 660
5.4.2024 18:50:20 [Error] Failed to start system StatusHud.StatusHudSystem

💬 Tangent_Turner, Apr 3rd at 10:32 PM

I want this as well, been trying to figure out where the data is stored to have it displayed on screen.

💬 Bazim, Apr 1st at 7:33 PM

Very nice mode, thank you for that.

💬 FooSarr, Mar 18th at 8:03 AM

Hey, just having some issues with the GUI Editing feature, the mouse seems to be offset making modifying the HUD a real pain. Is there something im missing or installed incorrectly? Thanks.

💬 Bughaw, Mar 14th at 7:57 PM


Thank you for the rift activity widget.  Very useful.  Any way to turn off the timer that comes with it?

💬 UA_Shaman, Feb 23rd at 5:09 PM

Sorry, didn't really see that. Thank you. It is very nice to see that the author of the mod communicates with the players who use his mod. Keep doing this in the future

💬 GravydiggerAuthor, Feb 21st at 8:07 AM

BarenAD Sadly I do not have the time currently to delve too deep into why this is happening, as cross compatability between other mods can be rather rough to diagnose. I'll be unlikely to look into this for quite some time

Iver I'd be suprised if it wasn't compatible; minor released don't have major API changes that break things

Sp0wN I've already provided a non-gui version if you look at the comments below, but I've added a direct link in the mod description. Enjoy!

💬 UA_Shaman, Feb 17th at 9:07 AM

There is a small problem with the mod for multiplayer servers. Previously, the mod was independent and was a client mod that players installed in the mod deck. Now you need to install two more mods on the server machine in order for your mod to work properly. I have been using your mod since its release. I really like it, but unfortunately I will refuse, because for the sake of my comfort, I will not install additional mods. Is there any way to solve this issue?

💬 Iver, Feb 16th at 8:38 AM

Is it compatible with 1.19.3 Gravydigger?

💬 BarenAD, Jan 30th at 12:02 PM


hi! I found compatibility issues with the following mods: PlayerList with Status Hud Continued. See youtube video for full demonstration:
In short: in the presence of both mods and when a player is excluded, a crash occurs. But if you open the inventory, there is no problem. This is especially critical when using a the mod FairPlayGuardian because players are excluded for mods, but they crumble and cannot understand the problem.
I do not know what the problem is, so I informed both authors about it :)

💬 Saricane, Jan 25th at 7:45 AM

Thank you for for the non-gui version. Tried and adopted.

💬 DarkThoughts, Jan 21st at 5:02 PM

Great mod and replaced the simple clock mod for me. I have one critique though: The rift activity icons...

I have honestly no idea what I'm looking at and what icon represents what level of activity. It would be great to maybe have at least a screenshot on the modpage here that shows each icon and its corresponding activity.

💬 OpPointBaker, Jan 20th at 10:05 PM

Can I request that fucntionallity be added to the mod? Specificly I would like to have an element that says what the rainfail for the current location is. [i.e. very rare, rare, uncommon, common, very common, almost all the time, etc.] Either as a numeric value that the game uses internally or as a text/icon output. Like how you have weather state displayed.
Thank you. I am enjoying the mod so far. 😍

💬 GravydiggerAuthor, Jan 20th at 12:50 AM


I've made a non-gui version on the Git-hub releases page, which you can find here. Note that testing and updates will not be as frequent as the GUI version, as well as support being limited.

Hope this helps

💬 Saricane, Jan 19th at 4:17 PM

Hi Gravydigger and thanks for continuing this super mod. I just would like to use it in CLI mode only, without installing the GUI dependancies. Is this possible ? I made a test and cannot use .shud command.

💬 GravydiggerAuthor, Jan 19th at 3:48 AM


This mod has been developed and tested to work on any multiplayer server. As the mod is client-sided, it does not need to be installed on the server.

💬 SunshineFaith, Jan 19th at 12:57 AM

Will this mod work on a multiplayer hosted server?

💬 Guimoute, Jan 18th at 4:32 PM

Thank you for taking the burden and continuing this lovely mod.

💬 Edel_Recke, Jan 18th at 12:28 PM

Vilderos after downloading the dependencies ingame, i had no issues

💬 Vilderos, Jan 18th at 11:57 AM

cant get this mod to work now, missing dependencies, even tho I have configlib installed :(

💬 GravydiggerAuthor, Jan 17th at 8:58 AM


While I don't see a reason why it won't work, you might need to do some fiddling due to the dependancies for the config GUI interface to get it to work.

Officially I will not be supporting any 1.18.x version.

💬 Bughaw, Jan 17th at 8:56 AM

GravydiggerThank you so much for adding rift activity.  I can't play the RC yet, but looking forward to playing on the release.

💬 Runovaris, Jan 14th at 11:40 PM

Does this work for older versions, specifically 1.18.15? The original mod only supports up to 1.18.9.

💬 Ryjhan, Jan 14th at 2:44 PM

Mod seems to be broken in today's 1.19-RC7 build. There's no error messages or anything the game just acts as if the mod is not installed. I am using the most recent versions of configlib(0.3.3) and imgui(0.3.2). I tried rolling back to the previous versions of both StatusHUD and the two dependancies and got the same result. Rolling back the game client to the RC6 build did restore functionality.

EDIT: The RC8 build seems to have fixed the problem and mentioned a tweak to fix mod compatibility so the problem was with the game patch and not with the mod.

💬 B0bb0, Jan 9th at 11:52 PM

Gravydigger Thank you!  I also raised it with Maltiez.  I had let the client pickup the dependencies.  The configlib had an older version of IMGui specified.  Downloading the latest version of IMGui fixed it.

This looks great!  So much easier to adjust now!  Thanks for the awesome mod!

💬 GravydiggerAuthor, Jan 9th at 4:37 AM


Its an issue with configlib and not something I can fix.

Also the config from previous version should be entirely compatable with this version, as the config window only does what the commands do, just in a more friendly, real-time manner.

💬 FireFrost, Jan 9th at 3:07 AM

@CilyMe I have that on 1.18 I think it's either extra overlays or Hud CLock maybe Better Firepit? I can move over or cursor over anything cooking , crafting and it tells me the time remaining . 

💬 B0bb0, Jan 9th at 12:53 AM

Hello, just installed 'status hud continued' v2.0.1 and the associated 'config lib' and 'vsimgui' mods in 1.19-rc6. When pressing 'p' to open the config, a window appears with the text "Config lib: cursor unlock" in the header. The client log shows what looks like a hardcoded path. Note: I have the original 'status hud' config.  I can provide it if needed.  Thanks!

8.1.2024 18:27:07 [Error] [configlib] An exception was thrown when trying to start the mod:
8.1.2024 18:27:07 [Error] [configlib] Exception: Could not load type 'VSImGui.Style' from assembly 'VSImGui, Version=, Culture=neutral, PublicKeyToken=null'. at ConfigLib.ConfigWindow..ctor(ICoreClientAPI api) at ConfigLib.GuiManager..ctor(ICoreClientAPI api) in D:\Projects\Firearms\configlib\configlib\src\GUI\GuiManager.cs:line 27 at ConfigLib.ConfigLibModSystem.AssetsFinalize(ICoreAPI api) in D:\Projects\Firearms\configlib\configlib\src\ContentSettingsModSystem.cs:line 47 at Vintagestory.Common.ModLoader.TryRunModPhase(Mod mod, ModSystem system, ICoreAPI api, ModRunPhase phase) in VintagestoryLib\Common\API\ModLoader.cs:line 654
8.1.2024 18:27:07 [Error] Failed to run mod phase AssetsFinalize for mod ConfigLib.ConfigLibModSystem

💬 GravydiggerAuthor, Jan 8th at 6:25 AM


This mod doesn't not have that functionallity, and there are no plans to implement such a thing into this mod, sorry.

💬 CilyMe, Jan 7th at 5:25 PM

Looks like a great mod, I will have to give it a go! I read the description and didn't see it, but does it, or can it, diaplay the remaining time for certain things such as pit kilns? I used to mave a mod that displayed this but don't any more, and the HUD Clock mod I'm currently using doesn't have it. Thanks!

💬 Aedis, Jan 6th at 10:11 AM

Could hud also show temperature inside room if you are in one?

💬 GravydiggerAuthor, Jan 6th at 4:00 AM


Rift activity is now a new element. Enjoy!

💬 UA_Shaman, Jan 5th at 10:49 PM

Author of the original mod will no longer work on it? Have you decided to pursue his case? It's good.
I wanted to suggest adding ping to the HUD for multiplayer server players.

💬 Bughaw, Jan 5th at 7:23 PM

rift activity?

(edit comment delete)