Torvald's Affordable Painters

"Hammer some paint onto your creations!"

A Valheim mod that lets you paint building pieces with a variety of colors. Torvald's got you covered with his trusty painting mallet - craft it, equip it, and start adding some color to those drab wooden halls.

Features

Paint building pieces with 13 different colors (5 wood tones, 8 paint colors)
Custom paint-splattered mallet icon to easily distinguish from regular hammer
Left-click to paint, right-click to open color selector
Colors persist across game sessions and work in multiplayer
Configurable recipe system - server admins can change what materials are required
All colors can be customized through the config file
Requires workbench by default (can be disabled in config)

How to Use

Craft Torvald's Painting Mallet at a workbench (default recipe: 10 Wood, 5 Leather Scraps, 1 Coal)
Equip it like any other tool - no more swinging swords at your walls
Left-click on building pieces to give them a proper paint job
Right-click to browse Torvald's color selection and pick your favorite

Configuration

After running the mod once, you'll find a config file at BepInEx/config/com.torvald.painters.cfg.

Recipe Configuration

[Recipe]
# Materials needed to craft the painting mallet
Materials = Wood:10,LeatherScraps:5,Coal:1
# Whether the mallet requires a workbench to craft
RequireWorkbench = true

Recipe Examples:

# Early game (default)
Materials = Wood:10,LeatherScraps:5,Coal:1

# Mid-game progression
Materials = FineWood:8,Bronze:2,TrophyGreydwarf:1

# Late-game luxury
Materials = BlackMetal:1,Silver:2,LoxPelt:1

# Custom themed server
Materials = YggdrasilWood:5,Crystal:3,SurtlingCore:2

Color Customization

All 13 colors are individually configurable using RGB values (0.0 to 3.0):

[Colors.WoodTones]
DarkBrown = 0.65,0.35,0.20
MediumBrown = 0.80,0.60,0.45
NaturalWood = 1.0,1.0,1.0
LightBrown = 1.15,1.05,0.90
PaleWood = 1.30,1.15,1.00

[Colors.PaintColors]
Black = 0.1,0.1,0.1
White = 2.0,2.0,2.0
Red = 1.5,0.2,0.2
Blue = 0.25,0.35,1.40
Green = 0.30,1.30,0.30
Yellow = 1.60,1.40,0.25
Orange = 1.5,0.9,0.25
Purple = 1.2,0.5,1.4

Advanced Filtering Options

Control what objects can be painted:

[Filtering]
# Building categories that can be painted (flags: Building, Furniture, Crafting, Misc, All)
AllowedCategories = Building, Furniture
# Functional groups to exclude (flags: Stations, Production, Storage, Beds, PortalsWard, Transport, etc.)
ExcludedFunctional = Stations, Production, Storage, Beds, PortalsWard, Transport
# Material types that can be painted (flags: Wood, Stone, Metal, Marble, All)
AllowedMaterials = Wood, Stone, Marble
# Specific prefabs to always allow (comma-separated)
WhitelistPrefabs = 
# Specific prefabs to always block (comma-separated, overrides whitelist)
BlacklistPrefabs =

Debug Options

[Debug]
# Logging level (None=0, Basic=1, Detailed=2, Debug=3)
LogLevel = Basic
# Maximum painting distance in meters
MaxPaintDistance = 8.0
# Require build permission to paint objects
RequireBuildPermission = true

Note: You need to restart the game for config changes to take effect.

Server Administrators

Torvald's business model is flexible - want to make his services more exclusive? Just change the recipe to require fancier materials. Gate it behind silver and black metal if you want painting to be a proper end-game luxury. The recipe system accepts any valid Valheim item names, so get creative.

Installation

Install with a mod manager or manually place the files in your BepInEx/plugins folder. Requires BepInEx and Jotunn.

Changelog

v1.2.0

Added custom paint-splattered mallet icon to distinguish it from regular hammer
Significantly cleaned up logging - only essential actions logged at normal level
Improved icon embedding system for better mod distribution
Enhanced debugging capabilities with proper Jötunn logging integration
Better performance with throttled color reapplication system

v1.1.0

Added Orange and Purple paint colors (13 total colors now)
Enhanced color palette with improved wood tone progression
Balanced paint color brightness to reduce blowout on some materials
Stone and marble materials now automatically dim slightly for more realistic appearance
Improved color picker GUI with two-column layout for better organization

v1.0.1

Fixed major painting bug where you could accidentally paint objects behind non-paintable pieces
Improved user feedback when painting is blocked by objects like workbenches or forges
Enhanced raycasting system for more consistent painting behavior

v1.0.0

Added configurable recipe system
Added individual color customization
Added workbench requirement toggle
Improved color picker interface
Better config validation and error handling

v0.1.0

Torvald opened his first paint shop