You are viewing a potentially older version of this package. View all versions.
Balrond-balrond_character_customization-2.0.1 icon

balrond character customization

Player Character customization extension including eye color, height adjustment, new heirstyles, new races Dverger/Alfir

Date uploaded a week ago
Version 2.0.1
Download link Balrond-balrond_character_customization-2.0.1.zip
Downloads 2369
Dependency string Balrond-balrond_character_customization-2.0.1

README

BalrondCharacterCustomization

Overview

BalrondCharacterCustomization expands Valheim's character customization system with additional races, body types, color controls, tattoos, height adjustment, improved barber functionality, and a built-in randomizer.

The mod extends both the character creation/editing interface and the Barber Station UI.

Multiplayer: all players in a session should have the mod installed to ensure custom appearance data is displayed and preserved correctly.

Development status: this mod is still under active development. Some visual clipping or compatibility issues may still occur, especially with unusual equipment, custom character proportions, or dedicated-server setups.


Features

Character Editing

  • Character Edit option available from the character selection flow
  • Expanded character creation/editing interface
  • Improved Barber Station customization interface
  • Female characters can use beards
  • Vanilla hair-color controls replaced with RGB controls
  • Custom eye-color RGB controls
  • Adjustable character height
  • Skin-tone customization
  • Tattoo selection
  • Randomize Appearance button

Playable Races

The mod currently includes four playable races:

  • Human
  • Alfir
  • Dverger
  • Fuling

Each race can use different authored proportions and visual features.

Custom race-specific elements, such as ears, are attached dynamically to the player where required.

Body Types

Additional body meshes are available alongside the standard Valheim body types.

Current custom body variants include:

  • Male2
  • Male3
  • Male4
  • Male5
  • Male6
  • Female2
  • Female3
  • Female4
  • Female5
  • Female6

Body type selection is independent from race selection, allowing many different combinations.

Hair and Beard Customization

  • Additional hairstyles are included
  • Hair and beard styles can be selected independently
  • Female characters can use beard styles
  • Hair color uses independent RGB sliders
  • The mod preserves Valheim's normal availability rules for unlocked Barber styles

Eye Color

Eye color can be customized using independent:

  • Red
  • Green
  • Blue

sliders.

Skin Tone

Skin tone can be adjusted from the customization interface using the normal Valheim skin-color range.

Race-specific visual elements that support skin tinting are updated together with the player's skin color.

Height

Character height can be adjusted with a dedicated slider.

Height changes affect the visual scale of the character while the mod handles race-specific proportions separately.

Tattoos

The mod includes a tattoo selector.

Players can choose:

  • one of the currently available tattoo options
  • None

Tattoo support is still being expanded and more designs are planned.

Randomize Appearance

The RANDOMIZE button can generate a complete random appearance.

It currently randomizes:

  • Race
  • Body type
  • Skin tone
  • Hair style
  • Beard style
  • Hair RGB color
  • Eye RGB color
  • Character height
  • Tattoo, including None

This is intended as a quick way to discover combinations that would be difficult to create manually.


Barber Station

The Barber Station supports the expanded customization system.

Depending on the available UI and enabled features, players can modify:

  • Hair
  • Beard
  • Hair color
  • Eye color
  • Skin tone
  • Height
  • Race
  • Body type
  • Tattoo

The same appearance systems used during character creation are reused by the Barber interface.


Configuration

The configuration file is created in the normal BepInEx configuration directory after the mod has been started.

General Feature Toggles

The mod contains configuration options for enabling or disabling selected customization systems.

For example, tattoo UI support can be disabled while preserving stored character data.

Cloth Helmet Uniform Scale

Some helmets use cloth simulation systems such as MagicaCloth instead of behaving like ordinary rigid helmets.

Because custom races may use different head proportions, these helmets require a separate fitting rule.

[4 - Race Fit]
Cloth Helmet Uniform Scale = 1.0

Default:

1.0

This keeps Valheim's original runtime cloth-helmet scale.

If a cloth-based hat needs slightly more clearance around a larger custom-race head, the value can be increased carefully, for example:

1.03
1.05
1.08

The adjustment is applied uniformly on all three axes to avoid deforming the cloth object.

Debug Diagnostics

Verbose development diagnostics can be enabled when troubleshooting race proportions, equipment fitting, or attachment behavior.

[9 - Diagnostics]
Enable Debug Diagnostics = false

Default:

false

Keep this disabled during normal gameplay.

When enabled, the mod can print detailed runtime information about character scaling, equipment attachment transforms, helmet fitting, and related systems.


Compatibility and Multiplayer Notes

  • All players should have the mod installed when using custom races, body types, colors, tattoos, or other extended appearance data.
  • Players without the mod may not display custom appearance data correctly.
  • Removing the mod or loading the same character without it can cause custom appearance options to fall back to vanilla behavior.
  • Custom equipment from other mods may require compatibility adjustments if it depends heavily on vanilla player proportions.
  • Unusual helmets, hairstyles, beards, and large custom head shapes may occasionally produce clipping.

If you encounter a compatibility issue, please include:

  • the affected race
  • body type
  • equipment or hairstyle prefab name if known
  • screenshots
  • relevant BepInEx log output
  • whether the issue occurs in single-player, multiplayer, or on a dedicated server

This information makes compatibility problems much easier to reproduce.


Installation

Install the mod using your preferred Valheim mod manager, or install it manually into:

BepInEx/plugins

For multiplayer, install the mod for every player who needs to use or correctly display the extended customization features.


Future Plans

