Armory

Craft an Armory Rack to save, store, and instantly recall named equipment sets — armor, weapons, shield, cape, utility, and the eight hotbar slots — without rummaging through chests every time you switch between farming, mining, exploring, and fighting.

The rack is also a real storage container. Drop your alternate gear in, walk up, press [Use], and pick the loadout you want. Whatever you're currently wearing is swapped back into the exact slot the new gear came from.

Features

• Named loadout slots — save your current equipment as "Farming", "Mining", "Boss", etc. Rename by clicking the slot name. Up to 10 slots per rack.
• Combined armor + hotbar — captures helm, chest, legs, cape, belt, trinket, and quickbar items 1–8.
• Loadouts are the cells you choose — each worn slot, hotbar key and quick slot can be in a loadout or out of it, and Load touches only what's in. A new loadout starts as armor and cape. Press + on a row to see every saved cell and add or remove some; the group labels add or remove a whole group. An armor set, a weapon kit and a food set load one after another to build an outfit.
• Storage + loadouts in one — the rack is also a Container, 12×6 by default and configurable. Load pulls items from the rack and your inventory; saved gear in the rack counts as "available".
• In-place swap — when Load equips a new item, whatever was in that slot gets stored back at the exact grid position the new item came from. Nothing ends up on the action bar unless that's where it was sitting.
• Live status — a green ● on the Load button means you're already wearing this loadout. Missing items show red in the summary text and red in the icon strip.
• Compare window — side-by-side view of your current gear vs. the saved set, with color-coded availability.
• Named racks — point at a rack and press Shift+[Use] to name it. The name shows on the hover text and heads both panels, so a wall of racks is readable at a glance.
• Personal or shared — a button in the panel decides whether anyone may open the rack or only the player who built it. Build your own rack, set it to Personal, and your loadouts and the gear behind them are yours.
• Optional in-game pause — config flag pauses the game while the panel is open, the way the ESC menu does. Works by itself solo or hosting alone; on a dedicated server it takes Pause My Server.

How to Use

1. Build an Armory Rack from the Hammer menu's Furniture tab. Requires a Workbench in range. See Recipe.
2. Press [Use] on the rack to open the panel — your inventory and the rack's storage appear alongside it. Each loadout row has an Equip button and a menu button (three bars) with Save, Show all cells, Compare and Delete; the steps below say "click Save" and so on, meaning that menu, or the row buttons if you turn those on in the config.
3. Click Save (↓) on a slot to capture what you're currently wearing and the items in hotbar slots 1–8.
4. Click Load (↑) on a saved slot to equip that loadout. Items come from the rack first, then your inventory. Whatever you were wearing gets stored in the slot the loaded item came from.
   • A row shows only the cells its loadout loads; a new one starts as helmet, chest, legs and cape. Press + to see every cell that was saved, click a cell to add it or take it out, and press - to hide the rest again. The label above a group (Armor, Weapons, Food, ...) adds or removes the whole group. Save always records everything, so a cell added later shows what you had there at the last save.
5. Click the slot name to rename it. Click the red x to delete the slot (empty slots and duplicates delete without confirmation; non-empty unique slots prompt first).
6. Click Shared / Personal in the top-left to choose who may open the rack. Only the player who built it can change this.
7. To name a rack, point at it and press Shift+[Use] — the same modifier Valheim uses for renaming a portal. An empty name returns it to "Armory".

Personal racks

A rack set to Personal can only be opened by the player who built it — loadouts, storage and all. That is how each player keeps their own sets: build a rack, make it personal, and the gear those loadouts need lives inside it. A Shared rack is open to everyone, which is what you want for a communal armory.

Valheim enforces this itself, with the same rule it applies to a personal chest, and the same consequence: nobody can hammer down a personal rack while it still holds items. To remove one, empty it first or set it back to Shared.

Recipe

Buildable at the Workbench. Black Forest tier.

Configuration

The config file is created at BepInEx/config/GBahns.Armory.cfg on first run.

[General]

• Lock Configuration (default: true) — while on, the server's synced settings override every client's, and only admins can change them.
• Pause Game While Armory Open (default: false) — pauses the game while the rack panel is open, the way the ESC menu does. It asks the game for the pause rather than stopping your own clock, so it works by itself when you are playing solo or hosting alone, and on a dedicated server it takes Pause My Server to grant it. Without that mod the request is refused on a server, which is the point — your clock stopping while the server runs on would only desync you. While the pause is in effect, a craft started from the inventory screen cannot finish until you close the rack; the craft timer counts game time.

[Storage] (synced from the server)

• Rack Width / Rack Height (default: 8 × 5) — the rack's storage grid. Every rack takes the new size, standing or not; items left outside a smaller grid are moved into it by whoever opens the rack. A grid taller than the container panel is drawn with smaller cells.

