Subscribe to download
Hearthlings of Many Faces

With this mod you’re able to customize the looks and names of your citizens.
Here you can create an amazon village, make everyone be part of a huge family, create a village full of clones, name the shepherd after yourself, or whatever you feel like!

How it functions
Whenever you recieve a new citizen to your kingdom, a new window will show up; where you can edit the citizen’s name, gender, and models.

This is purely automatic at the moment, but for a future release there will be a way to manually start the customization process for any hearthling, via the use of an item.

Extra settings
There are some extra options found in user_settings.json:

- Customize embarking: enter customization for the citizens that are embarking.
- Customize immigrating: enter customization for the citizens that are immigrating.
- Zoom to entity: Zoom in on the hearthling being customized.
- Pause during customization: Pause the game while customizing.

All of these can be set to either true or false.

Console
A new console command is available (open up the console by hitting Ctrl+C):

homf_custom - Whilst having a hearthling selected, this will start up the customization process once again for that hearthling.

Localization
For those that are looking to add localization for this mod:

The title and tooltip strings are located within the mod itself. However, the strings for the category types and for the names of the model / color are accessed through Stonehearth's en.json file, all of which is grabbed from ui.shell.select_roster.

Furthermore, in general the keys for the strings are all in lower case and with the spaces (' ') replaced with underscores ('_'). E.g., "Male Hair 2" has the key value "male_hair_2", so its location within en.json is ui.shell.select_roster.male_hair_2. Take a look inside this file for an overview of the strings that are translatable. For most entries that were missing from Stonehearth's en.json file, they were added to this mod's own locales/en_fix.json. Keep in mind though that it doesn't include possible entries from other mods that add their own models and colors to the hearthlings.

Known issues
- There is a risk of your hearthlings getting baldspots, a workaround is to switch between the genders until the baldspots are gone. This is most likely a problem on the engine side, which can't be fixed from this mod unfortunately.

- The eyebrows for males are offset whenever the hearthling is generated as a female and subsequently changed to male (if the hearthling is generated as a male to begin with, this bug doesn't occur). This is a bug on the engine side, and nothing I can do. However, the developers have been notified of this but their priorities lies elsewhere than to fix what is causing this issue, so we need some patience before this is fixed.