ADVENTURE BACKPACK COMPATIBILITY

PACK IT. PORTAL IT. PUT IT AWAY.

Keep your backpack connected to your world's progression and your base storage.

Adventure Backpack Compatibility connects AdventureBackpacks with RunicStorage and ServersideQoL PortalProgression. Eligible backpack contents follow your server's world-boss portal rules, and RunicStorage's Quick Stack can empty matching items from your equipped backpack into nearby storage.

Compatibility / v0.1.0
Built and tested with Valheim 1.0.15, AdventureBackpacks 2.1.10, RunicStorage 1.3.4, ConditionalConfigSync 1.0.9 and BepInExPack Valheim 5.4.2350. Install matching helper versions on every client and the server. The portal feature additionally requires the reviewed ServersideQoL PortalProgression 2.0.11 and its enabled core on the server. Exact reviewed dependency binaries are checked; later updates require review.

SUPPORT ME ON KO-FI

If this makes stocking your base a little easier, you can support my compatibility work on Ko-fi. Tips are optional and appreciated. Vercadi

THROUGH THE PORTAL / WORLD PROGRESSION

• Uses the server's configured PortalProgression item rules and bosses defeated in that world.
• Allows eligible items inside carried AdventureBackpacks without temporarily moving the contents out of the bag.
• Keeps unknown items, explicit exclusions and undefeated boss tiers restricted.
• Waits for the server policy to initialize and synchronize before granting additional backpack permissions.

PortalProgression is optional on clients. Without its supported, enabled server component, this helper grants no extra portal permissions; the Quick Stack feature can still operate. Normal main-inventory PortalProgression behavior, holding distance and notifications remain controlled by that mod. Other portal restrictions still apply.

BACK TO STORAGE / QUICK STACK

Use your existing RunicStorage Quick Stack shortcut with an equipped, closed backpack. This helper adds its matching items to the same storage operation, using RunicStorage's range, destination matching, routing, locks and ownership checks.

Only the equipped backpack is a Quick Stack source. Close its inventory window first. Equipped items, quest items, backpacks and protected items stay in the bag. RunicFoodGuard's protection for food slots in your main inventory remains separate and unchanged.

There is no new shortcut or storage range setting. The helper saves the changed backpack data and checks the transfer result. If a transfer fails, it attempts to restore that transfer and stops further backpack stacking until restart. Preserve the log before retrying an operation that reported an error.

INSTALLATION

1. Close Valheim and stop the server normally before changing plugins. Back up your world and characters.
2. Install the listed dependencies and this helper on each client and the server.
3. For backpack portal progression, install ServersideQoL PortalProgression 2.0.11 with its core on the server, enable both, and configure your desired item-to-boss rules there. It is an optional server feature and is not automatically installed by this package.
4. Start the server, then join with matching helper versions.

Manual installation: copy plugins/AdventureBackpackCompatibility from the ZIP into BepInEx/plugins. Dependencies are installed separately.

Coming from the local test ZIP? Replace its local mod entry with the published package while the game is closed. Keep your config and only one AdventureBackpackCompatibility.dll. The public package uses the same tested binary and plugin ID.

No new items or world generation are added. Existing backpacks can use the helper. To remove it, close the games and server and remove the helper everywhere; upstream portal and Quick Stack behavior returns.

YOUR SETTINGS

The first launch creates BepInEx/config/vercadi.AdventureBackpackCompatibility.cfg:

[General]
Backpack portal progression = true
Quick stack equipped backpack = true
Lock server settings = true

The server controls these settings during multiplayer sessions. Each feature can be disabled independently.

FIELD NOTES / COMPATIBILITY

Look for ACTIVE: reviewed AdventureBackpacks on startup, SERVER POLICY READY: on the server, and Backpack quick-stack committed: after a successful bag transfer. The tested 0.1.0 binary retains its original private-candidate startup wording; the release notes below record the subsequent test result.

An INACTIVE message means a dependency or expected method did not match. Update this helper only after the changed dependency has been reviewed. Its manifest dependency list does not prevent your mod manager from installing a later version.

Validation: 76 offline checks passed. The maintainer reported successful in-game tests on 23 September 2026 with a modded dedicated server. Logs confirm client/server config synchronization and two backpack Quick Stack transfers with saved bag data verified. This is one tested modpack; unusual inventory failures and other mod combinations are not exhaustively covered.

CREDITS

Created by Vercadi as an independent compatibility add-on. Thanks to Vapok for AdventureBackpacks, Chazman for RunicStorage, ArgusMagnus for ServersideQoL and shudnal for ConditionalConfigSync.

Original helper code and icon use the included MIT license. Development used AI assistance. Game assemblies, other mods' binaries and decompiled sources are not included. The linked Ko-fi button is Ko-fi's brand artwork.

Enjoying my work? Buy me a coffee on Ko-fi. A useful bug report helps too.

Changelog

0.1.9

• Support AdventureBackpacks 2.2.4 and RunicStorage 1.4.1 after reviewing their inventory and storage interfaces.
• Apply synchronized server portal permissions inside the new backpack precheck while retaining locked tiers, special-item restrictions and upstream inventory checks.

0.1.8

Support AdventureBackpacks 2.2.1 with RunicStorage 1.3.12 and RunicCrafting 1.1.11.

• Keep single-stack Quick Stack limited to the selected carried stack, including delayed retries. Whole-inventory Quick Stack still includes the equipped backpack.
• Retain backpack persistence checks and server-controlled portal rules.

0.1.7

• Supports RunicStorage 1.3.9 and RunicCrafting 1.1.9 for backpack Quick Stack, crafting and building.

0.1.6

• Preserves unrelated inventory changes if backpack quick-stack fails.
• Verifies chest ownership and backpack contents before recovering an interrupted transfer.

0.1.5

• Supports AdventureBackpacks 2.2.0. Prevents backpack materials being counted twice during Runic crafting and building.

0.1.4

• Simplified the changelog. No gameplay changes.

0.1.3

• Updated compatibility with RunicStorage 1.3.8 and RunicCrafting 1.1.8.
• Adapted backpack transfers to the updated storage system, including its transfer recovery protection.

0.1.2

• Added equipped-backpack materials to RunicCrafting recipes, equipment upgrades and recipe previews.
• Fixed duplicate backpack material counts in recipe availability displays.
• Extended the server's existing Build from equipped backpack setting to control crafting as well as building.
• Updated compatibility with AdventureBackpacks 2.1.13.

0.1.1

• Added optional RunicCrafting 1.1.3 support for hammer building with materials in an equipped, closed backpack.
• Saved backpack contents after material use and restored them after failed transfers.
• Included backpack materials in building totals without counting them twice.
• Added the server-controlled Build from equipped backpack setting, enabled by default.

0.1.0

• Initial release.
• Applied the server's world-boss portal rules to carried backpack contents without moving items out of the bag.
• Added matching items from an equipped, closed backpack to RunicStorage Quick Stack.
• Preserved storage routing and item protections, and stopped further backpack transfers after a failed operation.
• Waited for the server's portal settings before applying portal rules.