modular_aphelion/modules/body_hair/readme.md

Body hair

Module ID: BODY_HAIR

Description:

Facial hair styles and armpit and pubic hair, adapted from Ratwood-2.0 for our sprites.

Beards. New facial hair styles:

• Beard (Commodore), from their Knightly: a drooping horseshoe moustache over a pointed chin beard.
• Beard (Manly): a full, rounded beard that leaves the mouth clear.
• Beard (Twin Braids), from their Viking: a jaw frame closed under the chin, with two short braids.
• Sideburns (Short), from their Burns: three pixels of sideburn in front of each ear.

Their Stubble and Pipe are not here: Stubble is our Beard (Five o Clock Shadow) and Pipe is our Beard (Hipster) with the sideburns a row higher. Ratwood's sheet is already in tg face coordinates, so the shapes sit on our heads unmoved. Commodore, Twin Braids and Short Sideburns are lit from above; Manly uses the checker shading of our own long beards.

Armpit and pubic hair. Character options under the secondary features: armpit hair (Trimmed, Natural, Untamed) and pubic hair (the same three, plus Landing Strip, Heart and Arrow; only with ERP preferences and genitals allowed). Both default to none. They take the hair colour and follow it while "Body hair matches hair color" is on, which is the default; turned off, a colour picker appears for their own colour.

Each is a mutant bodypart like genitals: the choice goes into dna.mutant_bodyparts, species organ regeneration grows a small hidden organ, and its overlay draws <style>_<m|f> from icons/body_hair.dmi over the skin and under underwear, clothes and genitals. Ratwood's art is used as drawn, refitted to our bodies (armpits a pixel lower on the male body and a pixel higher on the female one, pubic hair a pixel lower on the male body); Untamed on the male body uses a softer, fuzzier take. Female Natural also sits a pixel further out than the rest, in the armpit rather than the waist notch beside it, and female Trimmed's side view a pixel lower, clear of pecs.

Clothing hides them. Armpit hair shows only on a bare chest, or when everything over the chest bares the armpits: code/baring_clothing.dm lists those uniforms, suits and undershirts (tank tops, fishnets, corsets, leotards, bunny suits, sleeveless dresses, vests and the like). No bra or underwear hides it. Pubic hair shows only on a bare groin, or under a jockstrap or mankini. The list came from a sprite check: every chest-covering garment whose worn sprite covers less than a third of the upper arm, confirmed by eye.

Pubic hair is drawn a pixel or more past the crotch's outline, to frame genitals. Over a bare groin it's drawn just so. Under a jockstrap or mankini, its only cover, it keeps only the pixels on bare skin: on the body as it's drawn, the chest and legs from their own sprites (any muscle size, a female or male chest, digitigrade legs, another species' limbs), and outside the underwear's span in each row, from its leftmost pixel there to its rightmost, in each direction. A taur's or Cerulean's legs draw nothing of their own, so there it keeps to the chest. clip_pubic_hair() (code/body_hair.dm) makes each clipped sprite once a round, for each hair style, underwear sprite (with its female cut) and body; its colour is the overlay's. The chest's cache key carries the same, so a change of underwear, legs or muscle size draws it again. Armpit hair is never clipped.

A razor used on the chest or groin (not in combat mode) trims them to any style or shaves them off, like a beard, while they show: whatever hides them keeps the razor off too. Trimming someone else's pubic hair needs their ERP preference.

Armpit interactions (in the staged interaction JSON) need only an arm, via the target_arm requirement, whether or not there's hair.

Credits:

Original shapes: Ratwood-2.0 contributors (icons/mob/sprite_accessory/hair/human_facial_hair.dmi, icons/mob/sprite_accessory/genitals/pits.dmi and pubes.dmi).