Valheim.ItemInfiniteStack

A modern, high-performance, and intelligent Valheim mod that eliminates stack size limitations for resources, materials, consumables, and ammo — while strictly preserving 1 item per slot for weapons, armor, tools, and items with durability or upgrade tiers.

---

🌟 Key Features

1. ♾️ Safe Infinite / Unlimited Stacking

• Stack Wood, Stone, Metals, Ores, Food, Potions, Arrows, and Trophies up to 999,999,999 in a single slot.
• Fully protected against 32-bit arithmetic overflow — safe pickup and crafting even when moving millions of items.
• Works across player inventories, storage chests, personal chests, carts, ships, and obliterator containers.

2. 🛡️ Intelligent "1-Per-Slot" Protection (ยกเว้นไอเทมที่ต้องเก็บ 1 ชิ้น)

Items that possess unique properties or states never stack, preventing data loss:

• Durability Preservation: Any item with durability (swords, maces, bows, pickaxes, axes, torches) is strictly protected at 1 item per slot.
• Quality Tier Preservation: Weapons, armor, and tools with upgrade levels (Tier 1–4) remain strictly 1 per slot to prevent upgrade level collisions.
• Equipment Safety: Helmets, Chest armor, Leg armor, Capes/Shoulders, Shields, and Utility belts (Megingjord, Wishbone) are strictly exempt.
• Custom Blacklist & Whitelist: Effortlessly add custom modded items to either list through simple comma-separated config entries.

3. 🎨 Clean, Clutter-Free UI

• Eliminates the ugly vanilla 15/999999999 text format!
• AmountOnly Mode (Default): Shows clean RPG-style numbers (e.g. 150, 2,500).
• Compact Mode: Automatically formats large numbers cleanly (e.g. 1.5k, 25M).
• Slots with a single item (stack == 1) keep the number hidden, preserving pristine vanilla aesthetics.

4. 🎚️ Split Dialog Usability Overhaul

• Mouse Scroll Wheel Support: Scroll on the split dialog slider to adjust counts with ease.
• Precision Modifiers: Hold Shift for $10\times$ speed, Ctrl for $100\times$ speed, or both for $1,000\times$ speed.
• Quick Jump Keys: Press Home for 1 item, End for Max stack, and H or Space for Half stack ($50%$).
• Formats slider numbers cleanly to eliminate UI text clipping.

5. 📦 Stack Consolidation (One-Key Merge)

• Consolidates fragmented duplicate stacks of the same item into single slots with a single keypress (Default: Delete key).
• Optional EnableAutoConsolidateOnOpen automatically combines duplicate slots whenever you open a chest or inventory.

6. ⚖️ Optional Stack Weight Scaling

• Stacking 10,000 stones without weight adjustments would immediately encumber the player ($20,000\text{ kg}$).
• Configurable StackableWeightMultiplier: reduce weight by $50%$ (0.5), $90%$ (0.1), or make materials completely weightless (0.0).
• Equipment and combat gear retain their standard weight, keeping combat balance intact.

---

📥 Installation

Via Mod Manager (r2modman / Thunderstore)

1. Search for Valheim.ItemInfiniteStack in your mod manager.
2. Click Download with Dependencies.
3. Launch the game through the manager!

Manual Installation

1. Install BepInExPack Valheim.
2. Download Valheim.ItemInfiniteStack.dll.
3. Place Valheim.ItemInfiniteStack.dll into your <Valheim>/BepInEx/plugins/ directory.
4. Start the game. The config file will be created in <Valheim>/BepInEx/config/ckforgame.ItemInfiniteStack.cfg.

---

⚙️ Configuration Overview

Config file: BepInEx/config/ckforgame.ItemInfiniteStack.cfg

[1 - General]
## Master switch to enable or disable the mod.
Enabled = true
## Verbose debug logging.
LoggingEnabled = false

[2 - Stack Settings]
## Maximum stack limit for stackable items (safe bound: 999,999,999).
InfiniteStackLimit = 999999999
## Multiplier of vanilla stack size (0 = use InfiniteStackLimit).
GlobalStackMultiplier = 0

[3 - Exceptions (1-Per-Slot)]
## Protect items with durability (weapons, armor, tools).
ProtectDurabilityItems = true
## Protect upgradable items (max quality > 1).
ProtectQualityItems = true
## Protect equipment types (weapons, shields, armor, accessories).
ProtectEquipment = true
## Preserve vanilla stack size of 1.
PreserveVanillaOneStack = true
## Custom blacklist of prefab names that must remain 1 per slot.
CustomBlacklist = 
## Custom whitelist of prefab names to force infinite stacking.
CustomWhitelist = 

[4 - Weight Settings]
## Enable weight scaling for stackable items.
EnableWeightScaling = false
## Weight multiplier for stackable items (1.0 = normal, 0.5 = 50%, 0.0 = zero).
StackableWeightMultiplier = 1.0

[5 - UI & Display]
## Number display style: AmountOnly, Compact, StandardRatio.
DisplayFormat = AmountOnly
## Threshold above which Compact mode activates (e.g. 1000 -> 1k).
CompactThreshold = 1000
## Hide number text when stack count is 1.
HideSingleItemCount = true

[6 - Quality of Life]
## Enable mouse wheel and arrow keys on Split Dialog.
EnableSplitDialogEnhancements = true
## Base step size per mouse wheel tick.
SplitWheelStep = 1
## Automatically consolidate duplicate stacks upon opening chests.
EnableAutoConsolidateOnOpen = false
## Hotkey to merge duplicate stacks in open inventory / chest.
ConsolidateHotkey = Delete

---

🛠️ Architecture & Documentation

Full architectural specifications, design philosophy, and technical notes are included in the docs/ directory:

• Concept and Design Philosophy
• System Architecture
• Technical Specification
• Configuration Guide
• Roadmap & Milestones

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.