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.
2. 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.
3. 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.
4. 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.
5. 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.
2. Copy GorilaChestMod.dll into Valheim/BepInEx/plugins/GorilaChestMod/, or extract the -nexus.zip release over the game folder.
3. 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".

How it works

Craft from chests

The game methods read the player inventory straight from the m_inventory field, with no extension point anywhere. Rather than injecting fake items into your backpack, the mod uses transpilers to rewrite only the inventory calls inside these methods. An instance call already carries this as its first stack argument, so a static method whose first parameter is the Inventory is a drop-in replacement and the rest of the method body is left untouched.

Game method	Call swapped	Why
Player.HaveRequirementItems	CountItems	unlocks the recipe and the craft button
Player.GetFirstRequiredItem	CountItems, GetItem	single ingredient recipes such as meads and feasts
Player.ConsumeResources	RemoveItem	pays for a craft and for a placed piece
Player.HaveRequirements(Piece)	HaveItem, CountItems	unlocks the building piece
InventoryGui.DoCrafting	RemoveItem	pays the single ingredient
InventoryGui.SetupRequirement	CountItems	the have/need numbers in the UI

Container.Awake registers every chest that spawns, so no FindObjectsOfType sweep is ever needed, and Player.UpdatePlacement and Hud.SetupPieceInfo mark the building context so UseForBuilding can be honoured.

Oversized chest stacks

The stack limit is the plain field ItemData.m_shared.m_maxStackSize, read in a handful of places inside Inventory and InventoryGrid. A transpiler turns each of those field reads into a call that also receives the inventory being worked on, so the same item type answers 1000 in a chest and the vanilla 50 in a backpack.

Lowering the limit later never destroys anything: while a saved chest is being rebuilt, the stack coming off disk raises the ceiling for that one item, so a chest filled under a larger setting keeps what it holds. It simply stops growing. The list of methods is discovered from the game's own IL at startup rather than hard coded, and written to the log. A method can be hooked and still have nothing replaced after a game update, so that case is now an error in the log instead of silence; the successful counts are there too under Verbose.

That single change covers saving and loading too: the overload of Inventory.AddItem that rebuilds an inventory from its saved bytes clamps by the same field, which is why a vanilla server or a vanilla client would otherwise trim the excess away.

Four guards keep oversized stacks from leaking out of chests:

• InventoryGrid.DropItem, the mouse path, moves an oversized stack itself instead of letting the game do it. Vanilla has a swap branch that takes the dragged stack out of its inventory before handing it over, which counts on the whole stack landing on the other side; with a chest stack larger than a backpack slot may hold, the part that did not fit belonged to nobody and was lost. Now one vanilla sized stack lands on the slot you aimed at, the rest spreads over the free slots of the same inventory, and a swap onto an item of another type is refused with a message rather than losing anything.
• Inventory.AddItem(ItemData) splits a stack that is too large for its destination across several slots, so shift clicking 1000 wood out of a chest gives you twenty vanilla stacks. Each chunk reports how many items actually landed, because a destination that fills up part way through a chunk keeps what it took and still answers "failed".
• The slot targeted Inventory.AddItem moves only a vanilla sized portion and reports the move as partial, so the rest stays in the chest.
• ItemDrop.DropItem splits oversized stacks into several drops, so a destroyed chest scatters normal stacks instead of one impossible pile.

Quick stack

The hotkey is read in InventoryGui.Update and works with the inventory closed, so you can stand next to your chests and press it. It holds off while a menu, the console, the chat or a text field has focus, and while the player is dead. There is deliberately no button: one used to sit beside the inventory and kept landing in front of other panels. Items move only into chests that already hold that item, equipped and quest items are skipped, and the hotbar is skipped unless you say otherwise.

Favorites

The mark is a single entry in the item's own custom data, the dictionary the game already serialises next to durability and quality. That buys three things without any bookkeeping: it is saved and loaded with the item, ItemData.Clone copies it so splitting a stack keeps both halves marked, and it travels with the stack when you move it by hand. Merging is the one case the game would drop, so the slot targeted Inventory.AddItem carries the mark over when either side had it.

