ArmorGallery
Links Armor Stands to nearby chests to periodically cycle and rotate through multiple visual armor and weapon sets automatically.Changelog
All notable changes to ArmorGallery will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[1.0.5] - 2026-09-28
Improved
- Dedicated Server Compatibility & Stability: Shored up interactions when the mod is installed on dedicated servers. The server now cleanly bypasses client visual routines and stand ownership claiming, preventing potential server-side desync, console noise, and unnecessary overhead.
[1.0.4] - 2026-09-18
Fixed
- Chest Link Persistence Across Restarts: Fixed an issue where armor stands could appear empty, stop rotating sets, or reset to 0 linked chests after logging out, loading a world, or restarting a dedicated server.
- Self-Healing Chest Connections: Armor stands now preserve their linked chests' stationary positions alongside internal game IDs. If Valheim reassigns chest IDs during world saving or zone streaming, stands automatically rediscover and reconnect to their linked chests, immediately displaying armor upon loading.
- Phantom Chest Count Inflation: Fixed a bug where armor stands could display inflated chest counts (e.g. showing 4 or 5 linked chests) and draw sparkle link lines to unrelated chests across the base after reloading.
- Duplicate Chest Linking: Fixed an issue in linking mode where targeting an already-linked chest and pressing
[E]could add a duplicate link instead of toggling the chest off and unlinking it.
[1.0.3] - 2026-09-10
Added
- Updated to comply with the Valheim v1.0 (1.0.7) update.
- Expanded Container Support: Added full compatibility for the new Valheim 1.0 Grausten Chest (8 columns × 5 rows = up to 5 sets + extra storage) and Wardrobe furniture (5 columns × 10 rows = up to 10 sets!).
- Native Scrolling on Tall Containers: Smooth vertical scrolling on tall containers with automatic viewport boundary trimming and scrollbar tracking.
- Pinned Column Headers: Category headers (
Head,Chest,Legs, etc.) are anchored to the container frame above the scrollable viewport, staying permanently visible and aligned as you scroll through sets. - Foreign Item Safe Recovery: If an unmodded vanilla player attaches an item to a stand while no modded player is in the zone, returning modded players trigger an automatic drop of the attached gear to the ground in front of the stand with a HUD alert, preventing gear loss, item overwrites, or slot corruption.
Changed
- Pure Mannequin Architecture & Dual-Layer Sentinel Locking: Real physical items now reside strictly in chests, with the stand acting purely as a visual mannequin. Stand slots are locked with an internal sentinel hash to block accidental hotbar attachments in both modded and vanilla sessions without duplicating items.
- Strict 6-Container Whitelist: Restricted linking to the 6 approved player-built storage pieces (Wood Chest, Barrel, Reinforced Chest, Black Metal Chest, Grausten Chest, and Wardrobe) to prevent unintended linking or UI issues with unapproved containers.
- Container UI Layout & Scaling: 4-row chests (Reinforced Chest) are now dynamically scaled (0.85) to provide vertical clearance, pulling bottom action buttons cleanly inside the wooden container frame.
Fixed
- Valheim 1.0 Container UI Visibility: Fixed an issue where container headers, row labels, and equip buttons failed to inject due to Valheim 1.0's refactored
InventoryElementcomponent architecture. - Scrollbar Locking on Linked Containers: Fixed an issue where frame-by-frame transform enforcement locked the vertical position of scrollable grids and prevented scrolling.
- Column Header Horizontal Offset: Fixed an issue where column headers on scrollable containers were shifted to the right outside the container frame due to anchor misalignment.
- Slot Overlap on Scrollable Containers: Eliminated slot overlap over the top column headers and bottom action buttons by applying dedicated viewport padding.
[1.0.2] - 2026-08-31
Fixed
- Death & Respawn Camera Lock / Multiplayer Freeze: Fixed an issue where peer RPC announcement broadcasts triggered on
Player.OnSpawnedcreated an infinite ping-pong network loop between clients upon player death and respawn, locking the death camera in a permanent swirl and freezing connected players' screens. - Link Persistence Across World Restarts: Fixed an issue where asynchronous
ZNetSceneworld loading and sector deactivation caused stands to prematurely clear their saved links during startup or player disconnects. Links are now permanently preserved in the stand's ZDO. - Clean Stand Visual Lifecycle & Ingest: On game logout/quit, stand visual displays are safely cleared to prevent item duplication on unmodded vanilla servers while no modded players are online. Upon modded player reconnect, stands automatically re-dress from chests, and any gear placed on empty stands by unmodded players is safely ingested into the chest.
[1.0.1] - 2026-08-30
Added
- Misplaced Item Highlighting: Misaligned items in restricted columns (0–5) of linked chests now display an amber glow overlay along with an amber corner warning badge (
!) for clear visual feedback. - Smart Row Resolution: Stand mannequins dynamically resolve set items from any row column, ensuring gear placed by non-modded players or prior to linking is properly displayed without modifying chest data.
Fixed
- Base Chest Inventory Loss: Fixed an issue where closing any unlinked container (base storage chests, carts, ships, etc.) triggered set sorting logic that caused duplicate inventory grid coordinates and item loss.
- Strict Container Isolation: ArmorGallery now strictly ignores all containers not explicitly linked to an Armor Stand.
- Removed Mutating Chest Sorters: Removed automatic chest row repositioning routines; chest inventory is now treated strictly as the immutable source of truth.
[1.0.0] - 2026-08-30
Initial Release
Core Features
- Multi-Chest Targeted Linking: Link up to 12 chests to a single Armor Stand with customizable distance limits (5m–30m).
- Visual Link Mode: Interactive linking mode (<LeftShift + E>) featuring persistent golden particle connection trails to indicate active chest bindings.
- Strict 1:1 Association: Prevents duplicate binds by locking each chest to a single Armor Stand.
- Integrated Chest UI & Fast Paging: Custom ArmorGallery header with stand status, pose indicator, weapon stance toggle (Equipped vs Stowed), and hotkeys (Q / E) to page through linked chests instantly.
- 1-Click Quick Equip & Swap: Dedicated Equip button on each chest row to instantly equip the full gear set and swap your currently worn items into the chest with a single click.
- Continuous Set Rotation: Groups 6-slot armor set rows across all linked containers with continuous numbering (e.g. Sets 1–4 in Chest 1, Sets 5–8 in Chest 2).
- Flexible Cycling Modes: Full support for Sequential, RandomRow, and Chaos (mix-and-match) rotation modes.
- Pose & Stance Customization:
- Hotkey-based pose cycling (<LeftAlt + E>).
- Weapon stance toggle (Equipped vs Stowed).
- Configurable random pose on cycle (omitting gear pile pose 15).
- Configurable random weapon stance on cycle.
- Lossless & Vanilla Safe: Direct vanilla inventory storage without custom items or proprietary database serialization.
- Multiplayer Synchronized: Proximity Master Authority ensures the nearest player drives rotation timers, eliminating ownership fighting, duplicate timer triggers, and screen flickers.
- Concurrency Protection: Stand editing lockout with hover feedback to prevent simultaneous link edits.
