📦 Balrond Packager - Mod Documentation

📦 Overview

Balrond Packager introduces a lightweight but highly practical bundling system to Valheim, allowing players to compress multiple items into a single transportable package.

The mod adds:

• 🏗️ A new crafting machine: Packager (Byroe Machine)
• 📦 A new item: Bundle Item Chest
• 🧰 A new utility station: Unpacking Station
• ⚙️ A complete item packaging & unpacking system

The goal of the mod is simple:

Reduce inventory clutter and simplify transportation without breaking gameplay progression.

🌟 Main Features

• 📦 Bundle multiple items into a single package item
• 🎒 Save inventory space during exploration and transport
• 🏗️ New crafting station: Packager
• 🧰 New utility station: Unpacking Station
• 🌍 Compatible with:
  • Upgrade World
  • Expand World
  • WackyDB
  • Other content mods
• 🌐 Translation support via external .json files
• ⚖️ Automatic teleport restrictions based on packaged content

⚙️ How The System Works

📦 Packaging Items

1. Build the Packager
2. Place supported items into its container
3. Pull the lever
4. Wait for the packaging process to complete
5. Receive a Bundle Item Chest

The package stores:

• Item names
• Stack counts
• Weight
• Teleport status
• Full package contents

🧰 Unpacking Items

To unpack:

1. Build an Unpacking Station
2. Place the bundle item in your hotbar
3. Use hotkeys 1-8 while looking at the station
4. All stored items will be released

🏗️ Build Pieces

📦 Packager (Byroe Machine)

• 🔨 Requires: Forge
• 📂 Category: Crafting

🧰 Unpacking Station

• 🔨 Requires: Workbench
• 📂 Category: Crafting

📦 Bundle Rules & Limitations

✅ Allowed Item Types

• Materials
• Consumables
• Ammo
• Misc items
• Trophies

❌ Restricted Item Types

• Weapons
• Armor
• Other Bundles

If unsupported items are detected:

• The packaging process still runs
• No valid package will be created

⚖️ Teleportation Rules

Bundle teleportation depends on its contents:

• ✅ If all items are teleportable → the bundle remains teleportable
• ❌ If even one item is non-teleportable → the bundle becomes non-teleportable

This behavior preserves vanilla progression and transport balance.

🌐 Translation Support

Translation files are located inside:

BepInEx/config/BalrondPackager-translation/

Default file:

English.json

To create your own translation:

1. Copy English.json
2. Rename it to your game language
   • Example: Polish.json
3. Edit translation values

Example:

{
  "tag_unpackager_bal": "Stacja Rozpakowywania"
}

🔧 Compatibility

The mod supports integration with:

• Upgrade World
• Expand World
• WackyDB
• Other content expansion mods

No server sync is required.

❓ FAQ

BepInEx/config/BalrondPackager-translation/

📌 Prefab IDs

💬 Community & Support

• Discord: https://discord.gg/Jfp8T5N7Pv
• Ko-fi: https://ko-fi.com/balrond1020

🧾 Changelog

Version 1.0.1

• Added validation preventing armor packaging
• Added validation preventing weapon packaging
• Added validation preventing bundle-in-bundle packaging

Version 1.0.2

• rework of the logic
• refactorization
• optimization
• new readme + icon