balrond WeaponCrate

⚔️ BalrondWeaponCrate - Mod Documentation

Overview

BalrondWeaponCrate introduces a new build mechanic to Valheim that allows players to place weapons and armor as decorative build pieces.

Using a special item called the Weapon Crate, players can browse and place supported equipment directly in the world. The system behaves similarly to the vanilla Serving Tray, turning items into placeable objects without modifying the original items themselves.

This makes it easy to create:

• ⚔️ Weapon racks
• 🛡 Armor displays
• 🏰 Decorative armories
• 🗡 Trophy halls

> ⚠️ The mod is requireds to be both present on Server and all Clients to ensure proper visuals and building functionality.

---

✨ Key Features

• 🧰 Weapon Crate tool that unlocks weapon and armor placement
• ⚔️ Automatically converts weapons into build pieces
• 🛡 Automatically converts armor pieces into build pieces
• ✨ visual effects of item drop are refactored to behave same as food items
• 🔧 Automatically filters invalid items such as monster gear or internal prefabs
• 🧠 Smart prefab validation to ensure only usable player equipment is included(WIP)

> ⚠️ The mod is in early stage some items may create a Nav Mesh Error making monsters bug out if you notice it please destroy said item. if item comes from any other of my mods or vanilla please report it to me so i can fix it. If item is modded but dosen't come from Balrond mods you may need to request help from mod Author and you may notice me of that issue.

---

📦 Weapon Crate

The Weapon Crate is a special item that works similarly to the Serving Tray.

When equipped and used, it opens a custom build menu category containing all supported weapons and armor pieces.

Prefab ID

WeaponCrate_bal

Behavior

• When holding the Weapon Crate, players gain access to the Weapon Crate build menu
• Items appear as placeable decorative pieces
• Placing an item consumes the item as a building cost
• Destroying the placed object returns the item (depending on configuration)
• Pressing Left CTRL while building rotates object in X axis by 30 degree
• Pressing Left ALT while building rotates object in Z axis by 30 Degree

---

🧱 Supported Items

The mod automatically detects and supports all vanilla item types

Items are detected directly from the ObjectDB item list, so newly added vanilla items are supported automatically.

---

🔍 Item Filtering

To avoid including non-player equipment, the mod uses several validation checks.

An item must:

• Have at least one icon
• Have a valid visual mesh
• Be a recognized weapon or armor type

Items are skipped if they are:

• Monster equipment
• Loot-only prefabs
• Internal or unused objects

This ensures the build menu stays clean and relevant.

> ⚠️ some items still may show up if you find any issue please post info on my discord so i can patch it.

---

✨ Visual Effects

VFX are handled using a setup copied form food item where Item Sparkles are nested inside item

fx_ItemSparkles
VFX_Root

This ensures compatibility with Valheim's internal visual systems and dosent create an item drop visual when item is placed using the tool.

---

🧠 How the System Works

1. The mod scans ObjectDB for all item prefabs
2. It filters the list to find valid player weapons and armor
3. Each item prefab is converted into a Piece build object
4. A PieceTable is attached to the Weapon Crate
5. The crate exposes the generated build pieces in the build menu

All logic runs automatically when the ObjectDB initializes.

---

🏗 Example Uses

Players can now build:

• 🏰 Armory display walls
• ⚔️ Weapon racks
• 🛡 Knight armor stands
• 🗡 Treasure rooms
• 🏹 Archery displays
• 🏺 Decorative museums

This greatly expands decorative building possibilities in Valheim.

---

📌 Compatibility Notes

• ✔ Works in singleplayer
• ✔ Works in multiplayer
• ✔ Compatible with wards / guard stones
• ✔ Uses vanilla prefabs
• ✔ Compatible with moded weapons and armors

The mod dynamically builds the placement list at runtime, making it highly compatible with updates.

---

📂 Installation

Install using your preferred mod manager or manually place the mod in:

BepInEx/plugins - dll
Bepinex/config - translation folder with json file

Restart the game after installation.

---

💬 Support & Feedback

Join the community:

Balrond's Den Discord https://discord.gg/Jfp8T5N7Pv

Support development:

https://ko-fi.com/balrond1020

---

🧾 Changelog

0.1.0

• Initial release