Development will continue to focus on expanding customization while improving compatibility with Valheim equipment and character visuals.

Planned work includes:

  • improving hair clipping on different races and body/head proportions
  • improving beard clipping where necessary
  • adding more tattoos
  • adding more hairstyles and other cosmetic customization options
  • expanding the available visual customization choices
  • further improving custom-race equipment fitting
  • continued UI polish and usability improvements
  • additional compatibility work for unusual helmets and modded equipment
  • general bug fixes and multiplayer/dedicated-server improvements

The goal is to keep adding more ways to create visually distinct characters without requiring players to manage separate character-model mods.


Credits

Special thanks to AzathothR for sharing valuable modding knowledge and providing some of the model assets used in this project.

Their help made parts of this mod possible and is greatly appreciated.

  • Thunderstore profile: AzathothR
  • If you are looking for a more extensive race-focused experience with additional features beyond the scope of BalrondCharacterCustomization, check out LinejaeserasRace: LinejaeserasRace on Thunderstore

Support and Feedback

Bug reports and feedback are welcome.

When reporting an issue, include as much technical information as possible so the problem can be reproduced.


Gallery

Screenshots and additional character examples may be added in future releases.

CHANGELOG

🧾 Changelog

Update 2.0.22

  • hotfix

Update 2.0.21

  • Improved the Character Creation layout and spacing
  • Improved the Height control layout and fixed its label positioning
  • Placed RANDOMIZE and RESET next to each other
  • Improved live RGB color editing for Skin Color and Hair Color
  • Fixed Hair Color changes flickering or being immediately overwritten while using the RGB sliders
  • Improved Skin Color, Hair Color and Eye Color refresh behavior while editing a character
  • Improved Randomize/Reset appearance refresh behavior
  • Improved race-specific skin-color synchronization
  • Improved Fuling/Alfir race-extra color refresh after appearance changes
  • Improved Body Type switching and vanilla Male/Female compatibility
  • Added selective compatibility with RacesOfValheim 1.5.5+
  • Added selective compatibility with LinejaeserasRace 1.0.6+
  • When one of the supported external race mods is active, BRC no longer replaces its race model, materials, special race parts, equipment handling or helmet rules
  • With supported external race mods, the BRC Race selector can act as a compatible body morphology preset without adding BRC race ears or replacing the external race appearance
  • BRC Height remains available with supported external race mods
  • BRC Skin Color and Hair Color RGB controls remain available with supported external race mods
  • Body Type remains available on a best-effort basis with supported external race mods
  • BRC custom Eye Color and Tattoo are not forced onto incompatible external race models
  • Fixed supported external race selections being lost or reverting to Human when pressing Done after editing an existing character
  • Improved compatibility with Windstrides Bow Animations 1.1.1+
  • Improved compatibility with OdinHorse 1.7.9+
  • Improved compatibility with BetterArchery 2.0.2+
  • Improved coexistence between custom BRC proportions and external bow/mounted animation systems
  • General customization UI, compatibility and stability improvements

Update 2.0.2

  • code optimization for multiplayer

Update 2.0.1

  • minor tweak to models
  • Fuling shade of green changes
  • Fuling ear position adjusted

Update 2.0.0

  • Major character customization overhaul
  • Added 4 playable races:
    • Human
    • Alfir
    • Dverger
    • Fuling
  • Added multiple new custom body types:
    • Male2
    • Male3
    • Male4
    • Male5
    • Male6
    • Female2
    • Female3
    • Female4
    • Female5
    • Female6
  • Added race-specific body proportions and scaling
  • Added race-specific visual elements such as custom ears
  • Added improved race switching and runtime race visual handling
  • Added expanded character creation/edit UI
  • Added expanded Barber Station customization support
  • Added RGB hair color controls
  • Added RGB eye color controls
  • Added skin tone customization
  • Added character height customization
  • Added tattoo selection system
  • Added Randomize Appearance button
  • Randomizer now supports:
    • Race
    • Body type
    • Skin tone
    • Hair style
    • Beard style
    • Hair color
    • Eye color
    • Height
    • Tattoo
  • Added support for female characters using beards
  • Added additional hairstyles
  • Added improved custom-race equipment fitting
  • Added special handling for cloth/MagicaCloth-based helmets
  • Added configurable uniform scaling for cloth helmets
  • Added helmet and attachment diagnostics
  • Added debug diagnostics config option, disabled by default
  • Improved compatibility with custom race head and body proportions
  • Improved custom race skin-color synchronization
  • Improved custom race ear color synchronization
  • Improved character customization persistence and runtime refresh handling
  • Improved UI layout and panel positioning
  • Improved resolution handling
  • General code refactoring, cleanup and stability improvements
  • Updated configuration structure
  • Updated documentation and user-facing README

Update 0.1.7

  • Deep North fix
  • Added new race options
  • Code improvements

Update 0.1.6

  • General code refactoring and quality improvements

Update 0.1.5

  • Refactored code
  • Fixed female model eye issues
  • Improved handling of eye color incorrectly turning white

Update 0.1.4

  • Refactored code
  • Changed how the character customization panel is added
  • Fixed issues where the panel could appear outside the window at different resolutions

Update 0.1.3

  • Improved error handling
  • Code optimization
  • Preparation for improved resolution handling, including 4K

Update 0.1.2

  • Fixed Russian translation
  • Fixed window anchor position

Update 0.1.1

  • Fixed translation issues
  • Added Russian translation
  • Added Brazilian Portuguese translation

Update 0.1.0

  • Initial release