📦 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
- Build the Packager
- Place supported items into its container
- Pull the lever
- Wait for the packaging process to complete
- Receive a Bundle Item Chest
The package stores:
- Item names
- Stack counts
- Weight
- Teleport status
- Full package contents
🧰 Unpacking Items
To unpack:
- Build an Unpacking Station
- Place the bundle item in your hotbar
- Use hotkeys 1-8 while looking at the station
- All stored items will be released
🏗️ Build Pieces
📦 Packager (Byroe Machine)
| Requirement |
Amount |
| ElderBark |
20 |
| SurtlingCore |
5 |
| Stone |
10 |
| Iron |
10 |
| RoundLog |
10 |
- 🔨 Requires: Forge
- 📂 Category: Crafting
🧰 Unpacking Station
| Requirement |
Amount |
| Stone |
10 |
| Wood |
10 |
- 🔨 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:
- Copy
English.json
- Rename it to your game language
- 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
Does the mod require Server Sync?
No.
The mod contains no synced configs and works without ServerSync.
Are translations synced?
No.
Translations are local client-side files only.
Where are the configs?
There are no gameplay configs.
The mod is designed to function as intended without balancing configs.
If you want to customize progression or recipes:
- Use WackyDB
- Use Expand World
I see [ tag_something ] instead of text!
You are likely missing translation files.
Check:
BepInEx/config/BalrondPackager-translation/
If files are missing:
- Reinstall the mod
- Verify translation files were copied correctly
Can I translate other mods using this translation system?
Yes.
As long as the mod loads after Balrond Packager, additional localization keys may also work for other mods.
What is the Packager used for?
It allows you to compress multiple items into a single inventory item for easier transport and storage.
What is the Unpacking Station used for?
It restores all packaged items back into the world.
📌 Prefab IDs
Build Pieces
packager_balunpackager_bal
Items
💬 Community & Support
🧾 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
