ExpandedPlayerInventory

A standalone Valheim BepInEx mod that expands player inventory rows (up to 50 rows, default 20) with a built-in scrollbar and mouse-wheel scrolling support.

Known Issues & Workaround

[!NOTE] Occasional Blank Grid on Initial Open:

• Symptom: In certain environments or heavy modded setups, opening the inventory for the very first time after joining a world, respawning, or loading into a new area may occasionally display only the wooden background panel without the item slots rendering immediately.
• Quick Solution: Simply close (Tab or Esc) and reopen the inventory once. This forces the UI layout to synchronize, after which all item slots, graphics, and scrolling will render smoothly and normally for the remainder of your session.

Features

• Configurable player inventory rows (4 to 50 rows).
• Integrated Valheim-themed scrollbar.
• Mouse scroll wheel and Gamepad navigation support.
• Fully standalone: can be used with or without ValheimPlus.

Configuration

Configuration file is generated at BepInEx/config/ckforgame.ExpandedPlayerInventory.cfg after first launch:

• playerInventoryRows: Number of player inventory rows (min 4, max 50, default 20).
• scrollSensitivity: Mouse wheel scroll sensitivity (min 50, max 1500, default 350). Higher values scroll faster with less wheel movement.
• rememberScrollPosition: Remember the last scroll position when opening the inventory, instead of always jumping back to the top (default true).

Compatibility with ValheimPlus

[!IMPORTANT] If you are using ValheimPlus, please ensure inventoryRows in your ValheimPlus configuration (valheim_plus.cfg) is set to 4 (the vanilla default) or leave the [Player] inventory expansion disabled.

Letting ValheimPlus expand inventory rows simultaneously will conflict with this mod's scrollbar positioning and grid layout management. Use ExpandedPlayerInventory's configuration to specify your desired rows instead.

Installation

• Using Mod Manager (r2modman / Thunderstore): Click Install with Mod Manager.
• Manual Installation:
  1. Install BepInExPack Valheim.
  2. Extract ExpandedPlayerInventory.dll into <GameDirectory>/BepInEx/plugins/.

Changelog

• v1.2.0:
  • Feature: Added Scroll Position Memory (rememberScrollPosition, default true), keeping your scroll view intact across inventory toggles and chest looting.
  • Feature: Dynamic Resolution & UI Scale adaptation (automatically recalculates layouts upon settings changes without game restarts).
  • Reliability: Added item safety defense-in-depth net in Humanoid.DropInvalidItems and Player.SetInventorySize to strictly prevent item dropping or loss.
  • Reliability: Enhanced scrollbar template search with programmatic UI fallback.
  • Reliability: Thorough session state reset on logout and world join.
• v1.1.0:
  • Feature: Added configurable mouse wheel scrollSensitivity (default 350, range 50–1500) for ~5x faster, effortless scrolling.
  • Feature: Standardized plugin GUID and configuration filename to ckforgame.ExpandedPlayerInventory.cfg (with automatic migration from legacy config).
  • Fix: Resolved ValheimPlus mod conflict where container resizing caused negative viewport heights and culled item slots on first open.
  • Fix: Fixed repeated 20-row pop-in / flashing by restricting opening synchronization strictly to the first open of each world session.
  • Fix: Added runtime layout failsafes in InventoryGui.Update preventing item graphics from ever being culled while the canvas settles.
• v1.0.4: Deferred clipping to after Animator transition; fixed compatibility with ValheimPlus and other inventory mods.
• v1.0.3: Added known issues and temporary workaround documentation; improved canvas and clipping update handling during inventory opening animation.
• v1.0.2: Fixed first-time inventory open render bug where slots were displaced off-screen and invisible until reopened.
• v1.0.1: Initial release with standalone scrolling inventory and ValheimPlus compatibility guidance.

Credits & Special Thanks

• ValheimPlus: Special thanks to the ValheimPlus project and its contributors for the inspiration and foundational concept of inventory scrolling and grid expansion mechanics.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Changelog

All notable changes to this project will be documented in this file.

[1.2.0] - 2026-09-23

Added

• Scroll Position Memory:
  • The inventory now remembers its last scroll position across opens and chest interactions instead of abruptly snapping back to the top hotbar every time.
  • Added rememberScrollPosition configuration setting (default true) allowing players to toggle this feature or keep classic top-reset behavior.
• Dynamic Resolution & UI Scale Auto-Adaptation:
  • Dynamically detects resolution, fullscreen/windowed toggles, and UI Scale adjustments in settings, automatically recalculating base offsets and viewport positioning without restarting the game.
• Item Safety Net (DropInvalidItems & SetInventorySize Guard):
  • Added defensive guards preventing Valheim's internal Humanoid.DropInvalidItems() and Player.SetInventorySize from mistakenly ejecting or dropping items from rows 5–50 onto the ground during loading or state changes.
