🎨 BalrondBannerColorizer - Mod Documentation

Overview

BalrondBannerColorizer adds a full dyeing system for several decorative build pieces in Valheim.
Players can craft dyes and use them to recolor banners, carpets, cloth hangings, crystal walls, and darkwood roof tiles.

A new Dye Station allows players to craft dyes and customize decorations anytime.

⚠️ The mod is server compatible but recommended for all players in multiplayer for full visual consistency.

✨ Key Features

• 🎨 8 craftable dyes for decorating structures
• 🧵 Dye support for banners, carpets, hanging cloths, crystal walls and darkwood roofs
• 🪵 New Dye Station crafting table
• 🔄 Change colors anytime after placing the build piece
• 🧠 Dye choice is saved in ZDO and synced across players
• 🛡 Ward protection respected — other players cannot recolor your pieces

🧪 Dye System

Dyes are crafted at the Dye Station and can be applied to supported build pieces.

Available Dyes

• DyeBlack
• DyeBlue
• DyeGreen
• DyeOrange
• DyePurple
• DyeRed
• DyeWhite
• DyeYellow

Example Resources Used

Each dye uses simple vanilla resources such as:

• Coal
• Blueberries
• Raspberry
• Cloudberry
• Resin
• Guck
• Bloodbag
• Bone Fragments

🧱 Supported Build Pieces

The colorizer currently supports the following prefabs:

piece_banner01
piece_banner02
piece_banner03
piece_banner04
piece_banner05
piece_banner06
piece_banner07
piece_banner08
piece_banner09
piece_banner10
piece_banner11
piece_cloth_hanging_door
piece_cloth_hanging_door_blue
piece_cloth_hanging_door_blue2
jute_carpet
jute_carpet_blue
crystal_wall_1x1
darkwood_roof_icorner
darkwood_roof_icorner_45
darkwood_roof_ocorner
darkwood_roof_ocorner_45
darkwood_roof_top
darkwood_roof_top_45
darkwood_roof_45
darkwood_roof

🖌 How Dyeing Works

1. Craft dyes at the Dye Station
2. Place the dye in hotbar slots 1–8
3. Hover over a supported build piece
4. Use the dye item while the hover information is visible

Hover UI Displays

• Build piece name
• Dye usage hint
• Current dye color
• Default dye color

Using a dye will instantly recolor the object and synchronize the change with all players.

To return to the original look, use the default dye color shown in the hover text.

🏗 Dye Station

A new crafting station is added:

Prefab ID

piece_dyestation

The station unlocks dye crafting recipes once the required materials are discovered.

🎨 Visual Improvements

Some banners also receive new unique textures, making each banner type visually distinct.

Modified Banners

• Banner 5
• Banner 7
• Banner 8
• Banner 9
• Banner 10
• Banner 11

🖼 Gallery

(Screenshots will be added here in future updates)

📌 Compatibility Notes

• Fully multiplayer compatible
• Works with wards / guard stones
• Dye selections are saved in ZNetView ZDO data
• Supports destruction states for carpets and roof tiles

📂 Installation

Install using your preferred mod manager or manually place the mod in:

BepInEx/plugins

💬 Support & Feedback

• Join our community: Balrond's Den Discord
  https://discord.gg/Jfp8T5N7Pv

• Support the developer:
  https://ko-fi.com/balrond1020

🧾 Changelog