VanityOutfit

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.
• Contextual headgear: your helmet disappears while you're sheltered, like you took it off at the door, and comes back when you step outside.
• 4 presets + 1 Home preset, named by you, shown where the crafting panel usually is.
• Home outfit: the fifth preset slot is reserved for your Home outfit. Rest in a shelter with a bed you claimed and the outfit equips itself; walk away and your normal outfit comes back. The moment you rest, the mod puts an invisible "home dome" around one of the following: a house map pin near you, or yourself if there are no map pins. If you have the mod LocationIntro installed, the Home outfit uses its method for detecting your home area instead (you still need a claimed bed), no resting needed. While the Home outfit is on, the weapons, shields and tools on your back or hip are hidden too.
• 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 | | Debug | LogHolsteredLights | false | Once per game: writes to the BepInEx log which holstered weapons, shields and tools give off light, for bug reports | | Debug | LogMenuLayout | false | Writes the Outfit menu's panels, images and colors to the BepInEx log, for bug reports | | 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 | Radius | 30 | Meters: max distance of your bed and of the house pin, and size of the home area | | Home | Delay | 1.5 | Seconds you have to stay in/out before the outfit switches | | Home | HideWeapons | true | While the Home outfit is on, holstered weapons, shields and tools are not shown | | 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 and Contextual headgear: in the small panels under the outfit window. Both are saved in presets.
• 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 always need a bed you own within Radius (30 m) of you, so dungeons, crypts or a random shelter on the road never count as home.