How to convert a CCXL hair color into a replacer

Considerations

The great thing about CCXL hair colors is that you can create your own cap colors. If you want to convert them to a replacer, then you’ll want to consider the cap color of the vanilla hair color. Replacers will impact anything using that hair profile, I’d recommend staying away from brown_liquorice and black_carbon since they're most commonly used for eyebrows and eyelashes.

You also can only have one replacer installed at a time per vanilla hair color.

Reference - Color Names

To make it easy to set up the folder structure for a replacer, you can search for the vanilla hair profile, add it to your project, and then just rename and overwrite the mod file. Here’s a list of all the vanilla .hp profiles for easy reference. (“liliac” is not a typo). You can use the screenshot from the wiki Cheat Sheet: Hair article for reference. These are the colors you can replace.

If you want to set up the path yourself, here it is:

base\characters\common\hair\textures\hair_profiles\

brown_liquorice

blonde_platinum

red_merlot

ginger_copper

teal_ombre

black_carbon

blonde_golden

blonde_dishwater

blue_sapphire

brown_ombre

red_apple

gray_gunmetal

ginger_strawberry

teal_ash

pink_magenta

pink_rose

blue_steel

blue_red_ombre

cold_white

cyberpunk_yellow

goblin_green

liliac

mermaid_aquamarine

purple_ombre

black_salt_n_pepper

green_toxic

brown_medium

blue_sky

citrus_yellow

dark_purple

green_orange

liliac_ombre

phoenix_fire

purple_blonde

silver_rose

Creating the mod

Step 0: Create a WolvenKit project

Step 1: Folder structure

Because we are replacing a vanilla hair profile, we need to mirror the vanilla folder structure in our project. In the asset browser, search for the hair profile you want to replace.

Right click, and select “add selected items to project.

You should now see this in the Project Explorer on the left.

Step 2: Finding one of my hair profiles

CCXL hair colors all use the same folder structure. You’ll find all of mine here:

ratstick\modname_ccxl\hair_profiles

Use the reference pics on the mod page to find the color name. For this example, I want to replace brown_medium.hp with the color “flecktarn” from my It Ain’t Easy Bein’ Green pack.

Toggle the asset browser to the mod browser and search for “ratstick”

I’m going to uncheck “select all” and then check “ratstickkermie_ccxl.archive”, just to make it easier to navigate. You can also try searching for the .hp name without filtering. Most of my colors are named the same as in the hair profile and in the reference photos.

Right click on the .hp you want to add, in this case flecktarn.hp, and click “Add selected item to project.”

This is what you should see on the left in your Project Explorer.

Step 3: Rename and move the file

Now, rename the hair color from my mod to the color you’re replacing.

Your project explorer should now look like this:

All that’s left is to drag and drop into our vanilla folder and let it replace the vanilla file.

Project Explorer should look like this now:

Feel free to delete the folders leftover from my mod. Then, just pack, install, and go!

Last updated