Marsarah UI

Version: 1.2.0
Author: Marsarah

🧰 About the Mod

Marsarah UI is a standalone collection of UI and information improvements for Valheim.
The features originally started as the UI section of Marsarah Tweaks and have now been separated into their own mod so players can use the interface improvements without installing the gameplay tweaks.

The mod adds useful HUD information, improved nameplates and item indicators, detailed object hovers, better loading tips, weather information, and other interface improvements. Most features can be configured independently.

Marsarah UI also includes ServerSync support for selected gameplay/information-oriented UI features. Local UI preferences remain local by default, while server administrators can optionally override selected settings.

Development Notes

Deep North / Spoiler Note: Deep North-specific UI integration is intentionally limited for now.
I want to experience the new biome and progression myself before digging through its mechanics in detail, so I can play through it without spoiling the experience for myself.
After completing the Deep North, I plan to review new gear for Smart Biome and check whether any new mechanics would benefit from additional indicators or hover information.

AI Usage Disclosure: The original UI features were developed as part of my MarsarahMod / Marsarah Tweaks projects. AI tools are now used as part of my development workflow for tasks such as debugging, refactoring, compatibility updates, researching game API changes, and documentation.
Development remains human-directed: I decide what features are added, how they should behave, and I write code, review and test the changes included in releases. The mod's logo was also created using generative AI.

Related Marsarah Mods

• MarsarahTweaks - Gameplay, balance, grind-reduction and quality-of-life tweaks. Marsarah UI includes optional compatibility with some Tweaks features.
• MarsarahBuildPieces - Custom functional and decorative build pieces, including portals, lights and the Mystical Light Ward.
• Neither mod is required to use Marsarah UI.

🔒 Permissions

Reuploading this mod, whether in part or in full, is not permitted.
Anyone is free to take inspiration or implement similar features, but must do so with their own code and assets.

🧱 Requirements

This mod requires BepInEx for Valheim, available here:
https://valheim.thunderstore.io/package/denikson/BepInExPack_Valheim/

For multiplayer servers using Marsarah UI's Server Overrides, install the mod on the server and all clients.

📦 Installation

• Unpack the .zip file and copy MarsarahUI.dll into your Valheim/BepInEx/plugins folder.
• Or use a mod manager.

If the server uses Marsarah UI Server Overrides, the mod must also be installed on the server and all connecting clients.

⚙️ Configuration

A config file is generated on first launch: Valheim/BepInEx/config/Marsarah.MarsarahUI.cfg

Most Marsarah UI settings are local and remain under each player's control. Settings can be changed through the config file or a compatible configuration manager, and most update during gameplay without requiring a restart.

Selected information-oriented features also support synchronized Server Overrides. These use UserChoice by default, allowing players to keep their local preferences unless a server administrator explicitly overrides them.

Updating from v1.0.0: The configuration layout and setting keys were reorganized in v1.1.0. Existing selections from v1.0.0 may need to be configured again after updating.

Insert temporarily toggles many custom HUD widgets. Home toggles the Online Players name list while keeping the online-player count visible.

💰 Donations

My mods are and will always be free to use. If you'd like to support my work, you can donate here:
https://paypal.me/Marsarah9

⚡ General & HUD

🔧 Better Loading Tips

• Replaces the vanilla loading-tip selection with a larger pool of more useful gameplay tips.
• Includes 51 tips covering controls, progression, combat, building, food, exploration and less-obvious mechanics.
• Intentionally leaves out several very basic vanilla tips in favor of more useful information.
• Only applies when using the English localization.

🔧 Show Boat Speed

• Displays current ship speed while controlling a boat.
• Changes color according to current speed. Reverse movement uses an R prefix.
• Repositions automatically when Status Effects Under Minimap is enabled and accounts for No Map worlds.

🔧 Show Current Day

• Displays the current world day above the minimap and continues to work in No Map worlds.

🔧 Show Current Time