[UI]

• Style button on the Manage Loadouts panel — picks the model, decoration and wood for that one rack from three dropdowns, with a picture of the choice and the rack redrawn as you go, and everyone sees it that way. The metal decorations appear once you have reached that metal. Use my default makes it follow your settings again. Whoever can manage the rack's loadouts can restyle it, within a ward.
• Rack Model (default: Armoire) — Armoire is a modeled wardrobe with a crown, arched door panels and iron strap hinges; Cabinet is a plainer boarded one; Panels is the original build from floor planks and shutters. Switches at once on every rack in view.
• Rack Decoration (default: None) — what hangs on the doors of any model: Shields is a carved shield over crossed axes on each door; Bronze hangs the game's bronze buckler and crossed bronze swords on one door and crossed axes on the other, and Iron, Silver, Blackmetal, Carapace and Flametal the same in each later metal.
• Rack Wood (default: Darkwood) — the wood the Armoire and Cabinet are drawn in: the game's darkwood, the darkwood beam's brown planks, or plain wood.
• Show Summary Text (default: true) — show the textual list of items below each loadout's name (Helm:..., Chest:..., etc.).
• Show Icons (default: true) — show the row of item icons at the bottom of each loadout row.
• Show Row Buttons (default: false) — show Save, Load, +, Cmp and x on every row. Off puts them in a menu behind one button per row, which takes less room and lets the panel be narrower.

[Window]

• Panel Position X / Panel Position Y — auto-updated when you close the rack so the panel reopens where you last left it. Persists across game sessions.
• Panel Width / Panel Height — auto-updated when you drag the grip in the panel's bottom-right corner. A loadout's icon groups sit on one line when they fit the width and wrap only when they don't. A height of 0 fits the panel to its loadouts.

Requirements

• BepInEx 5
• Jotunn

Install it on the dedicated server as well as on every client, at the same version. The server turns away a client on an older version, because the rack's grid is a server setting the client has to follow. The rack is a new prefab, and a server that does not have it deletes racks built near the world spawn — permanently, with the gear and the saved loadouts inside them. That is Valheim's own handling of a prefab it cannot resolve, not something this mod can guard against from the client.

Compatibility

• Multiplayer compatible — loadout data is stored in the rack's ZDO, so it persists through world saves and is visible to other players. The rack opens as an ordinary container, so everything vanilla does for a chest it does here: the ownership hand-off that makes the storage grid draw and save, the refusal when someone else already has it open, wards, and the privacy setting.
• Container mods — AzuAutoStore, AzuCraftyBoxes, Grab Materials and anything else that scans for containers treat the rack as the chest it is, because that is exactly what it is.
• AzuExtendedPlayerInventory — supported. Gear worn in Azu's equipment row and items parked in its quick slots are saved with the loadout and restored to the same cells. Azu's extra inventory rows are treated as the ordinary bag they are and left alone.
• Should be compatible with most other mods; no vanilla systems are permanently altered.

Notes

