ArmorGallery

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 ` 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 ` 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 ``.
• 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 Containers (Strict Whitelist): To guarantee complete reliability and prevent UI or inventory conflicts, linking is strictly restricted to the 6 official player-built storage pieces:
• 🪵 Wood Chest (5 columns × 2 rows = up to 2 sets of 5 pieces)
• 🛢️ Barrel (6 columns × 2 rows = up to 2 full sets)
• 🔗 Reinforced Chest (6 columns × 4 rows = up to 4 full sets)
• ⬛ Black Metal Chest (8 columns × 4 rows = up to 4 sets + extra free storage)
• 🪨 Grausten Chest (8 columns × 5 rows = up to 5 sets + extra free storage) (Valheim 1.0 / Ashlands)
• 🚪 Wardrobe (5 columns × 10 rows = up to 10 sets of 5 pieces!) (Valheim 1.0)
• Non-Linkable Containers: Private/Personal Chests, Carts, Ships, the Obliterator, and third-party mod containers cannot be linked to prevent loss, UI misalignment, 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 & Grausten 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