• Displays the current time above the minimap.
• Modes: DigitalClock, DigitalClock12Hour, DayPhases, Off.
• DigitalClock uses a 24-hour clock.
• DigitalClock12Hour uses a 12-hour clock with AM/PM.
• DayPhases uses Night, Dawn, Morning, Day, Afternoon, Evening and Dusk.
• Day Phase coloring can be enabled or disabled independently.
• Continues to work in No Map worlds.

🔧 Show Weather Forecast Indicator

• Displays the next scheduled weather using an icon and countdown near the minimap.
• Uses weather icons embedded directly in the mod.
• If no different weather is scheduled in the forecast window, the current weather is shown with a --:-- timer.
• Supports Valheim 1.0 alternative-biome forecasting, including Dark Meadows.
• Includes mappings for weather used by Seasons and similar environment changes where supported.

🔧 Smart Biome Indicator

• Replaces the normal minimap biome text with a color-coded indicator based on equipped armor and upgrade level.
• Colors progress from purple for severely undergeared through red, orange, yellow and green for well prepared.
• Evaluates progression from Meadows through Ashlands. Other biomes display in white.
• Includes Bear, Vilebone and Lox Fur armor.
• If MarsarahTweaks is installed and Gear Upgrade Unlock is enabled, Smart Biome adjusts its expected armor ranges accordingly.

🔧 Show Online Players

• Displays the total number of online players and up to 20 player names at the bottom-right.
• Hidden when only one player is online.
• Home hides/shows the names while retaining the total online count.

🔧 Show Boss Power Expiration Message

• Displays a center-screen message when an active Forsaken Power expires.

🔧 Show Heat Meter in Ashlands

• Displays a heat meter at the top-center of the screen while relevant Ashlands water/lava heat mechanics are active.

🔧 Status Effects Under Minimap

• Moves status effects into a compact vertical layout below the minimap.
• Repositions and resizes the sailing wind indicator and sailing controls to avoid overlap.
• Boat Speed automatically moves with the adjusted sailing UI.
• Automatically restores the vanilla layout when disabled or when No Map mode is active.

🔧 Global Chat By Default

• Makes normal chat messages global by default without requiring the player to manually select Shout.
• Preserves the player's original capitalization.
• Explicit commands such as /w and /say continue to work normally.
• Supports an optional synced server override.

🔧 Logon Screen Character Statistics

• Adds an optional statistics panel to the character selection screen.
• Displays 19 character statistics covering playtime, combat, survival, crafting, homestead activities, travel and exploration.
• Also displays a conditional notable fact based on the selected character's history. This is not to be confused with the vanilla achievements.
• List of facts:
  • Unusual death facts:
    • The Forest Remembers: Killed by a falling tree at least 1 time.
    • Curiosity Won: Killed by the edge of the world at least 1 time.
    • Occupational Hazard: Killed by a cart at least 1 time.
    • Flight Test Failed: Killed by a catapult at least 1 time.
    • Workplace Safety Violation: Killed by a drawbridge at least 1 time.
    • Disposal Error: Killed by the obliterator at least 1 time.
    • Security System Working as Intended: Killed by a turret at least 1 time.
    • Captain Went Down With the Ship: Killed by a boat at least 1 time.
    • The Floor Was Lava: Killed by Ashlands lava at least 1 time.
    • Hostile Waters: Killed by the Ashlands ocean at least 1 time.
  • Repeated death facts:
    • Natural Enemy: Gravity: Died from falling at least 3 times.
    • Swimming Lessons Recommended: Drowned at least 2 times.
    • Ventilation Required: Died from smoke inhalation at least 2 times.
    • Own Worst Enemy: Died by own hand at least 2 times.
    • Fire Safety Optional: Burned to death at least 3 times.
    • Should Have Packed a Cloak: Frozen to death at least 3 times.
    • Poison Control: Died from poison at least 3 times.
  • Activity & Events facts
    • The Finishing Touch: Dealt the final blow to at least 5 bosses.
    • The Ones That Got Away: Lost at least 10 fish.
    • Odin's HR Has Been Notified: Hit a raven at least 5 times.
    • Necromancy Is a Hobby: Summoned at least 250 skeletons.
    • Retrieval Specialist: Opened at least 5 tombstones belonging to other players.
    • Born in a Barn: At least 100 more doors opened than closed, with at least 10% of opened doors left unclosed.
    • Thar She Blows: Caused at least 5 leviathans to sink.
    • Treasure Hunter: Found at least 10 treasures from buried treasure and location treasure counters combined.
      • Note: Dungeon treasure is intentionally excluded.
    • Captain: Traveled at least 100 km while sailing at the helm.
    • Measure Twice, Build Once? Built at least 100 pieces and removed at least 50% as many pieces as were built.
  • Level 100 skill facts:
    • Mountain Goat: Jump level 100.
    • Still Faster Than a Boat: Swim level 100.
    • You Were Never Here: Sneak level 100.
    • The Forest Definitely Remembers: Wood Cutting level 100.
    • Professional Rock Argument: Pickaxes level 100.
    • Not Today: Blocking level 100.
    • Cardio Is a Lifestyle: Run level 100.
    • Fish Fear Me: Fishing level 100.
    • Born in the Saddle: Ride level 100.
    • Outstanding in the Field: Farming level 100.
    • Yes, Chef: Cooking level 100.
  • Master Skill fact:
    • Master of Everything: Every vanilla skill has reached level 100.
    • When Master of Everything qualifies, the individual level 100 skill facts are not added to the random pool. Master of Everything represents the achievement instead.