• Save/Load/Compare/Delete buttons disable themselves when not applicable (e.g. Load is disabled when the slot is empty or when you're already wearing the saved set).
• The rack's doors swing open while the panel is open — purely visual, no gameplay effect.
• Load never draws a weapon. It puts items in your cells and leaves what you hold to you, as any chest does.

Changelog

2.3.0 — 2026-11-15

Everyone updates together: a rack's style now carries its crown, so 2.3.0 is the floor.

• The hammer menu's icon is a picture of your default rack, taken as the game starts and again when a Default setting changes (#86).
• The Armoire's crown is a choice (#83): Flat, the stepped molding it had, or a bonnet top, a hood rising from the shoulders to a crest in an S (Ogee) or to a point (Pointed), with a pediment board tracing the curve, at a Low, Medium or High rise. Two rows in the Style picker, shown for the Armoire; Default Crown Shape and Default Crown Height are what an Armoire wears until it is given its own.
• The [UI] config section is gone: the rack's look is under [Style] as Default Model, Default Decoration and Default Wood, named for what they are, the look of every rack nobody has styled with the Style button; the three Show settings for the loadout panel are under [Window]. All of them start from their defaults again; copy any you had changed from the old [UI] block, which stays in the file.

2.2.1 — 2026-11-14

• The storage grid defaults to 12×6, 72 slots, up from 8×5. The rack is two and a half times the size of the game's wardrobe (50 slots) and was holding 40.
• The recipe is priced to the piece: 16 fine wood, 8 core wood, 20 bronze nails, 4 bronze and 10 resin, in place of 8, 4, 4, 2 and 2 deer hide. Racks already built are unaffected and return the new amounts when dismantled.

2.2.0 — 2026-11-14

• Everyone must update together. A rack's style travels in a new message, so a server on this version turns away older clients.
• The rack is a modeled armoire: bracket feet, a stepped crown, raised and arched door panels, iron strap hinges and ring pulls, a shelf and a hanging rail inside, all in the game's own wood textures (#77). Rack Model under UI also offers a plainer boarded Cabinet and the original planks-and-shutters Panels; Rack Wood picks Darkwood, Brownwood or Plainwood.
• Rack Decoration hangs something on the doors of any model: carved shields over crossed axes, or the game's own shields and crossed weapons in bronze, iron, silver, black metal, carapace or flametal.
• A Style button on the Manage Loadouts panel dresses that one rack, model, decoration and wood, with a picture of each choice, for everyone who sees it; the metal decorations open up as you reach each metal; the settings above are what a rack wears until someone styles it.

2.1.0 — 2026-11-12

• Everyone must update together. The rack's grid is now a server setting, and a client on a different grid than the rack's owner would open rows it cannot see, so a server on this version turns away older clients.
• The rack's storage grid is configurable: Rack Width and Rack Height, default 8×5 (40 slots), synced from the server and locked to admins (#73). Racks already standing take the new size; items left outside a smaller grid are moved into it by whoever opens the rack.
• A grid taller than the container panel is drawn with smaller cells instead of a scroll bar.

2.0.1 — 2026-11-11

• Fixed a large frame-rate drop while looking at an Armory rack. Its hover text was rebuilt, and the localization system looked up by reflection, on every single frame.
• Fixed a frame-rate drop while an Armory panel is open. Each row rebuilt its summary, and searched both inventories for every item in it, on every frame. Rows now redraw when something changes them: an item moved, a rack changed by somebody else, a piece of gear equipped.

2.0.0 — 2026-09-21

Loadouts changed shape in this release: what a loadout loads is now chosen cell by cell, and the panel was rebuilt around that. Everything below is new since 1.3.0.

• A loadout is the cells you choose. Every cell a loadout saves — each worn slot, each hotbar key, each quick slot — can be in the loadout or left out of it. Load applies the cells that are in and leaves everything else exactly as it is. So "Fenris" can be armor alone, "Bow kit" the bow in 4 and the arrows in 7, and "Ashlands" the food and meads, and loading all three in a row builds the outfit. Ten slots go a lot further that way.

• A new loadout starts with the helmet, chest, legs and cape and nothing else. That is what most switching is; the belt, wisplight, food and tools you carry everywhere don't need saving.

• A row shows only the cells its loadout loads. Press + on the row to see every cell that was saved, click cells to add them or take them out, and press - to tuck the rest away again. The label above a group — Armor, Weapons, Food and so on — adds or removes the whole group at once, and its color says whether the group is all in, all out, or mixed.

• Save still records everything you are wearing and carrying, and keeps the row's choices cell for cell, so re-saving "Fenris" over new gear never resets what it loads. A cell added back later shows what was there at the last save.

• The trinket slot is part of a loadout now, under Accessories with the belt. It was not captured before.

• A worn slot that is in the loadout but empty means "wear nothing there": an included empty Cape takes your cape off. The summary line says so, as "no cape".

• Load no longer draws a weapon. It puts gear in the cells you chose and leaves what you hold to you, the way any chest does. The Weapon and Shield entries that recorded the hands are gone; a drawn weapon has no slot of its own, it sits in a hotbar cell, and that is where it is listed.

• Racks saved by an older version load everything, as they always did, until you take a cell out. An older version reading a rack from this one ignores the choices and the trinket, and drops both if it saves the slot again.

• Icons are a little smaller to make room for the labels.

• A rack keeps exactly the slots you leave it with. It used to pad itself back up to five every time it was opened, so deleting the last three was undone on the next visit. Only a rack that has never been saved to starts with five.

• The row buttons fold into a menu. By default each row now has an Equip button and a three-bar button that opens a menu with Save, Show all cells, Compare and Delete. That takes less than half the room, so the panel can be dragged much narrower. Equip reads "Wearing" in green while you have the loadout on. Show Row Buttons in the config brings the five separate buttons back.

• The panel can be resized. Drag the grip in its bottom-right corner. The rows follow the width as you drag: a loadout's icon groups sit on one line when they fit and wrap onto another only when they don't, so a wider panel is a way to keep every loadout on a single line. The size is remembered with the position; until you set a height, the panel fits its loadouts.

• "Saved", "Loaded" and "Deleted" now appear above the panel. They were Valheim's center message before, which draws beneath any mod panel, so they went unread behind this one.

• Saving a loadout no longer sweeps up ordinary inventory. With AzuExtendedPlayerInventory's "Extra Inventory Rows" turned on, whatever happened to be lying in those extra bag rows — resin, nails, arrows — was saved as part of the loadout, and Load would then try to put it back. The capture assumed the bag was exactly 8×4 and treated every cell beyond that as one of Azu's special slots. It now asks Azu which cells are its quick slots and equipment row, and captures only those; the rest of the bag is yours, however many rows it has.

• Loadouts saved before this version still carry those stray entries. Re-save each affected slot once and they are gone.

• Without AzuExtendedPlayerInventory, only worn gear and the hotbar are captured, as before. An Azu older than the version that publishes the cell queries gets the same treatment, with a note in the log.

1.3.0 — 2026-09-16

• Racks can be named. Point at one and press Shift+[Use] — the same modifier that renames a portal or edits a sign — and type a name. It replaces "Armory" on the hover text, heads the loadout panel, and heads the storage panel beside it, so a row of racks along a wall tells you which is which without opening any of them. Leave the name empty to go back to "Armory".
• A rack can be yours alone. A Personal/Shared button in the top-left of the panel decides whether anyone may open the rack or only the player who built it. Personal is how you keep your own loadouts without sharing a rack's ten slots with everyone on the server — and since a rack is also its own storage, the gear each set needs comes with it. Only the builder can flip the switch; everyone else sees which it is.
• The enforcement is Valheim's own, not this mod's: a personal rack refuses with the same message a personal chest does, and the game will not let anyone hammer one down while it still holds items. If you want to remove a personal rack, empty it first or set it back to Shared.
• The setting lives on the rack rather than in your config, because the game checks access on both the player asking and the machine that owns the rack — a per-player setting would let those two disagree about who may open what.
• Everyone needs this version for Personal to hold. That same pair of checks runs on the machine of whoever is asking and on whoever owns the rack — usually the player standing at it, not you. A player still on an older version leaves the rack public as far as their game is concerned and walks straight in, and once in, nothing stops them saving over your loadouts either. Update the server and every player together. This is no different from vanilla's personal chest, which is only enforced by the copy of the game doing the asking.
• A rack the game never recorded a builder for cannot be made personal, and says so. Access is enforced by comparing against the builder, so a rack with no builder on record would refuse everyone permanently — and a private container holding items cannot be hammered down either.

1.2.0 — 2026-09-15

Install this version on your dedicated server as well as on every client. Earlier versions were client-only.

• A server without this mod deletes racks built near the world spawn. The rack is a prefab that exists only because this mod creates it, and Valheim does not simply ignore an object a server cannot resolve — the server takes ownership of it and destroys it, permanently, with the stored gear and every saved loadout inside. It only reaches as far as the server simulates around the world center, so a base further out was never at risk, but a rack near spawn was. Installing the mod on the server is the fix, and the gate that made that impossible is gone.
• The rack behaves like a chest in multiplayer, because it now is one. It used to open its storage itself rather than letting the game do it, which skipped the hand-off Valheim performs when you open a container. Anyone who was not already the object's owner got the loadout panel with no storage grid beside it, and anything they moved into the rack — including the gear a Load swapped back in — was discarded without a word. Opening the rack is now an ordinary container open, so the grid draws and saves for whoever walks up to it, a rack someone else already has open says so instead of letting you both edit it, and wards and the container privacy setting apply exactly as they do to the chest it is built from.
• The optional pause no longer throws the inventory off the screen. Valheim slides the inventory and container panels into place with an animation, and an animation runs on game time, so stopping the clock froze that slide part-way: the player's grid sat off the top of the screen with the rack's grid over what was left of it. It now finishes properly while the pause is held.
• That pause asks the game rather than stopping your own clock. It goes through the same call the ESC menu makes, so it still works by itself solo or hosting alone, while on a dedicated server it takes Pause My Server to grant it. Previously it froze your client while the server carried on without you, which is a good way to desync. One limitation remains: while the pause is in effect a craft started from the inventory screen cannot finish, because the craft timer counts game time too. Close the rack to let it run.
• Nothing needed to change for AzuAutoStore, AzuCraftyBoxes, Grab Materials or anything else that works with containers. They always saw the rack, because its container is a real one.

1.0.0 — 2026-09-09

First public release, built for Valheim 1.0.7.

• Armory Rack build piece (Hammer > Furniture; needs a Workbench in range) that is both a storage container and a loadout station.
• Up to 10 named loadouts per rack, each capturing helm, chest, legs, cape, utility, right hand, left hand and hotbar slots 1-8.
• Load pulls gear from the rack first, then your inventory, and stores what you were wearing back into the exact slot the new item came from.
• Live status on each slot, a compare window for current gear versus the saved set, and an optional pause while the panel is open.
• Loadouts are stored in the rack's ZDO, so they survive saves and work in multiplayer.