⚠️ FINAL THUNDERSTORE RELEASE

StackIT 0.1.1 is the last version that will ever be published on Thunderstore.

Every future update — new features and bug fixes alike — is Hexium-only from here on.

👉 valheim.hexium.gg

Nothing breaks today — this version keeps working exactly as it does now. But it will never be updated on this platform again, so install StackIT from Hexium to keep receiving fixes and new features.

And StackIT is the small one.

Portals. Food. Farming. Stealth. Ships. Wings. Dungeons. Raid bosses. Dvergr armies. Every mod I have ever shipped is on Hexium — the whole shelf of them, every one alive, every one still getting fixes. Nothing of mine is abandoned, and nothing of mine is finished.

StackIT is a small, server-authoritative mod that decides two numbers for every item in the game: how many fit in a slot, and what one of them weighs. Both are multipliers you set once and forget — or, if you want the control, tune per category and per individual item, with exclusions and a hard ceiling. The server owns the settings and clients sync to it, so nobody has to compare config files.

It deliberately never makes weapons, armour or tools stackable. Here is why.

⚠️ Upgrading from 0.0.1

Weight reduction is on by default. 0.1.1 adds a Weight Multiplier that ships at 0.5, so every item weighs half what it used to the moment you launch. That is a real balance change on an existing server, and it is deliberate — bigger stacks are only worth having if you can carry them. If you want the old behaviour, set Weight Multiplier = 1.0 in section 4 - Weight.

Your stack multiplier carries over. It stayed in section 2 - Settings under the same key precisely so your existing value survives the upgrade untouched.

Everyone needs 0.1.1. Clients still on 0.0.1 will be asked to update, because they would compute different stack sizes to the server.

⚔️ Features

📦 Bigger Stacks

One multiplier applied to the base stack size of every item that already stacks in vanilla. Defaults to 3x: 50 wood becomes 150, 20 trophies become 60. A Max Stack Size ceiling (default 9999) is applied afterwards, so a big multiplier on an already-big stack can never produce a silly number.

Stack sizes are always recomputed from the vanilla value, never from the current one. Turn the multiplier down mid-session and it genuinely goes down; push a new config from the server ten times and you get the same answer ten times.

🪶 Lighter Items

The other half of the problem. A multiplier on every item's weight, defaulting to 0.5 — half of vanilla. Two details matter:

• Items that weigh nothing in vanilla stay weightless. They are meant to be free.
• Everything else gets a Minimum Item Weight floor (default 0.01) so nothing rounds down to free by accident.

🎒 More Carry Weight

Extra Carry Weight is a flat allowance added on top of vanilla's 300 and anything Megingjord is already giving you. It hooks the same call the encumbrance check and the inventory readout use, so the number in the corner of your inventory and the point at which you start waddling always agree. Defaults to 0 — the stack and weight multipliers usually get you there on their own.

🗂️ Per Category

If one number for the whole game is too blunt, every category has its own override. Leave a category at 0 and it follows the global multiplier; set anything else and it wins.

Weapons, armour and tools have no stack setting on purpose — see below.

🎯 Per Item

For when a category is still too broad. Two comma-separated lists set absolute values that ignore every multiplier:

Stack Size Overrides = Wood:500, Stone:500, Coins:9999
Weight Overrides     = Wood:0.1, Iron:4, BlackMetal:3

And two more hold specific items at their vanilla numbers, whatever the multipliers say:

[2 - Settings]  Excluded Items = Coins, SurtlingCore
[4 - Weight]    Excluded Items = Ymirremains

All four lists accept either the prefab name (Wood) or the shared name token ($item_wood), because item dumps and in-game tooltips do not agree on which one you are looking at. All four are case-insensitive, and all four are read in invariant culture — a config written on one machine reads identically on every other one, whatever its decimal separator.

🛡️ Why Gear Never Stacks

Plenty of stack mods will happily let you stack swords. StackIT will not, and this is the reason.

Valheim decides whether two items can merge in Inventory.FindFreeStackItem, and it compares name, quality and world level — it never looks at durability. So if stacking gear were allowed, a sword at full durability dropped onto a stack of worn ones would simply become a worn one. The game keeps a single durability value for the whole stack, and the better item's is discarded without a message.

There is no config flag to turn this on, because there is no version of it that is not silent data loss. Weight reduction still applies to gear in full — a lighter armour set is free of that problem.

The same rule covers anything that does not stack in vanilla, for the same reason. If you point a stack override at one of those items, StackIT ignores it and says so once in the log.

⚙️ Configuration

Everything lives in BepInEx/config/wubarrk.stackit.cfg, generated on first launch. Every setting below is server-synced.

1 - General

2 - Settings

3 - Stack Categories

Materials, Consumables, Ammo, Trophies, Fish, Misc — each defaults to 0, meaning use the global Stack Multiplier.