⚡ Information Rail

🔧 Information Rail

• Adds a unified information area at the bottom-left of the HUD.
• Inventory Weight, Free Slots, Enemy Detector and temporary Skill Progress information use the Information Rail.
• Temporary elements animate smoothly into and out of the rail as they become relevant.
• Includes 3 selectable visual styles with different backgrounds, borders, icons and colors.
• Display Mode can use Icons or Text.
• The Enemy Detector can optionally be moved out of the rail to a separate top-center display.
• The Summon Counter remains separate but follows the selected Information Rail style and Icons/Text mode.

🔧 Inventory Weight and Free Slots

• Displays inventory information inside the Information Rail.
• Modes: WeightAndFreeSlots, WeightOnly, FreeSlotsOnly, Off.
• Weight uses a filling bar and current/max weight display.
• Free Slots shows remaining inventory slots.
• Colors and presentation follow the selected Information Rail style.

🔧 Enemy Detector

• Counts nearby characters within 30 meters.
• Modes: Consolidated, Split, Off.
• Consolidated combines hostile enemies into a single counter.
• Split separates normal, tough and boss enemies into individual counters.
• Bosses and minibosses count as normal enemies while using Consolidated mode.
• Neutral Dvergr are shown separately until aggravated.
• Other players, Deer, Hare, Kvastur, summoned roots, T.W.I.G. and tamed creatures are excluded from the hostile count.
• Enemies in the tough category are: Troll, Bjorn, Abomination, Writhan, Stone Golem, Fuling Berserker, Vile Bear, Seeker Soldier, Gjall, Fallen Valkyrie, Morgen, Serpent and Bonemaw
• Can be displayed inside the Information Rail or moved to a separate top-center display.
• Uses the selected Information Rail visual style and Icons/Text display mode.

🔧 Show Summon Counter

• Displays the number of active summoned skeletons created by the Dead Raiser.
• Does not count summoned Trolls.
• Appears only while summons are active.
• Uses the selected Information Rail visual style and Icons/Text display mode.

🔧 Skill Progress Bar

• Displays a temporary progress bar along the bottom edge of the screen when a skill advances to a new whole percentage toward its next level.
• Skill level and progress percentage appears temporarily in the Information Rail.
• Icons mode uses the skill's actual in-game icon; Text mode displays the skill name.
• Run skill progress is intentionally excluded.
• Colors: Gold, White, Green, Blue, Cyan, Red, Purple.
• Selecting Off disables the feature.

