MarsarahTweaks

Marsarah Tweaks

Version: 1.8.3 Author: Marsarah

---

🧰 About the Mod

Marsarah Tweaks is a modular and optimized port of my previous project, MarsarahMod. It features numerous code improvements, cleaned-up logic, and ServerSync integration. This mod changes many aspects of the game so it's advised to look through and read the description or the config file, to decide which features to enable and which to turn off. Each feature is grouped into sections to make this process easier. In addition, the mod scans for already installed mods and automatically disables its own relevant configs if it finds mods that are incompatible or that may cause issues together. If any issues or incompatibilities are found, please post them on the mod's Nexus page.

⚠️ Upgrade Note: The custom build pieces and UI features previously included in Marsarah Tweaks have been moved into their own standalone mods. MarsarahBuildPieces now contains the Pocket Portal, Extra Lights, Glacial Stone Portal, Mystical Light Ward, and other custom build-piece functionality. MarsarahUI now contains the UI features previously included in Marsarah Tweaks. Both mods are optional and Marsarah Tweaks can still be used on its own.

If updating from an older version of Marsarah Tweaks that still contained the custom build pieces, make a world backup before updating and install MarsarahBuildPieces if you want to continue using those pieces.

---

Development Notes

Deep North / Spoiler Note: Deep North content is intentionally not included in Marsarah Tweaks yet. I want to experience the new biome, progression, gear, build pieces, and other content myself before digging through the game files, so I can play through it without spoiling the experience for myself. Once I have played through the Deep North, I plan to update the mod to properly include its content across the relevant features, including things such as gear and recipe changes, build-piece costs and materials, progression and balance adjustments, and any other existing tweaks that should apply to the new content.

AI Usage Disclosure: Marsarah Tweaks grew out of my original MarsarahMod project, whose code I initially wrote myself. AI tools were later used to assist with porting that code into Marsarah Tweaks and 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

• MarsarahUI - Standalone UI mod containing the UI features previously included in Marsarah Tweaks.
• MarsarahBuildPieces - Standalone build-piece mod containing the custom build pieces previously included in Marsarah Tweaks, along with new functional pieces.
• Neither mod is required to use Marsarah Tweaks. When installed together, the mods automatically use relevant compatibility integrations where available.

---

🔒 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/ ⚠️ Note: BepInEx needs to be installed on the dedicated server as well as all clients.

---

📦 Installation

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

⚠️ Note: This mod must be installed on both the server and all clients. ⚠️ Note: Configs may be renamed or reshuffled upon mod updates, so always check the config file when updating this mod.

---

⚙️ Configuration

• A config file is generated on first launch:

Valheim/BepInEx/config/Marsarah.MarsarahTweaks.cfg

• Each feature is in its own section and can be toggled individually.
• Features can be changed manually or using a Configuration Manager.
• Most features support mid-game toggling, but some require crafting menus to be reopened, reloading areas or client relogs (this is specified in their relevant sections below).
• Some configs below will have more detailed changes written in the [Docs] tab of the Nexusmods page.

⚠️ Note: All features are synced using ServerSync. ⚠️ Note: Players will be disconnected if their mod version differs from the server.

---

💰 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

⚙️ Lock Configuration

Prevents non-admin players from modifying any configuration values while in-game. Useful for dedicated servers to maintain consistent settings.

---

⚙️ Grind Reduction

All features below are synced with the server. They can be toggled mid-game, unless otherwise specified.

---

🔧 Double Bronze Crafting

• Doubles the amount of Bronze produced when combining Copper and Tin at a Forge.