Inject0r HUD

A configurable client-side HUD for Valheim.
Timers, durability, production info, profiles and multilingual UI — without requiring anything on the server.

Issues · Installation · Controls · Roadmap

Overview

Inject0r HUD adds useful information to Valheim without trying to replace the original interface.

The mod is built around small, optional widgets that can be moved, resized and disabled independently. You can keep it minimal with a couple of timers, or turn it into a more detailed HUD with durability, FPS/Ping, profiles and contextual world information.

Everything is client-side. A normal server does not need Inject0r HUD installed.

Screenshots

HUD

Settings

Features

HUD

• Active timed positive effects.
• Equipment durability.
• Native item icons.
• Durability display as units, percent or both.
• Optional Smart Durability modes.
• Separate movable Timers and Durability blocks.
• Drag & resize directly in edit mode.
• Snap to screen edges and center.
• Adjustable scale, opacity and text size.

FPS & Ping

Small independent widgets for:

• FPS;
• network ping;
• optional labels;
• separate opacity and position.

Both widgets can be disabled completely.

World hover info

Look at an object to see extra information without opening another window.

Currently supported:

• picked berry bushes and other respawning Pickable objects;
• planted crops;
• beehives;
• fermenters;
• smelters and other compatible production stations.

Examples of information that may be shown:

• time until a bush or resource respawns;
• time until a planted crop grows;
• current honey amount;
• time until the next honey is produced;
• fermenter contents and remaining time;
• production queue;
• available fuel;
• time until the next output.

Inject0r HUD does not guess timers. If the client cannot determine a trustworthy value, the ETA is simply omitted.

Profiles

Built-in profiles are included for quick setup.

You can also:

• create your own profiles;
• save the current HUD layout and module state;
• rename and delete custom profiles;
• export a profile as a compact code;
• import a profile from another player.

Languages

Inject0r HUD has its own interface language setting.

Supported in 0.5.2:

• English — default;
• Русский;
• Қазақша;
• 简体中文;
• Auto.

Auto follows the Valheim language when that language is supported. Otherwise Inject0r HUD falls back to English.

Vanilla item names and status-effect names still use Valheim's own localization whenever possible.

Controls

While edit mode is active, HUD blocks can be dragged and resized directly on screen.

Installation

Thunderstore / r2modman

The recommended installation method is through a Thunderstore-compatible mod manager.

1. Install BepInExPack for Valheim.
2. Install Inject0r HUD.
3. Launch Valheim.

Manual installation

1. Install BepInExPack for Valheim.
2. Copy Inject0rHUD.dll into:

BepInEx/plugins/Inject0rHUD/

1. Launch the game.

The configuration file is created automatically on first run.

Configuration

Most settings can be changed live in-game through F10.

Main BepInEx config:

BepInEx/config/inject0r.Inject0rHUD.cfg

Custom profiles:

BepInEx/config/Inject0rHUD.profiles

Client-side behavior

Inject0r HUD is designed to remain read-only from the game's point of view.

It does not add:

• ServerSync;
• custom RPCs;
• world writes;
• character-save writes;
• freebuild;
• inventory modification;
• gameplay stat changes.

The mod only reads state already available to the local client and draws additional UI.

A server can still block client mods through its own whitelist or anti-cheat configuration.

Compatibility

The mod currently targets Valheim with BepInEx 5.

Some features read internal Valheim state through reflection so the mod can stay client-side and avoid unnecessary hard dependencies. If a future Valheim update changes one of those internals, the affected module should fail safely instead of modifying the world or character.

If a specific hover timer stops appearing after a game update, check for a newer Inject0r HUD release.

Building from source

Requirements:

• .NET SDK;
• Valheim;
• BepInExPack for Valheim.

PowerShell:

$env:VALHEIM_DIR = "E:\SteamLibrary\steamapps\common\Valheim"
.\build.ps1

If BepInEx is installed somewhere unusual, set BEPINEX_DIR manually.

Example:

$env:BEPINEX_DIR = "C:\Path\To\BepInEx\core"
.\build.ps1

To create the Thunderstore package after a successful Release build:

.\package.ps1

The finished archive will be created in:

dist/

Roadmap

Planned ideas for future versions:

• context widgets for ships;
• in-game day / time information;
• sunrise and sunset indicators;
• theme system;
• built-in Valheim-style theme;
• custom HUD colors;
• user-created themes;
• more languages;
• more contextual world information where the client exposes reliable data.

The goal is to keep every major module optional so the HUD can stay as simple or as detailed as the player wants.

Contributing

Bug reports and suggestions are welcome through the GitHub issue tracker:

https://github.com/Inject0r77/Inject0rHud-Valheim/issues

When reporting a bug, include:

• Valheim version;
• Inject0r HUD version;
• BepInEx version;
• whether the issue happens in single-player or on a server;
• LogOutput.log if the problem causes errors.

License

Inject0r HUD is source-available, not open source.

You may use official releases, inspect the source and make local personal modifications. Redistribution, rehosting, republishing, public forks/derivative releases, copying substantial parts into another project, and commercial use are not permitted without prior written permission.

Copyright © 2026 Inject0r77. All rights reserved.

See the full LICENSE for the exact terms.

Changelog

0.6.0

Added

• Added the new Ship Widget, shown while controlling a ship.
  • Hull health.
  • Speed in knots and m/s.
  • Wind strength and relative direction.
  • Propulsion / sail state.
  • Sail efficiency.
  • Rudder position.
• Added the new World Time Widget.
  • Current Valheim day.
  • Approximate 24-hour in-game clock.
  • Next sunrise / sunset time and countdown.
• Added independent enable/disable, opacity and positioning controls for Ship and World Time widgets.
• Added a whole-station production hover option for Smelter-based stations.
  • When enabled, production information can be viewed while aiming at the station body/output area.
  • When disabled, information is only shown on Valheim's native input/output interaction points.
• Profile export format advanced to IHUD6.
• Added profile support for Ship Widget, World Time Widget and independent Timers / Durability scales.
• Older IHUD4 and IHUD5 profile codes remain import-compatible.

Improved

• Production hover information now hooks the actual Valheim Smelter interaction callbacks.
• Smelter-based stations can show queue size, available fuel where applicable and next-output countdown when a reliable ETA is available.
• Beehive next-honey countdown now updates smoothly between Valheim's slower internal production updates using read-only projected progress.
• Improved contextual hover support without adding world writes, custom RPCs or server requirements.

Fixed

• Fixed separate Timers and Durability panels sharing the same resize scale.
• Fixed production information not appearing on Smelter-based stations because Valheim routes their hover text through separate interaction callbacks.
• Fixed duplicate production information when whole-station hover and a native interaction point overlap.
• Fixed F10 Edit Mode mouse capture / gameplay input so moving the mouse in the editor no longer rotates the player or camera.

Notes

• Windmill wall-clock ETA is intentionally omitted because its production rate changes with live wind strength.
• Inject0r HUD remains client-side only.
• No ServerSync, custom RPCs, world writes, character-save writes, inventory modification or gameplay-stat changes were added.

0.5.0

• Added a standalone Inject0r HUD localization framework.
• Added English, Russian, Kazakh and Simplified Chinese UI translations.
• English is now the default interface language.
• Added F10 Language tab with manual EN/RU/KK/ZH-CN selection and optional Auto mode.
• Added English fallback for missing translation keys.
• Localized the settings UI, HUD section labels, edit-mode helper text, diagnostics, profile UI/status messages and custom world-hover labels.
• Kept native Valheim item/StatusEffect names on Valheim's own localization path where possible.
• Added beehive hover information: honey amount and next-honey countdown using vanilla product progress and m_secPerUnit.
• Added fermenter hover information: contents and exact remaining time using vanilla GetFermentationTime() and m_fermentationDuration.
• Added Smelter-based production hover information: queue, fuel and next-output timer when a reliable ETA can be derived from vanilla bakeTimer and m_secPerProduct.
• Windmills deliberately omit the wall-clock ETA because live wind changes throughput; queue/state is still shown.
• Added separate toggles and opacity controls for beehives, fermenters and production stations.
• Profile export format advanced to IHUD5; 0.5.0 still imports older IHUD4 profile codes.
• No ServerSync, custom RPC, world writes, character-save writes or gameplay stat changes added.

0.4.2

• Removed Forsaken Power cooldown from the custom TIMERS block; Valheim already displays that cooldown in its native HUD.
• Replaced separate Rested/cooldown readers with a generic active-positive-effect timer reader.
• TIMERS now shows currently active timed positive StatusEffects and their actual remaining effect duration.
• Active Forsaken Powers now count down their active buff duration rather than the ability cooldown.
• Negative/debuff effects and permanent ttl <= 0 effects are excluded.
• Kept legacy config/profile fields internally so existing 0.4.x profile export codes remain import-compatible.
• No server-side component, ServerSync, custom RPC, world writes, or character-save writes added.

0.4.1