⚡ Items & Interaction

🔧 Show Owned Resources In Build Menu

• Displays resource requirements as required / owned values in build and crafting requirement displays.
• Example: 2/20 when 2 Wood is required and 20 is owned.
• Automatically steps aside when Craft From Containers is installed.

🔧 Enemy Nameplate Mode

• Reworks character nameplates with larger health bars, clearer colors and increased display distance.
• Bosses, enemies, neutral/tamed characters, normal players and PVP-enabled players use distinct colors.
• Alerted and aggravated states change creature-name colors.
• Modes: BarsOnly, BarsWithHealth, BarsWithPercent, BarsWithBoth, Off.

🔧 Show Taming Progress

• Displays the current taming percentage beneath the creature's health bar while an animal is acclimatizing.
• Works independently of Enemy Nameplate Mode.

🔧 Item Quality Indicator

• Replaces the vanilla item-quality number with repeated symbols.
• Layouts: Horizontal, Vertical, Off.
• Symbols: Star ★, Circle ●, Diamond ◆, Empty Diamond ◇.
• Colors: White, Yellow, Green, Red, Blue, Cyan.

🔧 Better Item Durability Bar

• Uses a textured durability bar that transitions from green through yellow toward red as durability decreases.

⚡ Detailed Hovers

🔧 Detailed Hover Information

• Adds additional information to Containers, Beehives, Plants, Fermenters, Cooking Stations/Ovens, Smelters and similar processing stations, and Eggs.
• Master modes: ColoredText, WhiteText, Off.
• Each supported hover type can also be disabled individually.
• Most progress-based hovers support remaining time, percentage, or both.

Container Hover Information:

• Can show used/max slots, free slots, percentage filled, or be disabled independently.

• Container Contents Mode supports:

  • IconsHorizontal - actual item icons in a 5x2 layout.
  • IconsVertical - actual item icons in a 2x5 layout.
  • Text - aligned item quantities and names.
  • Off - disables contents display.

• Multiple stacks of the same item are combined.

• Displays up to 10 different item types with +N Others for additional types.

• If MarsarahTweaks Progression Halt seals a chest, its contents are hidden and replaced with "This chest is sealed."

• Custom container information and contents are only shown when the local player has access to the container.

• Containers protected by another player's Ward do not reveal their contents.

• Other players' Personal Chests retain their vanilla hover and do not reveal their contents.

• Conflicts:

  • StoreAndCraft chest labels or tags may not display as expected with Container Hover Mode enabled. If this occurs, set Container Hover Mode to Off.
  • Icon-based Container Contents can overlap StoreAndCraft's additional hover text. Use Text or Off for Container Contents if needed.

🔗 Compatibility

MarsarahTweaks

• Optional soft dependency. Marsarah UI works without Tweaks.
• Smart Biome accounts for Gear Upgrade Unlock.
• Detailed Hovers / Container Contents respects Progression Halt and will not reveal sealed chest contents.

Craft From Containers

• Marsarah UI steps aside and lets Craft From Containers handle the Owned Resources display.

🔮 Future Plans

Future ideas include additional hover display modes, improved Online Players information, additional UI indicators, and other interface improvements.

Deep North-specific UI changes will be reviewed after I have completed the biome myself.

💬 Feedback

Suggestions and bug reports are welcome on the Posts or Bugs tabs of the Nexusmods page.
Thanks for checking out Marsarah UI!

🧑‍🤝‍🧑 Credits

Blaxxun-bloop - for ServerSync

📜 Version History

Check the Changelog tab.

📜 Version History

v1.2.0

• Fixes/Optimizations:

  • Fixed Enemy Nameplates causing periodic stutters around nearby creatures.
  • Optimized Enemy Nameplate HP text creation by caching reused font and material resources and avoiding unnecessary mesh rebuilds.
  • Prevented duplicate Enemy Nameplate setup and unnecessary HP text creation in Bars Only mode.
  • Improved Enemy Nameplates config-off behavior so disabled nameplates stop unnecessary processing.
  • Reduced unnecessary background processing across multiple UI features when they are disabled.
  • Cached frequently used reflection lookups across several UI modules.
  • Reduced repeated UI creation and cleanup work.

