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

• BepInExPack Valheim 5.4.2350
• ConditionalConfigSync 1.0.5

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

Donation

Buy Me a Coffee

Discord

Join server

1.1.1

• 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

1.0.5

• support of HTML tags inside stack text (ZenUI compatibility and possibly other similar mods)

1.0.4

• keyboard shortcut to bypass stack size no longer server synced

1.0.3

• added new configs: compact stack size, compact amount size, shortcut to bypass changes

1.0.2

• fixed side incompatibility with mods using inhouse localization implementation (like PlantEverything and QSSSRT)

1.0.1

• fixed nasty issue with consecutive applying of multipliers on consecutive log off and log on

1.0.0

• Initial release