[CHF] Character Hair Framework Materials

This mod contains the materials needed for utilizing the character.shpk shader for hair. You need this and the texture pack(s) of your choosing for the mod to work.

Information:
This mod converts hair textures into index, mask / base, and normals for use with the character.shpk shader. This means your hair will not change color normally - it is now controlled by Row 1A for highlights, and 1B for the base color. This means you can make your hair have any color of your choosing - as well as glow, holographic, and metallic effects.

You can make your own custom textures for custom hairs entirely in Penumbra - I have included every vanilla hair, ears, tails, and Hrothgar skin, so please do not repack these textures for vanilla hairs/tails/ears/etc.

You are highly encouraged to make your own material packs! I highly suggest putting [CHF] at the beginning of the mod name, so everyone can find Character Hair Framework mods easily.

How to split hair textures into index, mask, and normals:
Index: Open the normal texture, set everything to 0 in the RGBA editor, and then set column G row B to 1.0. It should be black with green highlights, save this as your _id.tex - do not overwrite the normals. I recommend compressing with BC7 compression for the index. Be sure to set the file redirection for this file!
Normals: Select "No Transform (Identity)" to reset your RGBA editor. Remove the 1.0 from column B row B, and set column B row A to 1.0. It should look entirely blue-toned. You can overwrite the normals now.
Mask: Select "No Transform (Identity)" to reset your RGBA editor. Select "Extract Red". You can overwrite the mask. I recommend compressing with BC7 compression for the mask.

How to edit the material:
With the material selected, select character.shpk. If Penumbra gives you an error, click to retry and select character.shpk again. You may need to set the path for index - you can copy paste the mask path, and replace mask with id. You can now edit the material to your liking, or, if you're wanting the same material across different hairs, you can import your material rows from clipboard.

Edit (05/09/2026): To edit the hair's appearance, open Penumbra > Advanced Editing > Materials > the path of the hair material you want to edit. Row 1A is the highlights, and Row 1B is the base hair color. If you want to copy this across the several materials, you can click "Export All Rows to Clipboard", navigate to your desired hair path, and click "Import All Rows To Clipboard". If needed, I can make a proper tutorial later!

Troubleshooting:
"My hair is one solid color with no details." You might not have the material set correctly if you made your own. If you notice this with my packs, however, let me know which hair #, race, and model gender!

"I can't change my hair color with the Crystal Bell or Glamourer." Unfortunately, this hair framework is using the character shader - much like gear does, so you'll lose the ability to change your hair color as you normally would... however, you can copy/paste the hex codes from Glamourer's advanced customizations, and it'll be pretty close to what you'd expect from in-game colors.

"Are all these textures needed? The mod's pretty big." I split the mod up per race for the most part to reduce total size - and yes, all textures are needed. Every single texture in this mod was edited in some fashion to work with the character shader. Everything except normals are compressed with BC7 - feel free to compress the normals if you want to save more space and don't mind potential crunchiness.

"Hrothgar fur is pink and blue when set to light colors." I think it's the vertex colors for those models? I'm not sure. I can't fix it, though.

Mod Directory:
[CHF] Character Hair Framework Materials: https://www.xivmodarchive.com/modid/154133
[CHF] Character Hair Framework Textures - Fem Hair: https://www.xivmodarchive.com/modid/154138
[CHF] Character Hair Framework Textures - Masc Hair: https://www.xivmodarchive.com/modid/154143

[CHF] Character Hair Framework Textures - Hyur: https://www.xivmodarchive.com/modid/154145
[CHF] Character Hair Framework Textures - Elezen: https://www.xivmodarchive.com/modid/154146
[CHF] Character Hair Framework Textures - Lalafell: https://www.xivmodarchive.com/modid/154148
[CHF] Character Hair Framework Textures - Miqo'te: https://www.xivmodarchive.com/modid/154149
[CHF] Character Hair Framework Textures - Roegadyn: https://www.xivmodarchive.com/modid/154150
[CHF] Character Hair Framework Textures - Au Ra: https://www.xivmodarchive.com/modid/154152
[CHF] Character Hair Framework Textures - Hrothgar: https://www.xivmodarchive.com/modid/154153
[CHF] Character Hair Framework Textures - Viera: https://www.xivmodarchive.com/modid/154161

[CHF] Character Hair Framework Textures - Hrothgar Faces & Fur: https://www.xivmodarchive.com/modid/154162

[CHF] Holographic Oil Spill: https://www.xivmodarchive.com/modid/154166

Terms of Use:
• Do not use my mods for NSFW Lalafell/underage content.
• Do not use my mods for racist, homophobic, transphobic, slave, or rape, bigoted, and otherwise harmful content.
• Do not paywall / vault / re-upload my mods.
• Do not use my mods in or to train generative AI content of any form. Additionally, do not "upscale" textures in my mods with genAI.
• Do not port my mods to the following bodies: O​top​op, Che​rie, Mel​usine, and derivatives. E​ve and derivatives. A​B bo​dy and derivatives. TB​SE Ori​on, Ann​abelle, and derivatives. N​eolit​he and derivatives.
• Please credit me if you use my mods.