The click is caught in InventoryGui.OnSelectedItem: with the modifier held the click toggles the mark and is swallowed, otherwise vanilla runs untouched. The star is painted into a texture once at startup, since the game UI has no star to borrow, and the same sprite is reused for every slot.

The chest's own stack button is honoured too. It already refuses to move what you have equipped, through Humanoid.IsItemEquiped, so a transpiler points that call at a check that also answers yes for a marked stack.

Deconstruct

Pick the Deconstruct tab at a crafting station, choose a crafted item from the list, press the button, and after the usual progress bar the item is gone and its materials are in your inventory.

The cost is read from the item's own recipe, the same way the game charges for it: level 1 costs Requirement.GetAmount(1), each upgrade to level n costs Requirement.GetAmount(n). Every level up to the item's own is added, then ReturnPercent is applied and each material is rounded down on its own. A level 3 item whose recipe asks for 5 of a material with 3 more per level cost 5 + 3 + 6 = 14 of it, so it gives back 14 at 100% and 7 at 50%.

An item is listed when its recipe belongs to the station you are using, the same rule the Craft tab follows, and it is greyed out with the reason in the panel when it is equipped, marked as favorite, or part of a batch you do not have in full: arrows come in 20, so deconstructing takes 20 and returns the cost of one craft. Meads and feasts, which accept one ingredient out of several, are left out entirely, since there is no telling which one went in. Materials that do not fit in your inventory are dropped at your feet.

The tab itself is a copy of the game's own Upgrade tab, so the font, size and sound are the vanilla ones, and the list, the detail panel and the progress bar are the game's. The vanilla tabs mark the selected one by making it non interactable, and this one follows that convention, so InCraftTab and InUpradeTab both answer false while it is open and nothing else in the game mistakes the list for a recipe list. The parts of the crafting panel it reads are private, so they are resolved once at startup: if a game update moves them, the tab stays off with a line in the log and the other four features carry on.

Server side

The plugin loads in valheim_server.exe as well as valheim.exe. On a server there is no local player, so craft from chests and quick stack simply never fire, while the stack limit patches do their job on every chest the server touches.

Config sync is two routed RPCs of the game's own network layer: a client asks once it is connected, the server answers with its chest stack settings, and a server never takes those values from a client. On the client those values live in memory for the length of the session, so a visit to a server never changes what is written in the player's own config file.

Compatibility check after a game update

tools/PatchCheck opens assembly_valheim.dll with Mono.Cecil and asserts that every method the mod patches still exists with the same signature, that every call site the transpilers rewrite is still there, that the stack limit is still read where it needs to be, and that the mod side signatures still line up.

cd tools/PatchCheck
dotnet run

Expected output: ALL CHECKS PASSED. Run it first whenever Valheim updates, before launching the game.

Known limitations

• Removing the mod leaves oversized stacks behind. Vanilla clamps a stack back to its normal limit when it loads a chest, and the excess is gone. Empty your chests, or lower ChestStackSize and let the chests settle, before you uninstall. The same applies to a player without the mod opening a chest that holds oversized stacks.
• Repairing costs no materials in Valheim, so there is nothing to do there, and a worn item deconstructs for the same materials as a new one.
• Deconstructing a batch can turn a profit at 100%. A high crafting skill sometimes adds bonus items to a stackable craft, arrows for instance, and a deconstruction gives back the cost of one batch. Lower ReturnPercent if that matters on your server.
• An item with more than one recipe is priced by the first recipe the game lists.
• The Deconstruct tab has no gamepad shortcut of its own, and its caption is English in every language. Once it is open, the list and the button work with the gamepad.
• Smelters, kilns and other stations that take ore or wood through direct interaction are not fed from chests. Crafting, upgrading and building are.
• The quick stack button is mouse driven, there is no gamepad binding for it yet.
• A chest another player has open at that moment is skipped until they close it.