ChestDecor

Chest Decor (Valheim / BepInEx / Jotunn)

Decorate your chests. Colour them, attach trophies, food, produce, weapons, furniture and more, then move, rotate and

resize every attached item. Everything is cosmetic and is saved on the chest itself.

Mod created on special request from people I know in the Valheim community. Hope you'll all enjoy it! Please report

any issues you find.

Features

• Colours: colour any chest you built from an HSV wheel, a brightness slider or a hex code. Each part of the chest

(wood, metal trim) has its own colour and its own mode (Tint or Full colour).

• Attach items: attach up to 5 things per chest (configurable, 1 - 8) from a large, filterable list: trophies,

trader goods and valuables, produce (fruits, vegetables, seeds, plants, bushes and tree saplings), mob drops, food

(including every uncooked and food preparation table item), arrows and bolts, weapons, armor, furniture and every

light source.

• Position items: move, tilt, turn, roll and resize each attached item with sliders. The chest shows every change

live.

• Refunds: removing an attachment, or destroying the chest, returns the materials that were paid.
• Free camera: fly the camera around the chest while the window is open, to check colours and placement. No admin

rights needed.

• Multiplayer safe: one editor per chest at a time, everything is stored in the chest's data and syncs by itself.
• Cosmetic only: players without the mod can still join and just see normal chests.

Requirements and installation

• BepInEx 5 (BepInExPack for Valheim) and Jotunn.
• Put ChestDecor.dll in BepInEx/plugins (or install with your mod manager). Players who want to see the decorations

and edit chests need the mod; players without it are not blocked (see Multiplayer below).

• The config file is BepInEx/config/com.kydldev.chestdecor.cfg; it is created the first time the game starts with the mod.

Use

Look at a chest you built and press K (configurable). The hover text shows a [K] Decorate chest hint. The window

has three tabs: Colours, Attach items and Position items. It is draggable, and it closes with Esc or

X (unsaved previews are undone) or by itself when you move more than 10 m away from the chest.

By default only chests that you could open (private chests, wards) and that were built by a player can be

decorated; both can be changed in the config. Carts, ship cargo holds, incinerators and cargo crates are never

decorated.

Colours tab

• Pick a part on the left, then choose a colour with the wheel, the brightness slider, or a hex code.

The row's Reset button puts that part back to its original look.

• Valheim chests use a single material and a single small texture for both the wood and the metal, so the mod analyses

that texture and splits it into two colour regions, base (the larger area, usually the wood) and trim (the

smaller area, usually hinges and bands), which are listed as separate parts. If a texture has no clearly separate

second region it stays a single part (setting Split Texture Into Parts).

• Colour mode (per part, below the colour picker):
• Tint multiplies the colour with the chest's existing texture. Bright, saturated colours show best, and

very dark textures stay dark.

• Full colour repaints the part: the original texture's grain and shading are kept, but its colour and

darkness are replaced, so the colour you pick is the colour you get, even on the dark chests.

• Apply mode to all parts gives every coloured part the mode currently shown.

Parts you haven't coloured yet start in the last mode you clicked (or the Default Colour Mode* setting).

• Preview shows the current colours on the chest without saving. Save stores the colours on the chest; they

persist with the world and other players with the mod see them. Revert throws away unsaved edits and goes back to

the last saved colours.

Tip: use Full colour for dark wood or dark metal, and Tint when you want to keep the original material's own

colour variation showing throu