4 - Weight

5 - Weight Categories

Materials, Consumables, Ammo, Trophies, Fish, Misc, Weapons, Armor, Tools — each defaults to 0, meaning use the global Weight Multiplier.

6 - Carry Weight

🤝 Multiplayer

Install it on the server. Configuration is server-authoritative through ServerSync: the server holds the real values and pushes them to every client on connect, and again whenever an admin changes one — no restart, no reconnect, no comparing config files with your friends.

Lock Configuration (on by default) stops clients editing their own copy to give themselves bigger stacks. Because MinimumRequiredVersion matches the mod version, a client on an older StackIT is asked to update rather than quietly playing with different numbers to everyone else.

Single-player and dedicated servers both work with no extra setup. StackIT touches item prefabs only — it does not write to your save.

📦 Dependencies

⚠️ Requires: BepInEx

📥 Installation

With Gale (recommended): just install StackIT — the dependency above is pulled in for you.

Manual install:

1. Install BepInExPack Valheim.
2. Drop StackIT.dll into BepInEx/plugins.
3. Launch once to generate BepInEx/config/wubarrk.stackit.cfg, then set your multipliers.
4. On a dedicated server, install it on the server as well — that is the copy that decides.

📜 Licence

StackIT is released under the MIT License (LICENSE.md, included in the download). Fork it, ship it, sell it, put it in your modpack — keep the copyright notice and you are done. No permission needed and none to ask for.

ServerSync.cs (by Blaxxun) is compiled into the DLL and stays under its own author's terms.

Changelog

[0.1.1]

Added

• Weight reduction. Every item's weight is now multiplied by a configurable factor, defaulting to 0.5 - half of vanilla. Bigger stacks only help if you can carry them, so weight is now the other half of the mod rather than something the stack multiplier quietly makes worse. Items that weigh nothing in vanilla stay weightless, and a Minimum Item Weight floor stops anything rounding down to free.
• Extra Carry Weight. A flat allowance added to every player's carry limit, on top of vanilla's 300 and anything Megingjord contributes. Defaults to 0. It patches Player.GetMaxCarryWeight, so the encumbrance check and the inventory readout both agree with it.
• Per-category multipliers. Stacks and weights can each be tuned per category instead of one number for the whole game - Materials, Consumables, Ammo, Trophies, Fish and Misc for stacks, plus Weapons, Armor and Tools for weight. Leave a category at 0 and it follows the global multiplier.
• Per-item overrides. Wood:500, Stone:500 sets absolute stack sizes that ignore the multiplier entirely; Wood:0.1, Iron:4 does the same for weights. Both accept the prefab name (Wood) or the shared name token ($item_wood), and both are case-insensitive.
• Exclusion lists. Comma-separated prefab names held at their vanilla stack size or vanilla weight - for the coins, cores and quest items you would rather the multiplier never touched.
• Max Stack Size. A hard ceiling applied after the multiplier and after any override, so a large multiplier on an already-large stack cannot produce an absurd number.
• Verbose Logging toggle, which reports how many prefabs were touched on each re-apply. Useful while tuning overrides.

Changed

• Gear is explicitly never stacked. Weapons, armour and tools are skipped by name, and so is anything that does not stack in vanilla. Valheim merges stacks by item name and quality only - it does not compare durability - so a pristine sword dropped onto a worn stack would silently take the worn item's durability. Weight reduction still applies to gear; only stacking is withheld. An override aimed at an unstackable item is ignored and logged once.
• Mod-added items are picked up more reliably. The sweep now covers ZNetScene.m_prefabs as well as ObjectDB.m_items, so item prefabs that never made it into the ObjectDB are still handled. Each prefab is visited once per pass.
• Everything is recomputed from cached vanilla values, never from the live value, so repeated config pushes cannot compound. Lowering a multiplier now genuinely lowers it, and clearing an exclusion restores the vanilla number exactly.
• Overrides parse in invariant culture, so a config written on one machine reads identically on every other one regardless of its decimal separator.
• The config layout gained five new sections. Your existing Stack Multiplier is preserved - it stayed in 2 - Settings under the same key specifically so upgrading from 0.0.1 keeps it.
• MinimumRequiredVersion moved to 0.1.1. Clients still on 0.0.1 will be asked to update, because they would compute different stack sizes to the server.

Licence

• Relicensed under the MIT License. The previous terms required the author's approval before anyone could make a derivative work, which is not open source by any usable definition. MIT keeps the attribution requirement and drops the permission gate. ServerSync.cs is compiled in and stays under its own author's terms; see LICENSE.md.

[0.0.1]

• Initial release.
• Added dynamic item stack size modifier.
• Configurable multiplier defaults to 3x.
• Integrated ServerSync for server-authoritative configuration.