Starting as a wee Viking rummaging through the tranquil fields of the Meadows, you'll gather materials that lead to your destiny. From Deer Hide and Leather Scraps to mystical Wisp-infused fabrics, you'll learn how to craft, upgrade, and customize your very own Adventure Backpacks! Go forth and wander, ye wanderer of the wanders!

---

🧭 How to Use Adventure Backpacks

• 🔨 Discover & Craft: As you explore biomes, defeat creatures, and collect new materials, you will unlock recipes for Adventuring Backpacks.
• 🎒 Open Your Backpack: The default hotkey is I to open your equipped backpack. Fully customizable for Keyboard, Mouse, and Gamepad / Controller inputs.
• 📈 Progression & Upgrades: Each backpack features unique inventory sizing, carry weight bonuses, movement speed modifiers, and environmental perks. Upgrading your backpack at a workbench or forge expands capacity and strengthens bonuses.
• ⚙️ Full Customization: Almost every aspect of these backpacks (sizes, recipes, drop chances, effects, and weight multipliers) can be tailored via configuration files or the in-game Configuration Manager.

---

📦 Backpack Catalogue

Backpack	Biome / Tier	Description & Key Traits
Satchel	🌸 Meadows	A small, lightweight starter pack crafted from early Meadow materials.
Rugged Backpack	🌲 Black Forest	A sturdy leather pack complete with brass buckles and fine strapping.
Bloodbag Wetpack	🐸 Swamp	A durable Swamp pack sealed with bloodbags; grants the Waterproof perk.
Arctic Sherpa Pack	❄️ Mountain	An insulated Mountain pack fit for freezing treks; grants Frost & Cold Resistance.
Lox Hide Knappsack	🌾 Plains	A massive Plains pack made from thick, durable lox hide with high carry capacity.
Explorers Wisppack	🌫️ Mistlands	A mystical backpack with a Box of Holding, built-in Demister / Wisplight, and Slow Fall.
Ashlands Pack	🔥 Ashlands	🔥 Coming Soon — Forged for the volcanic fires and molten depths.
Deep North Pack	🧊 Deep North	🧊 Coming Soon — Prepared for the sub-zero permafrost.
Legacy Packs	⚔️ Legacy	Original Iron and Silver backpacks preserved for existing world saves.

💡 Coming Soon: Ashlands & Deep North Backpacks

New biome-specific backpacks for the Ashlands and Deep North are actively in development, featuring custom models, materials, and unique biome status effects!

---

🕹️ Controls & Interaction Modes

Control Mode	Input / Keybind	Description
Toggle Backpack	I (Default)	Opens or closes your equipped backpack inventory.
Hover Interaction	Hover + Hotkey	Hover over an equipped backpack in your main inventory and press the hotkey to open it directly.
Open with Inventory	Configurable	Automatically opens your backpack inventory whenever you open your player inventory.
Outward Quick Drop	Y (Default)	Press while moving to immediately detach and drop your backpack behind you to escape danger.
Gamepad / Controller	🎮 Native	Full controller navigation support for opening, closing, and managing backpack inventories.

---

🛡️ Advanced Mechanics & Safeguards

• ⚡ Thor's Inventory Guard (Inception Prevention):
  • Backpack-in-backpack nesting is strictly prevented to safeguard against data corruption and infinite inventory loops.
• 🏷️ Yard Sale Overflow Safeguard:
  • If a backpack is resized or upgraded in a way that reduces slots below the stored item count, excess items are cleanly dropped at the player's feet rather than lost.
• 🔀 Right-Click Quick Transfer (Fast Item Transfer):
  • Move single items or entire stacks between your inventory and any open backpack or container with a single right-click.
• 🌀 Portal & Teleportation Compatibility:
  • Fully respects Valheim's Inventory.IsTeleportable() checks. Non-teleportable ores/items inside backpacks will properly restrict portal usage across all portal mods.
• 🗝️ Key & Quest Item Recognition:
  • Keys (such as Swamp Crypt Keys) and quest items in your equipped backpack are recognized by locked doors and crypt entrances without moving them to player inventory.
• 🖼️ Armor Stand & Item Stand Mounting:
  • Safely mount backpacks on Item Stands and Armor Stands for base decoration without item loss or duplication.

---

✨ Status Effects & Passive Perks

• 💪 Carry Weight Modification: Increases base carrying capacity per upgrade level.
• ⚖️ Weight Reduction Multiplier: Configures how much weight items inside the backpack contribute (0% = weightless contents; 100% = normal weight).
• 🏃 Speed Modifiers: Configurable movement speed adjustments per tier that improve as packs are upgraded.
• ❄️ Frost & Cold Resistance: Keeps you warm in freezing Mountain biomes.
• 🌧️ Waterproof: Prevents the "Wet" debuff in rain and swamp water.
• 🦹 Troll Armor Set Synergy: Integrates into the Sneak set bonus when wearing Troll Leather gear.
• 🪶 Slow Fall / Feather Fall: Eliminates fatal fall damage when leaping from mountain peaks.
• 💡 Demister (Wisplight):
  • Clears mist in the Mistlands.
  • Configurable toggle keybind (default L).
  • Includes smart biome logic to automatically stow the light outside the Mistlands.

---

🧩 Adventure Backpacks API (ABAPI)

Mod developers can easily build custom backpacks and register effects using our dedicated API assembly:

• 📖 ABAPI Documentation
• 💾 Download ABAPI.DLL Releases

API Capabilities:

• 🎒 Register custom 3D backpack prefabs, textures, and recipes.
• 🪄 Register and attach custom status effects.
• 🔍 Query backpack state, equipped equipment, and inspect backpack contents.

---

🤝 Verified Mod Compatibility

⚠️ NOTE — JotunnBackpacks Incompatibility: Adventure Backpacks is incompatible with JotunnBackpacks. However, Adventure Backpacks will automatically convert existing JotunnBackpacks saves into new Adventure Backpacks upon loading your character.

---

🌐 Available Translations

Adventure Backpacks includes community translations for:

Don't see your language? We welcome community translations! Please submit a PR on GitHub or stop by our Discord.

---

📥 Installation & Server Setup

Mod Manager (Recommended)

1. Install via R2ModMan or Thunderstore Mod Manager.
2. Dependencies are automatically installed: BepInExPack, Jotunn (JVL), and YamlDotNet.

Dedicated Servers

• Required on Both Client & Server: Adventure Backpacks must be present on both the server and all connecting clients.
• Network Compatibility: Built-in version checking ensures game-state and inventory consistency across clients.
• ServerSync: Server configuration files automatically lock and sync settings down to non-admin players in real-time.

---