VanityOutfit
Cosmetic outfits from the Barber Station: pick the helmet, chest, legs, cape and trinket you show, with no stats. Presets, Home outfit and quick swap hotkey. Client side.VKTR_VanityOutfit
A vanity outfit system inspired by Terraria. The mod gives the same level of expressive freedom while staying true to Valheim's harsher philosophy.
What it does
Hold Use on a Barber Station to open the Outfit menu. Click any armor piece in your inventory and it becomes the look of that slot. The piece stays in your inventory, so you can store it or throw it in a chest afterwards.
Your armor value, resistances, set bonuses and effects always come from what you actually have equipped. The outfit is only what people see.
Features
- Client side, server benefits. Only you need the mod to wear an outfit. The server doesn't need it, and friends without the mod still see your outfit in multiplayer.
- 5 outfit slots: helmet, chest, legs, cape and trinket, each with its own Hide toggle.
- Hide Megingjord: hides the belt model without touching its effect.
- 4 presets + 1 Home preset, named by you, shown where the crafting panel usually is.
- Home outfit: wear the Home preset automatically when you walk into your house, and switch back when you leave. If you have the mod LocationIntro installed, the Home outfit also takes into account the home pin area.
- Quick swap hotkey (Alt+O by default) to cycle your presets and your real gear, without going back to the Barber Station.
- Walk of Shame (on by default): after death the outfit is off until you put some armor back on.
- Outfit preview camera: the camera turns to face your character, full body, while the menu is open.
- Full controller support: LB/RB jump between the outfit window and each preset.
- Main menu preview shows your outfit.
- Localized in all 35 languages supported by the game (I did my best).
Configuration
The config file is created after the first launch: BepInEx/config/vktr.vanityoutfit.cfg
| Section | Setting | Default | What it does |
|---|---|---|---|
| Barber | HoldTime |
0.5 | Seconds to hold Use on the Barber Station to open the Outfit menu |
| Barber | CloseDistance |
5 | The menu closes if you move farther than this (m) from the station |
| Camera | Framing |
1.15 | Space around the character (1 = full height, higher = farther) |
| Camera | Height |
0.95 | Height (m) of the point the camera looks at |
| Colors | PanelColor |
4070FFFF | Tint of the wooden panels in the Outfit menu |
| Colors | ButtonColor |
8CFFFFFF | Tint of buttons and checkboxes in the Outfit menu |
| Colors | FilledSlot |
006B7A99 | Background of filled outfit/preset slots |
| Colors | EmptySlot |
0A175299 | Background of empty outfit/preset slots |
| Gameplay | WalkOfShame |
true | After death the outfit is off until you equip an armor piece |
| Home | Enabled |
true | Wear the Home preset automatically at home |
| Home | Delay |
1.5 | Seconds you have to stay in/out before the outfit switches |
| Hotkeys | CycleOutfit |
O + LeftAlt | Cycles presets (Home excluded) and your real gear |
| Presets | PanelScale |
1 | Size of the preset panels |
| Presets | OffsetX |
0 | Horizontal shift of the preset panels |
| Presets | OffsetY |
0 | Vertical shift of the preset panels (negative = down) |
Colors ignore the game's time-of-day lighting, so the menu looks the same at noon and at midnight.
Options
Everything below is in the Outfit menu.
- Outfit slots: click an armor piece in your inventory to set it, click the outfit slot to clear it.
- Hide: the slot shows nothing on your character, even if you have real armor equipped there.
- Hide Megingjord: in the small panel under the outfit window.
- Save: copies your current outfit into the preset and asks for a name.
- Wear: puts the preset on.
- Delete: press twice to confirm.
- Home preset: the last one, with the house icon. Save it like any other preset.
Notes
How the outfit reaches other players. The game already tells every player which armor model you're wearing. The mod swaps that model before it's sent. Other players load it like any other armor piece, which is why they don't need the mod. Nothing new is sent over the network, and changes only go out when your outfit changes.
Where your outfit is saved. Outfit and presets live in your character file as a few lines of text. They follow the character, not the world. Nothing is saved in the world, so removing the mod leaves your worlds exactly as vanilla. The leftover lines in the character are ignored by the game.
Home detection. You're "home" when the game gives you the Shelter status, or when you're inside a home pin area with LocationIntro. The outfit only switches after you've been in or out for Delay seconds, so walking on the doorstep won't flicker it. If you change outfit by hand while at home, the mod keeps your choice and won't switch you back when you leave.
Quick swap order. Each press moves to the next saved preset. After the last one you see your real gear, then it starts again from the first preset. The Home preset is skipped. The real gear step doesn't delete anything: the next press puts your outfits back on. If you're wearing an outfit that isn't saved in a preset, the first press replaces it, so save it first if you want to keep it.
Walk of Shame. Dying turns the outfit off until you equip any armor piece. You still see the outfit while the Barber Station menu is open, so you can edit it.
Light-emitting pieces. Pieces with a light in their model (like the Dverger Circlet) can't be used in the outfit. The mod checks every item at startup, including items from other mods, and writes the list in the BepInEx log. If you actually wear one of these pieces, that slot shows the real piece, so its light keeps working.
Limitations
- Dverger Circlet. Its light is part of the model: it lights up the area and cancels your sneak bonus. Showing it as an outfit would give you a free light and a stealth penalty, and removing the light on your screen would still leave it on for everyone else. Making it work would mean sending extra data to other players, and the mod would stop being client-side. So light-emitting pieces are excluded from outfits.
- Presets are per character. They're not shared between characters.
- Each player needs the mod to wear an outfit. Seeing outfits needs nothing.
- The crafting panel is hidden while the Outfit menu is open, since the presets take its place.
Installation
With r2modman / Thunderstore Mod Manager: click install, done.
Manually: install BepInExPack Valheim, then drop VKTR_VanityOutfit.dll into BepInEx/plugins.
