Style Settings - erdelf/AlienRaces GitHub Wiki

StyleSettings are used to customize or disable hair styles, beards, or tattoos for your race. This replaces hairSettings for RimWorld 1.2 and earlier.

StyleSettings are used by adding a styleSettings tag inside of alienRace.

<AlienRace.ThingDef_AlienRace>
  <alienRace>
    <styleSettings>
      <!-- Style settings are listed here -->
    </styleSettings>
  </alienRace>
</AlienRace.ThingDef_AlienRace>

StyleSettings can have an entry for each non-abstract StyleItemDef subclass. In vanilla RimWorld, this includes HairDef, BeardDef, and TattooDef as follows:

<styleSettings>
  <li>
    <key>HairDef</key>
    <value>
      <!-- options for HairDef usage -->
    </value>
  </li>
  <li>
    <key>BeardDef</key>
    <value>
      <!-- options for BeardDef usage -->
    </value>
  </li>
  <li>
    <key>TattooDef</key>
    <value>
      <!-- options for TattooDef usage -->
    </value>
  </li>
</styleSettings>

These are all optional; ones that are omitted will allow all style items for that Def (as humans).

Settings

Setting Default Description
<hasStyle>true</hasStyle>
true If set to false, disables the associated StyleItemDef for this race. Note that this is not the same as having Bald hair or NoBeard beards, this disables that entire system from your race.
<genderRespected>true</genderRespected>
true RimWorld 1.4 and later only.

If set to false, members of your race will ignore gender tags for this style item.

<styleTags>
  <li>Urban</li>
  <li>Royal</li>
</styleTags>
(None) If set, restricts the desired style variations for your race to the specified style tags. These are associated with StyleItemCategoryDef entries (under Defs/Misc/HairDefs/StyleItemCategoryDefs.xml in Core).
<styleTagsOverride>
  <li>Urban</li>
  <li>Royal</li>
</styleTagsOverride>
(None) If set, restricts the desired style variations for your race to the specified style tags.

If overrides are used, then these are applied in a destructive prefix and the vanilla WantsToUseStyle code is not run.

<bannedTags>
  <li>Punk</li>
</bannedTags>
(None) RimWorld 1.4 and later only.

If set, disallows the specified style tags for your race.

<shader>Transparent</shader>
(Varies) Overrides the shader type used to draw this style item. For hair and beards, the default shader is Transparent. For tattos, the default shader is CutoutSkinOverlay.
⚠️ **GitHub.com Fallback** ⚠️