GorilaChestMod

GorilaChestMod

Chest quality of life for Valheim, in five parts:

1. Craft from chests. Craft, upgrade and build using the items inside the

chests around you, without hauling anything into your inventory first.

1. Oversized chest stacks. A chest slot holds far more than the vanilla

limit, 1000 by default, so a chest full of wood is one slot instead of twenty. Your own inventory keeps the vanilla limits.

1. Quick stack. The J key pushes matching items from your inventory into

the chests in range. J is free in Valheim: V is auto pickup and G opens the hotbar radial.

1. Favorites. Mark a stack with Alt + left click and automatic moving

leaves it alone, both the quick stack above and the chest's own stack button.

1. Deconstruct. A third tab beside Craft and Upgrade takes a crafted item

apart and gives its materials back, upgrades included.

Runs on the client and on a dedicated server.

The Deconstruct tab used to be a separate mod, GorilaDeconstruct. From 2.5.0 it lives here, so remove GorilaDeconstruct before updating, otherwise the tab is built twice.

Game version this was built against

| Item | Value | | --- | --- | | Game version | 1.0.15 | | Steam build | 25390630 | | Engine | Unity 6000.0.75f1, Mono backend | | Game code | valheim_Data/Managed/assembly_valheim.dll |

Because the backend is Mono and not IL2CPP, the usual modding path still applies: BepInEx 5 plus Harmony, patching in memory. No game file is modified.

Install

1. Install BepInEx 5 for Valheim, the denikson-BepInExPack_Valheim package.

Launch the game once so it creates its folders.

1. Copy GorilaChestMod.dll into Valheim/BepInEx/plugins/GorilaChestMod/, or

extract the -nexus.zip release over the game folder.

1. Start the game. BepInEx/LogOutput.log should contain a line reading

GorilaChestMod 2.5.0 loaded.

With r2modman or Thunderstore Mod Manager, use Import local mod and pick the -thunderstore.zip release. Do not mix a mod manager with a manual BepInEx install in the game root, that is the classic cause of a mod loading twice or not loading at all.

On a dedicated server

Full step by step for whoever runs the server, Windows, Linux and rented panels: docs/server-install.md.

The short version is the same as above, into the server's BepInEx/plugins, and every player needs it as well. The server half exists for two reasons:

• A server that loads a chest into memory decides how large its stacks may be. A

vanilla server would clamp an oversized stack back to the vanilla limit and destroy the excess the next time it wrote that chest out.

• The server hands its chest stack settings to every client as they connect, so

the whole session agrees on the limit.

Craft from chests and quick stack are decided entirely on the player's own machine, so those two still work fine against a vanilla server.

Configuration

BepInEx/config/dev.trentini.gorilachestmod.cfg is written on first launch and can be edited with the game closed.

| Section | Option | Default | What it does | | --- | --- | --- | --- | | Craft from chests | Enabled | true | Count nearby chests when crafting, upgrading and building. | | Craft from chests | Range | 20 | Radius in meters. Quick stack uses the same radius. | | Craft from chests | UseForBuilding | true | Also pay hammer, hoe and cultivator costs from chests. | | Craft from chests | IncludeVehicleContainers | true | Include containers on carts and ships. | | Chest stacks | Enabled | true | Allow oversized stacks inside chests. | | Chest stacks | ChestStackSize | 1000 | How much one chest slot may hold, up to 10000. The server's value wins. | | Chest stacks | ShrinkStackText | true | Keep a slot label readable when the numbers get long, 1000 reads as 1k. | | Quick stack | Enabled | true | Enable the quick stack hotkey. | | Quick stack | SkipHotbar | true | Leave the hotbar row alone. | | Quick stack | Hotkey | J | Hotkey for quick stacking, inventory open or closed. | | Quick stack | HotkeyNeedsInventory | false | Require the inventory to be open for the hotkey. | | Favorites | Enabled | true | Allow stacks to be marked as untouchable. | | Favorites | Modifier | LeftAlt | Hold this and left click a stack to mark it. Either side key works. | | Favorites | ShowMarker | true | Draw a star on a marked slot. | | Favorites | Announce | true | Print a line when you mark or unmark a stack. | | Deconstruct | Enabled | true | Show the Deconstruct tab at crafting stations. | | Deconstruct | ReturnPercent | 100 | How much of the materials comes back, 50 to 100. The server's value wins. | | Deconstruct | RespectFavorites | true | Refuse to deconstruct a stack you marked as favorite. | | Debug | Verbose | false | Log every withdrawal, move, deconstruction and patched call. |

When you are connected to a server that has the mod, that server's Enabled and ChestStackSize under Chest stacks, and ReturnPercent under Deconstruct, replace your local values for as long as you are connected. Those values are held in memory only: your config file is never rewritten, so leaving the server gives you your own settings back. Everything else stays personal.

Which chests count

A chest is only used if it passes the same rules the game applies when you try to open it:

• it is inside the configured radius;
• privacy is Public, or Private with you as the creator of the piece, so

group chests stay out exactly like in vanilla;

• if the chest checks for a guard stone, you need access to that ward;
• nobody else has it open, a chest in use by another player is skipped.

Before taking anything the mod claims network ownership of the chest through ZNetView.ClaimOwnership, which is what authorises writing the inventory back into the ZDO. That is the same mechanism the game uses for "take all".