ArmorGallery

ArmorGallery transforms your Valheim armor stands into dynamic, rotating showroom galleries! Link one or multiple chests to an Armor Stand to periodically cycle through full armor and weapon sets automatically, or interact with a clean in-game UI to manage, cycle, pose, and configure your equipment showroom.

✨ Features

• Multi-Chest Targeted Linking: Link up to 12 chests (configurable) to a single Armor Stand within configurable distance limits (5m–30m).
• Targeted Link Mode: Enter Linking Mode with <LeftShift + E> while looking at a stand. Golden particle connection trails visually show which chests are linked in real time. Simply look at any chest and press <E> to link or unlink it.
• Strict 1:1 Chest Association: Prevents overlap by ensuring each chest is exclusively bound to one Armor Stand.
• Chest UI Integration & Paging: Opening a linked chest reveals a custom ArmorGallery header displaying the linked stand name, total configured sets, current pose, weapon stance toggle (Equipped vs Stowed), and quick hotkeys (Q / E) to page through all linked chests seamlessly.
• Continuous Set Rotation: Organizes chest rows into continuous sets across all linked chests (e.g. Chest 1 has Sets 1–4, Chest 2 has Sets 5–8) and cycles through them periodically.
• Multiple Cycling Modes:
  • Sequential: Cycles row-by-row in order across linked chests.
  • RandomRow: Picks a random complete armor set on each cycle.
  • Chaos: Mix-and-matches individual armor and weapon slots from random rows for wild cosmetic combinations.
• 1-Click Quick Equip & Set Swapping: Each row in the chest interface features a dedicated Equip button. Clicking it instantly equips the entire set onto your character, seamlessly swapping your currently worn armor, cape, weapon, and shield directly into that chest row with a single click!
• Pose & Stance Customization:
  • Cycle stand poses on the fly with <LeftAlt + E>.
  • Toggle weapon stance between Equipped (in hands) and Stowed (on hips/back).
  • Optional config options to automatically randomize pose and/or weapon stance on each rotation cycle!
• 100% Vanilla Safe & Lossless: Items remain stored directly in vanilla chest inventories. No custom items or proprietary database serialization. If the mod is uninstalled, all gear remains safe and sound inside your chests.
• Multiplayer Synchronized: Built with robust Proximity Authority and ZDO network synchronization. The closest active player drives the rotation interval, avoiding desyncs, ownership fighting, or screen flickers. Other players are locked out while someone is actively editing links to prevent race conditions.

📦 Supported Chests & Container Rules

• Compatible Chests: You can link any of the three vanilla storage chests:
  • 🪵 Wood Chest (5 columns × 2 rows = up to 2 sets)
  • 🔗 Reinforced Chest (6 columns × 4 rows = up to 4 sets)
  • ⬛ Black Metal Chest (8 columns × 4 rows = up to 4 sets + extra free storage)
• Non-Linkable Containers: Private/Personal Chests, Carts, Ships, the Obliterator, and other non-chest storage containers cannot be linked to prevent loss or access conflicts.

🛡️ Slot Guidance & Misplaced Item Handling

• Column Slot Guidance: Once a chest is linked to an Armor Stand, Columns 1–6 display clear visual category headers (Head, Chest, Legs, Shield, Weapon, Cape) and restrict drag-and-drop placement so items naturally land in their proper columns.
• Extra Columns (Black Metal Chests): Columns beyond Column 6 are unrestricted free storage and are completely ignored by the set cycler.
• Smart Row Resolution: If an unmodded player deposits gear, or if a chest had items placed prior to linking, ArmorGallery never modifies or shifts your chest inventory. Instead, the visual mannequin intelligently scans the row, finds each piece of gear, and equips it to the stand dynamically.
• Misplaced Item Highlighting: Any item resting in Columns 1–6 that does not match the column header is highlighted with a gentle amber slot glow and an amber corner warning badge (!), giving clear visual feedback without locking or modifying the item.

🎮 How to Use

1. Link Chests to an Armor Stand

1. Place an Armor Stand and one or more compatible Chests nearby (within 20 meters by default).
2. Look at the Armor Stand and press <LeftShift + E> to enter Linking Mode.
3. Golden sparkle beams will connect the stand to any currently linked chests.
4. Look at any nearby chest and press <E> to toggle linking it to the stand.
5. Look back at the Armor Stand and press <LeftShift + E> to exit Linking Mode and begin automatic rotation!

2. Organize Equipment in Chests

Open your linked chest and arrange your equipment into 6-column set rows:

• Empty slots in a row are respected (e.g., a set without a helmet displays a bare head).
• 2-handed weapons automatically adjust shield placement to the back.
• Misaligned items display an amber glow & warning badge, while Smart Row Resolution still displays the gear set on the stand.

3. Manage Sets & Chest UI

• Pressing <E> on a linked Armor Stand opens the primary linked chest directly.
• Use <Q> and <E> (configurable) while the chest inventory is open to flip through all linked chests without walking between them.
• Click the Equip button next to any row to instantly equip or swap that entire gear set with what your Viking is currently wearing.
• Click the Stance Button (Equipped / Stowed) in the chest UI to change how weapons are held.
• Look at the stand and press <LeftAlt + E> anytime to cycle poses.

⚙️ Configuration

Configuration file is located at BepInEx/config/com.drakosdj.armorgallery.cfg:

🌐 Multiplayer Compatibility

• Client & Server Friendly: Can be installed client-side or on dedicated servers.
• Proximity Master Authority: Rotation timers and configuration settings are driven by the single closest active player to each stand, preventing network conflicts or timer overlaps.
• Linking Lockout: While a player is actively editing links on a stand, other players see an amber notice and cannot overwrite link settings until the editor finishes.

📦 Installation

1. Install BepInEx for Valheim.
2. Extract ArmorGallery.dll and icon.png into BepInEx/plugins/ (or use the Thunderstore / r2modman Mod Manager).
3. Launch the game and enjoy your armory!

💬 Discord

Join our Discord Server for discussion, suggestions, and bug reports!

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.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.