Confirm with your password

ItemStacksItemWeights

Control item stack sizes and weights. Dynamic server-to-client synchronization. Works globally or per item.

· 💗 Donate

Stars
3
Downloads
270
Version
1.1.1
Updated
Author
shudnal
Virus scan
✓ Scan successful
Runs on
Client & Server
Required by
11 mods

Compatibility

Required 2

Install these too — Gale pulls them in for you.

Description

ItemStacksItemWeights

Control item stack sizes and weights. Dynamic server-to-client synchronization. Works globally or per item.

The mod creates a shudnal.ItemStacksItemWeights.yml file in the BepInEx/config/shudnal.ItemStacksItemWeights folder and populates it with default values on first launch.

You can edit this file to change item stack sizes and weights.

In multiplayer, install this mod and Conditional Config Sync on the server and all clients. Edit the stack and weight configuration on the server.

After each file update, all settings are synchronized automatically and item properties are updated accordingly.

File structure

The configuration file is a simple YAML structure consisting of four main sections:

WeightMultiplier:
  Global: 1
WeightAmount:
  ItemName1: 2
StackMultiplier:
  Global: 1
StackSize:
  ItemName1: 50
  ItemName2: 100

Sections

  • WeightMultiplier -- Defines a multiplier applied to the base weight of items.
  • WeightAmount -- Defines an absolute weight value for items. This value will override weight multiplier value for the item.
  • StackMultiplier -- Defines a multiplier applied to base stack sizes.
  • StackSize -- Defines an absolute stack size for items. This value will override stack multiplier value for the item.

Keys

  • Global -- applies to all items unless overridden.
  • <PrefabName> -- applies only to a specific item.

Automatically generated documentation

When you start a world, an Items stacks and weights.txt file will be generated in the BepInEx/config/shudnal.ItemStacksItemWeights directory.

This file contains all items available in your current game session. Use it to find the exact item names.

You can regenerate this file manually at any time using the iwisdocs console command.

Installation (manual)

extract ItemStacksItemWeights.dll to your BepInEx\plugins\ folder.

Configurating

The best way to handle configs is Configuration Manager.

Or Official BepInEx Configuration Manager.

Large stacks and save compatibility

Valheim 1.0.7 stores the built-in stack count in a 16-bit field. This mod preserves counts above 65,535 in the item's custom data and restores them when loading the item. Keep this mod installed on every peer that can save or load these items. Removing it while oversized stacks exist can reduce their saved counts.

The loader also accepts legacy StackCount metadata. New saves use the canonical FullStack key. Split oversized stacks into stacks of at most 65,535 before removing the mod.

Keep configured stack limits large enough for existing stacks: the game's inventory loader still enforces the active limit. This update cannot recover counts that were already truncated in an earlier save. Back up the world and characters before updating.

Dependencies

Install ConditionalConfigSync as a separate dependency; do not copy its DLLs into this mod's package.

Donation

Buy Me a Coffee

Discord

Join server

Changelog

1.1.1 Latest
  • Updated for the Valheim 1.0.7 release.
  • Completed the migration to the standalone ConditionalConfigSync dependency.
  • Updated required dependencies to BepInExPack Valheim 5.4.2350 and ConditionalConfigSync 1.0.5.
  • Updated the item creation hook for the release API.
  • Fixed initial YAML application and debounced reloads after file creation, replacement, or deletion; invalid updates keep the last valid settings.
  • Normalized configuration dictionaries consistently and validated stack/weight values to prevent invalid overrides and stack multiplier overflow.
  • Preserved counts above 65,535 with one custom-data serializer that reads current and legacy full-stack metadata. The mod is now required on the server and all clients in multiplayer.
  • Preserved rich-text formatting when hiding stack limits.
1.0.7
  • fields in configuration file can now be safely omitted
1.0.6
  • fixed actual mod assebly version

6 older entries, full version history & downloads →

Files

5 files · 133 KB download

Loading files…

Manual download
Just this mod One .zip — ItemStacksItemWeights 1.1.1
Files you'll get 3

Your browser may ask permission to download several files at once. How to install these manually

Manual installation instructions
1

Install BepInExPack Valheim

BepInExPack Valheim is required to run mods in Valheim.

Download BepInExPack Valheim 5.4.2360 · View mod page

Check out the mod page for detailed installation instructions.

2

Install ItemStacksItemWeights

This mod must be installed on both the client and the server.

Download ItemStacksItemWeights 1.1.1

Extract the ZIP and place the file(s) into the BepInEx/plugins/ folder inside your Valheim game folder.