Patching a (HAR) race for [NL] Facial Animation

Overview

This guide can help you add compatibility between a race from Humanoid Alien Races and [NL] Facial Animations.

Patch File

You find the patch file in the location of the mod folder of Facial Animations (1635901197/Patches). In this file (Race_Patches.xml) you change the defName from “Human” to the name of your race. The name can be found in the race file of your race in most cases in this path: 1.2DefsThingDefs_Races (or just DefsThingDefs_Races).

For example: …Steamsteamappsworkshopcontent29410013425104091.2DefsThingDefs_Races Race_Astoriel.xml. You can find the mod number (here: 1342510409) in the mod’s workshop link.

<AlienRace.ThingDef_AlienRace ParentName=”BasePawn” Name=”Alien_Astoriel”>
<defName>Alien_Astoriel</defName>

Custom Heads

If you also want to add custom heads (for example without human ears) you need an extra Def file (HeadType.xml). You find this file in the Facial Animation mod folder under this path:
…16359011971.2DefsFaceTypeDefsHuman

There you also find all the other Def files in case you want to add other custom face parts.
Copy this file into your own mod folder.
What you have to do here:

• Change the defName of the head (every head needs to have a unique defName)
• Change the path to where your textures are
• Add a line with <raceName>name of your race</raceName>. (same as the defName in the patch file)

In the end it should look similar to this I made for the Astoriel:

You need one “head definition” for each race you want to patch. You can put it all in one file underneath each other. You can only have one file because it has to be named exactly “HeadType.xml” (not HeadTypesAstoriel.xml etc.). If you don’t specify <raceName>, every race in your game will apply this head shape.
In my mods the texture path is very similar to the original one and I would also recommend this. Furthermore, the name of the textures always needs to be like the originals:
normal_south.png
normal_east.png
normal_north.png

If you want your pawn to adopt the blush animation you also have to place textures with blushed faces (maybe compare them to the originals) in the same folder and name them:
blush_south.png
blush_east.png
blush_north.png

Finished Patch

Your finished patch should be placed in your local mod folder (…SteamsteamappscommonRimWorldMods).
It should consist of the following subfolders:

• 1.2
  • Patches
    • YourPatchFile.xml
• About
  • About.xml
• Defs (if you use custom textures for FA)
  • HeadType.xml
  • MouthType.xml
  • BrowType.xml
  • …
• Textures

If you need more information about modding or for example the About.xml, you can have a look in the RimWorld Wiki ([link], [link]).
The wiki of Humanoid Alien Races is also very informative ([link]).

I hope this guide helps you. If you miss any information please write a comment.