• Current Time:

  • Added a 12-hour digital clock mode with AM/PM.
  • Added an option to disable Day Phases coloring.
  • Removed the "Time" label from digital clock displays for a cleaner layout.

• Detailed Hovers:

  • Added individual Off options for Container, Beehive, Plant, Fermenter, Cooking Station, Smelter and Egg hover information.
  • Detailed Hover Information remains available as the global master setting.

• Enemy Detector:

  • Kvastur is now excluded from the nearby enemy count.

v1.1.1

• Fixes/Updates:

  • Excluded the T.W.I.G. training dummy from the Enemy Detector.
  • Fixed Cooking Station detailed-hover timers for non-owner clients on dedicated servers.
  • Detailed Hovers no longer reveal container contents when the container is protected by another player's Ward.

• Compatibility:

  • Updated compatibility with Marsarah Tweaks mod to account for the new configuration naming and ordering.

v1.1.0

• Fixes/Updates:

• Better Item Durability Bar:

  • Fixed durability styling being applied to the wrong quickslot when empty quickslots appeared before an item.
  • Fixed the original durability-bar sprite not being restored correctly when Better Item Durability Bar was disabled.

• Weather Forecast:

  • Updated weather forecasting for Valheim 1.0's BiomeSector / AltBiome weather system.
  • Added proper alternative-biome forecasting support, including Dark Meadows.

• New Features:

• Information Rail:

  • Reworked the bottom-left information area into a unified Information Rail.
  • Inventory Weight, Free Slots, Enemy Detector and Skill Progress information now share the rail.
  • Added animated transitions as temporary elements appear and disappear.
  • Added three selectable Information Rail visual styles with different backgrounds, borders, icons and colors.
  • Added Icons and Text display modes.
  • Summon Counter remains a separate display but now follows the selected Information Rail style and Icons/Text display mode.
  • Added a server override for Information Rail Display Mode, allowing servers to use UserChoice, Icons or Text.

• Enemy Detector:

  • Added Consolidated and Split display modes.
  • Consolidated mode counts nearby hostile enemies together.
  • Split mode separates normal, tough and boss enemies into individual counters.
  • Bosses and minibosses are included in the normal enemy count while using Consolidated mode.
  • Neutral Dvergr continue to use their own counter until aggravated.
  • Added an option to move the Enemy Detector from the Information Rail to a separate top-center display.
  • The separate Enemy Detector display follows the selected Information Rail visual style and display mode.
  • The normal enemy counter no longer remains visible when no enemies are nearby.

• Status Effects Under Minimap:

  • Added an optional compact vertical status-effect layout below the minimap.
  • Sailing wind and control UI is repositioned to the left of the minimap and resized while the layout is active.
  • Boat Speed automatically moves with the adjusted sailing UI.
  • The vanilla layout is restored when the feature is disabled or when playing with No Map enabled.

• Global Chat By Default:

  • Added an option that sends normal chat input globally by default.
  • Preserves the player's original capitalization instead of converting Shout messages to uppercase.
  • Explicit chat commands such as /w and /say continue to work normally.
  • Added a synced server override with UserChoice, ForceOn and ForceOff.

• Skill Progress Bar:

  • Added a temporary full-width progress bar along the bottom edge of the screen when skill progress crosses a whole percentage toward the next level.
  • Skill level and progress percentage are displayed temporarily in the Information Rail.
  • Supports both Information Rail Icons and Text display modes.
  • Icon mode uses the skill's actual in-game icon.
  • Progress from the same or another skill refreshes the current display instead of stacking notifications.
  • Run skill progress is intentionally excluded.
  • Added selectable bar colors: Gold, White, Green, Blue, Cyan, Red and Purple.
  • Added Off directly to the color selection to disable the feature.

