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

1. Craft Torvald's Painting Mallet at a workbench (default recipe: 10 Wood, 5 Leather Scraps, 1 Coal)
2. Equip it like any other tool - no more swinging swords at your walls
3. Left-click on building pieces to give them a proper paint job
4. 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