MarsarahBuildPieces

Marsarah Build Pieces

Version: 1.1.2 Author: Marsarah

---

🧰 About the Mod

Marsarah Build Pieces is a standalone collection of custom buildable pieces for Valheim, focused mainly on functional pieces, portals and new light sources rather than large sets of architectural walls and floors.

The mod began as the custom build-piece section of Marsarah Tweaks and has now been separated into its own mod. It currently adds 16 buildable pieces plus the craftable Portal Core item, including the Pocket Portal, Glacial Stone Portal, Mystical Light Ward, Smart Dropbox, Small Sign, Silver light sources, a Green Standing Brazier and colored Dvergr Lanterns.

All feature configs are synchronized using ServerSync, and the mod includes optional compatibility with MarsarahTweaks when both are installed.

---

Development Notes

Deep North / Spoiler Note: Deep North build pieces are intentionally not included yet. I want to experience the new biome and progression myself before digging through the game files, so I can play through it without spoiling the experience for myself. After completing the Deep North, I plan to review its build pieces and other relevant content for possible additions to this mod.

AI Usage Disclosure: The original build-piece features came from my MarsarahMod / Marsarah Tweaks projects. AI tools were later used to assist with porting 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 and some custom visual assets, such as build-menu icons, were created using generative AI.

Related Marsarah Mods

• MarsarahTweaks - Gameplay, balance, grind-reduction and quality-of-life tweaks. BuildPieces includes optional compatibility with several Tweaks features.
• MarsarahUI - Standalone UI and information improvements.
• Neither mod is required to use Marsarah Build Pieces.

---

🔒 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

https://valheim.thunderstore.io/package/denikson/BepInExPack_Valheim/

• Jotunn

https://valheim.thunderstore.io/package/ValheimModding/Jotunn/

For multiplayer, install the mod on the server and all clients so synchronized configuration and custom prefabs match.

---

📦 Installation

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

Make sure Jotunn is also installed.

---

⚙️ Configuration

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

All BuildPieces settings are synchronized with the server using ServerSync. The configuration can be locked so only server administrators can change synchronized values.

Features can be enabled or disabled individually, and configurable values such as the Smart Dropbox and Mystical Light Ward radii can be adjusted through the config file or a compatible configuration manager.

Most settings can be changed during gameplay. Close and reopen the relevant build/crafting menu when needed for menu changes to refresh.

---

💰 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

🔧 Smart Dropbox

A functional storage piece designed to make putting away gathered materials faster. Unlocked in the Swamp and also requires a Thunderstone.

• Automatically distributes deposited items when the Smart Dropbox is closed.
• Items are only moved to nearby supported storage that already contains the same item type.
• Eligible containers are checked from nearest to farthest.
• Items that cannot be moved remain inside the Smart Dropbox.
• Build cost: 5 Fine Wood, 2 Copper, 2 Iron, 1 Thunderstone.
• Default search radius: 20 meters. Configurable from 5 to 50 meters.
• Respects Ward/access restrictions.
• Supports local worlds, multiplayer and dedicated servers.
• If the feature is disabled, already placed Smart Dropboxes remain usable as normal storage and their special visual effect is disabled.

• Conflicts: Smart Dropbox is automatically disabled if MultiUserChest is detected. The two features are incompatible and using them together can cause inventory desynchronization or item loss.

🔧 Pocket Portal

A portable portal designed to make exploration more convenient.

• Adds a craftable Portal Core item.
• Portal Core is crafted at a level 4 Workbench using:
• 5 Surtling Cores
• 20 Fine Wood
• 5 Freeze Glands
• 20 Obsidian
• Portal Core has a maximum stack size of 1 and weighs 10.
• Building a Pocket Portal consumes 1 Portal Core.
• Each player can only have one Pocket Portal placed at a time.
• Destroying the existing portal allows that player to place it somewhere else.
• Crafting the Portal Core introduces the Pocket Portal through a custom Raven tutorial.

---

🔧 Glacial Stone Portal

Enables an unused vanilla stone portal as a proper buildable portal with a cold/glacial progression theme.