Marsarah UI

Version: 1.0.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

The config is divided into two sections:

• UI Settings (Local): Individual player preferences. These are not normally synced with the server.
• Server Overrides (Synced): Optional server-side controls for selected information-oriented features.

Server Overrides use UserChoice by default, which means the player's local setting is respected. Server administrators can change supported options to ForceOn, ForceOff, or a specific display mode where applicable. The master Enable Server Overrides option can disable the override system entirely.

The following features support server overrides:

• Enemy Detector
• Current Day
• Current Time
• Weather Forecast
• Smart Biome
• Ashlands Heat Meter
• Enemy Nameplate Mode
• Taming Progress
• Detailed Hover Information
• Container Contents

Insert toggles many of the custom HUD widgets on or off temporarily.
Home toggles the Online Players name list while keeping its 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

⚡ Main Features

🔧 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 Inventory Weight and Free Slots

• Displays current carry weight and maximum carry weight near the bottom-left HUD.
• Adds a filling weight bar that changes color as the player approaches the weight limit.
• Displays the number of free inventory slots with color feedback.

🔧 Show Enemy Detector

• Displays the number of nearby enemies within roughly 30 meters.
• Uses different symbols and colors as the number of nearby enemies increases.
• Neutral Dvergr are displayed separately until aggravated.
• Does not count other players, Deer, Hare, summoned roots, or tamed creatures as enemies.

🔧 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 Minimal Status Effects is installed 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, DayPhases, Off.
• DayPhases uses Night, Dawn, Morning, Day, Afternoon, Evening and Dusk.
• 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.
• 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 Summon Counter

• Displays the number of active summoned skeletons created by the Dead Raiser.
• Does not count summoned Trolls.

🔧 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 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.

🔧 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.

🔧 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

• Replaces the flat durability appearance with a textured, gradually colored durability bar.
• Transitions from green through yellow toward red as durability decreases.

🔧 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.
• Most progress-based hovers support remaining time, percentage, or both.

Container Hover Information:

• Can show used/max slots, free slots, or percentage filled.
• Optional Show Container Contents lists combined item stack amounts directly in the hover.
• Displays up to 10 different item types, followed by a count of additional types when needed.
• If MarsarahTweaks Progression Halt seals a chest, its contents are hidden and replaced with "This chest is sealed."

🔗 Compatibility

MarsarahTweaks

• Optional soft dependency. Marsarah UI works without Tweaks.
• Smart Biome accounts for Gear Upgrade Unlock.
• Detailed Hovers 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.

Minimal Status Effects

• Boat Speed uses an alternate position to avoid overlap.

🔮 Future Plans

Future ideas include additional hover display modes, skill progress information, improved player information, optional item icons for container contents, and additional status-effect/UI 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.