You are viewing a potentially older version of this package. View Latest Version
ArmorGallery
Links Armor Stands to nearby chests to periodically cycle and rotate through multiple visual armor and weapon sets automatically.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 (
EquippedvsStowed), 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
Equipbutton. 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!
- Cycle stand poses on the fly with
- 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 Restrictions & Automatic Row Sorting
- Column Slot Restrictions: Once a chest is linked to an Armor Stand, slots in Columns 1–6 become strictly restricted based on their headers (
Helmet,Chest,Legs,Shield,Weapon,Cape). You can only place matching equipment types into each column. - Extra Columns (Black Metal Chests): Columns beyond Column 6 are unrestricted free storage and are completely ignored by the set cycler.
- Full Row Auto-Sorting: If a chest was already populated before linking, or if an unmodded player deposits gear without slot restrictions, closing the chest (or initiating a cycle) automatically scans and sorts the entire row, moving each item (Helmets, Chests, Legs, Shields, Weapons, Capes) into its proper designated column!
🎮 How to Use
1. Link Chests to an Armor Stand
- Place an Armor Stand and one or more compatible Chests nearby (within 20 meters by default).
- Look at the Armor Stand and press
<LeftShift + E>to enter Linking Mode. - Golden sparkle beams will connect the stand to any currently linked chests.
- Look at any nearby chest and press
<E>to toggle linking it to the stand. - 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:
| Column 1 | Column 2 | Column 3 | Column 4 | Column 5 | Column 6 | Extra Columns |
|---|---|---|---|---|---|---|
| Helmet | Chest | Legs | Shield | Weapon | Cape | Free Storage |
- 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.
- The entire row auto-sorts into matching columns whenever chests are closed.
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
Equipbutton 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:
| Category | Setting | Default | Description |
|---|---|---|---|
| General | Enabled |
true |
Enable or disable automatic set cycling. |
| General | RotationInterval |
60.0 |
Time in seconds between set rotations. |
| General | RotationMode |
Sequential |
Cycling mode: Sequential, RandomRow, or Chaos. |
| General | MaxLinkedChests |
6 |
Maximum number of chests that can be linked to a single stand (1–12). |
| General | MaxLinkDistance |
20.0 |
Maximum distance in meters between stand and chest (5m–30m). |
| General | RandomizePoseOnCycle |
false |
When enabled, automatically picks a random pose on each cycle (excluding gear pile pose 15). |
| General | RandomizeStanceOnCycle |
false |
When enabled, randomly alternates weapons between Equipped and Stowed on each cycle. |
| General | ModifierKey |
LeftShift |
Hotkey modifier held with Use to toggle Linking Mode. |
| General | PoseModifierKey |
LeftAlt |
Hotkey modifier held with Use to cycle poses. |
| Controls | PrevChestKey |
Q |
Hotkey to page to previous linked chest in the UI. |
| Controls | NextChestKey |
E |
Hotkey to page to next linked chest in the UI. |
🌐 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
- Install BepInEx for Valheim.
- Extract
ArmorGallery.dllandicon.pngintoBepInEx/plugins/(or use the Thunderstore / r2modman Mod Manager). - Launch the game and enjoy your armory!
💬 Discord
Join our Discord Server for discussion, suggestions, and bug reports!