MarsarahUI

Marsarah UI

Version: 1.5.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: Beyond recipe categorization used by Biome-Sorted Crafting Tabs, 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

🔧 UI Style

• Choose between 3 shared visual styles for supported UI elements, including the Information Rail, Summon Counter, Sailing HUD and Enhanced Notifications.

🔧 UI Display Mode

• Choose between Icons and Text display modes for supported UI elements, including the Information Rail, Summon Counter and Sailing HUD.

🔧 UI Animations

• Enables or disables animations for supported UI elements.

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

🔧 Portal Transition Images

• Replaces the vanilla teleport screen with custom biome-themed images showing the destination biome.
• Includes images for all nine biomes and 34 alternate biome variations.
• The images are in-game screenshots modified with AI.
• When multiple alternate biomes are active, the image is selected based on priority.
• Modes: Images, ImagesAndText, Off.
• ImagesAndText also displays the destination biome and active alternate biome names.
• Off restores the vanilla teleport screen.

🔧 Show Current Day

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