• Logon Screen Character Statistics:

  • Added an optional Character Statistics panel to the character selection screen.
  • Displays playtime together with combat, survival, crafting, homestead, travel and exploration statistics for the selected character.
  • Added a collection of conditional notable character facts based on unusual deaths, activities, events and mastered skills.
  • These notable facts are not the same as the vanilla achievements.
  • Eligible facts are selected randomly when switching characters.
  • Individual level-100 skill facts are replaced by Master of Everything when every vanilla skill has reached level 100.

• Container Contents:

  • Renamed Show Container Contents to Container Contents Mode.
  • Added IconsHorizontal, IconsVertical, Text and Off modes.
  • Icon modes use actual vanilla or modded item icons with combined stack totals.
  • Horizontal mode uses a 5x2 layout and Vertical mode uses a 2x5 layout.
  • Displays up to 10 unique item types with +N Others for additional types.
  • Improved Text mode alignment for item quantities and names.
  • Default mode is now IconsHorizontal.
  • MarsarahTweaks Progression Halt compatibility continues to prevent sealed chest contents from being revealed.
  • Added container access checks so custom hover information and contents are only shown when the local player has permission to access the container.
  • Other players' Personal Chests retain their vanilla hover and do not reveal their contents.

• Configuration:

  • Reorganized local settings into General & HUD, Information Rail, Items & Interaction and Detailed Hovers categories.
  • Server Overrides now use their own fifth synchronized category.
  • Removed numeric prefixes from individual setting names while retaining ordered categories.
  • Added Configuration Manager ordering metadata without requiring Configuration Manager as a dependency.
  • Added Information Rail Display Mode to the available server overrides.
  • Added Global Chat By Default to the available server overrides.
  • Note for users updating from v1.0.0: config sections and setting keys were reorganized in v1.1.0, so previous selections will need to be configured again.

v1.0.0

• Initial standalone release.

• Standalone UI Mod:

  • Moved the UI features previously included in Marsarah Tweaks into the standalone MarsarahUI mod.
  • Removed the old alternate UI layout system and retained the preferred UI layout.
  • Added ServerSync support for optional server-side overrides while keeping normal UI preferences local to each player.

• Server Overrides:

  • Added a master Enable Server Overrides setting.
  • Added optional server overrides for Enemy Detector, Current Day, Current Time, Weather Forecast, Smart Biome, Ashlands Heat Meter, Enemy Nameplate Mode, Taming Progress, Detailed Hover Information and Container Contents.
  • Override settings default to UserChoice so players keep their local preferences unless the server explicitly overrides them.

• HUD / Information Features:

  • Better Loading Tips with a curated pool of 51 gameplay tips.
  • Inventory Weight and Free Slots.
  • Enemy Detector.
  • Boat Speed.
  • Current Day.
  • Current Time with Digital Clock and Day Phase modes.
  • Weather Forecast with embedded weather icons.
  • Smart Biome Indicator.
  • Summon Counter.
  • Online Players.
  • Show Owned Resources in build and crafting menus.
  • Boss Power Expiration Message.
  • Ashlands Heat Meter.

• Interface Improvements:

  • Enemy Nameplate display modes with health values/percentages and improved colors.
  • Taming Progress.
  • Item Quality indicator layouts, symbols and colors.
  • Better Item Durability Bar.
  • Detailed Hover Information for Containers, Beehives, Plants, Fermenters, Cooking Stations/Ovens, Smelters/processing stations and Eggs.
  • Optional Container Contents display.

• Compatibility:

  • MarsarahTweaks Smart Biome compatibility for Gear Upgrade Unlock.
  • MarsarahTweaks Progression Halt compatibility prevents sealed chest contents from being revealed.
  • Craft From Containers compatibility for Owned Resources display.
  • Minimal Status Effects compatibility for Boat Speed positioning.

• Valheim 1.0 Updates:

  • Added the Lox Fur set to Smart Biome Plains weighting.
  • Better Loading Tips updated with additional useful gameplay tips.