• Robust Fallback Scrollbar Component:
  • Enhanced template scrollbar discovery with multi-tier fallback and programmatic generation to guarantee reliable scrolling even when other mods alter the crafting UI hierarchy.
• Complete Session State Cleanup:
  • Enhanced session cleanup on Game.Logout, Game.Start, and InventoryGui.Awake to prevent any static state leaks between character switches or world reloads.

[1.1.0] - 2026-09-20

Added

• Configurable Mouse Wheel Scroll Sensitivity: Added scrollSensitivity setting in ckforgame.ExpandedPlayerInventory.cfg (default 350, range 50–1500).
  • Scrolling is now ~5x faster by default, allowing effortless navigation through large inventories without excessive wheel swiping.
  • Fully adjustable via configuration file or BepInEx Configuration Manager in-game.
• Valheim Community Standard Plugin GUID & Config: Standardized Mod GUID to ckforgame.ExpandedPlayerInventory and configuration filename to ckforgame.ExpandedPlayerInventory.cfg. Automatically migrates settings from legacy com.custom.expandedplayerinventory.cfg on first run so existing configurations are seamlessly preserved.

Fixed

• ValheimPlus Mod Conflict & Negative Viewport Bounds: Resolved conflict where ValheimPlus resized the background frame (m_player) to the full configured row count (e.g. 20 rows / 990.5px). Stretch-anchored grids evaluated to a negative viewport height (-566.0px), causing RectMask2D to cull all inventory slots on first open:
  • Added InventoryGui_SetInventorySize_Patch (Priority.First) to clamp background frame sizing to visible rows (maximum 6).
  • Decoupled m_playerGrid and scrollbar from parent stretch anchors to fixed top anchors (anchorMin.y = 1f, anchorMax.y = 1f, pivot.y = 1f), guaranteeing positive viewport height (+424.5px) at all times.
• Repeated 20-Row Inventory Flashing on Open: Fixed an issue where opening synchronization disabled RectMask2D on every single inventory open, briefly displaying all 20 unclipped rows across the screen for 2-3 frames:
  • Opening synchronization and delayed clipping now strictly run once on the first open of each world session.
  • Subsequent inventory opens in the same world session render instantly, smoothly, and cleanly with 6 rows and scrollbar already in place.
  • Automatically resets session state on Game.Logout, Game.Start, and InventoryGui.Awake.
• First-Time Open Blank Background Failsafe: Added continuous runtime check in InventoryGui.Update that immediately disables RectMask2D if viewport height is non-positive or tiny, preventing graphics from being culled during canvas layout initialization.

[1.0.4] - 2026-09-19

Fixed

• First-time inventory open bug (definitive fix): Resolved the root cause where RectMask2D.PerformClipping() was called during the Animator's scale-0 opening transition, causing all inventory slots to be culled as invisible. Clipping is now deferred to the Update loop and only performed after the panel reaches non-zero world-space size.
• Mod compatibility (ValheimPlus, etc.): Fixed conflict where other mods setting m_scrollbar before us caused ScrollRect and ScrollRectEnsureVisible to never be created. These components are now ensured independently via EnsureScrollRect().
• Patch execution order: Added [HarmonyPriority(Priority.Low)] on InventoryGui.Show postfix and moved all critical visual state (pivot lock, scroll position, grid update, clipping) into the deferred Update handler so it runs after all other mods' postfixes complete.
• Layout rebuild before clipping: Added LayoutRebuilder.ForceRebuildLayoutImmediate() to ensure grid content is properly sized before clipping pass.

[1.0.3] - 2026-09-19

Documentation

• Known Issues & Workaround: Added notice and temporary workaround instructions for first-time open empty background issue.

Changed

• Opening Animation & Clipping Updates: Added dynamic canvas layout and clipping synchronization during the opening animation in InventoryGui.Update.
• Pre-warming on Spawn: Pre-initializes inventory grid elements upon player spawn.

[1.0.2] - 2026-09-19

Fixed

• First-time inventory open bug: Fixed an issue where the inventory appeared completely blank (no item slots) when opened for the first time after loading or spawning into the world.
• Top-aligned pivot guarantee: Ensured the grid root pivot is locked to top (pivot.y = 1f), preventing Unity ScrollRect from displacing item slots off-screen.
• Scroll synchronization: Synchronized ScrollRect normalized position and scrollbar value directly upon opening so hotbar slots are always visible.

[1.0.1] - 2026-09-19

Added

• Integrated native Valheim-styled scrollbar for player inventory.
• Mouse scroll-wheel support for inventory grid.
• Gamepad/controller navigation follow support.
• ValheimPlus compatibility guidelines.

[1.0.0] - 2026-09-19

Added

• Initial release of ExpandedPlayerInventory.
• Configurable player inventory rows (min 4, max 50, default 20).
• Data-layer persistence across game sessions and world saves.