• Localized Rested timer names through the actual Valheim StatusEffect token.
• Localized Forsaken Power cooldown names by resolving the registered guardian-power StatusEffect from ObjectDB.
• Added safe token fallbacks for compatible/modded guardian powers.
• Replaced the fixed F10 settings body with a clipped scroll view.
• Added independent scroll position per F10 settings tab.
• Added dynamic wrapped checkbox height for long Russian labels.
• Added safer slider label spacing so Russian text cannot overlap the following control.
• No server-side component, ServerSync, custom RPC, world writes, or character-save writes added.

0.4.0

• Added native Valheim item icons to durability rows.
• Added optional Smart Durability modes: Off, BelowThreshold, CurrentItemOnly.
• Added optional CompactInCombat mode; disabled by default.
• Added built-in Minimal / Compact / Full profiles.
• Added custom profile create/save/rename/delete.
• Added live profile switching.
• Added one-line profile import/export with clipboard workflow.
• Added optional separate Timers and Durability blocks.
• Added screen-edge and screen-center snapping.
• Added per-section reset actions.
• Preserved live in-game opacity controls for bush/resource and planted-crop hover timers.
• Added Rested / Forsaken Power toggles and Timers reset to the Widgets tab.
• Added independent draggable FPS and Ping cubes.
• Added per-widget value/label/opacity settings.
• Added local network ping reading with safe fallback.
• Added F10 Diagnostics tab with mod / Valheim / Unity / BepInEx information.
• Preserved client-only operation: no ServerSync, custom RPC, world writes, or character-save writes.

0.3.0

• Added an in-game live settings panel to F10 Edit Mode.
• HUD background opacity now changes live with a slider.
• HUD scale and font size can be changed live.
• Added in-game section-header toggle.
• Added in-game durability display mode switch.
• Added in-game toggles for Rested, Forsaken Power cooldown, and durability modules.
• Split world hover timers into separate Pickable and Plant toggles.
• Added separate live opacity controls for bush/resource timers and planted-crop timers.
• Added live timer opacity previews to the settings panel.
• Added a Reset HUD Appearance button.
• Settings save when F10 Edit Mode closes.
• Remains client-side only; no ServerSync, custom RPC, world writes, or character-save writes.

0.2.1

• Fixed build against raw Valheim 1.0.14 assemblies where Pickable.m_nview, Plant.m_nview, Plant.GetGrowTime() and Plant.TimeSincePlanted() are not directly exposed to the compiler.
• World hover timers now obtain ZNetView through Unity components and call Valheim plant timing methods defensively through reflection.
• Added a fallback path for plant timing using plantTime, m_growTime, and m_growTimeMax.
• Restored the missing Inject0rHUD.Util import in DurabilityService.
• No server component, ServerSync, custom RPC, world writes, or character-save writes added.

0.2.0

• Removed active food timers from the custom HUD because Valheim already shows them in the vanilla HUD.
• Added client-side world hover timers:
  • picked/respawning bushes and other Pickable objects;
  • healthy planted crops.
• Added F10 HUD Edit Mode.
• Added mouse drag repositioning.
• Added resizing from all four edges and all four corners.
• Added gameplay-input suppression and cursor release while Edit Mode is active.
• Added persistent position/size saving.
• Added responsive value widths and ellipsis clipping so names do not overlap values at smaller sizes.
• Added a minimum readable panel width and minimum font size.
• Added Harmony reference from BepInEx core; no additional Thunderstore dependency is required.
• Still no ServerSync, custom RPC, world writes, character-save writes, or server installation.

0.1.3

• Durability is now shown as exact units by default, e.g. 200/200, instead of only 100%.
• Added Durability.ValueMode: Units, Percent, or Both.
• Made the default HUD layout more compact: smaller padding, rows, headers, bars, font, and panel width.
• Reduced default background opacity slightly.

0.1.1

• Removed the compile-time dependency on Valheim's Localization type.
• Added defensive runtime localization lookup so current/future Valheim assembly layout changes do not stop the mod from compiling.
• Localization failure is now cosmetic only; the HUD falls back to raw item tokens/names.

0.1.0

Build fix:

• Added assembly_utils.dll reference required for Valheim Localization.
• Added UnityEngine.TextRenderingModule.dll reference required for TextAnchor and FontStyle.

Initial MVP.

• Added client-only BepInEx plugin.
• Added food remaining timers.
• Added Rested remaining timer.
• Added Forsaken Power cooldown timer.
• Added equipped-item durability HUD.
• Added durability warning and critical thresholds.
• Added configurable HUD position, scale, font size and F8 visibility toggle.
• Added defensive reflection and throttled non-fatal module logging.
• Added one-click build/package PowerShell scripts.
• No Harmony patches, ServerSync, RPC, world writes or character-save writes.