// Eyelashes for Fallout 3
// by throttlekitty
// v 1.0 , 5.18.09
//


This mod adds working eyelashes to the human races in Fallout 3.  I've included several options for customizing the appearance more, read on for more information on that.  This package also incorporates two other mods: Head Fixes and Merged Mouths.  Head Fixes replaces the files for all six human heads, I needed to make corrections to those for this mod to look its best.  Merged Mouths combines the four models that make up the mouth into a single one, freeing up space for the eyelashes to work, but does not replace files.

This mod will conflict with other race-altering mods, such as mods that add hairstyles.  I fully support having this mod integrated into larger beauty packs, and grant permission in advance.  I only ask that the credits of this readme be appended to your own.



// Installation and Uninstallation:
//


From this package, extract the Meshes and Textures folders and F3Eyelashes.esp to your Fallout 3\Data\ folder.  Check the .esp in the Launcher>Data Files, and you're set.

To remove this mod, uncheck the .esp again, and remove these files:
Meshes\Characters\Eyelashes\*.*
Meshes\Characters\Head\headchild.egm
Meshes\Characters\Head\HeadChild.nif
Meshes\Characters\Head\HeadChild.tri
Meshes\Characters\Head\HeadChildFemale.egm
Meshes\Characters\Head\HeadChildFemale.nif
Meshes\Characters\Head\HeadChildFemale.tri
Meshes\Characters\Head\HeadFemale.egm
Meshes\Characters\Head\HeadFemale.nif
Meshes\Characters\Head\HeadFemale.tri
Meshes\Characters\Head\HeadHuman.egm
Meshes\Characters\Head\HeadHuman.nif
Meshes\Characters\Head\HeadHuman.tri
Meshes\Characters\Head\HeadOld.egm
Meshes\Characters\Head\HeadOld.nif
Meshes\Characters\Head\HeadOld.tri
Meshes\Characters\Head\HeadOldFemale.egm
Meshes\Characters\Head\HeadOldFemale.nif
Meshes\Characters\Head\HeadOldFemale.tri
Meshes\Characters\Head\MouthHumanChildFemaleMerged.egm
Meshes\Characters\Head\MouthHumanChildFemaleMerged.nif
Meshes\Characters\Head\MouthHumanChildFemaleMerged.tri
Meshes\Characters\Head\MouthHumanChildMerged.egm
Meshes\Characters\Head\MouthHumanChildMerged.nif
Meshes\Characters\Head\MouthHumanChildMerged.tri
Meshes\Characters\Head\MouthHumanMerged.egm
Meshes\Characters\Head\MouthHumanMerged.nif
Meshes\Characters\Head\MouthHumanMerged.tri
Meshes\Characters\Head\Vacuus.nif

Textures\Characters\Eyelashes\*.*
Textures\Characters\Mouth\MouthHumanMerged.dds
Textures\Characters\Mouth\MouthRaiderMerged.dds


// Version History:
//

1.0 - Initial Release.


// Known Issues:
//

The lashes and teeth may create drawing errors when viewed against hair, behind glasses visors, or sometimes behind special environment effects there is no fix for this.


// Customization:
//


By default, all races/ages use the same texture for the lashes, this can easily be changed in the GECK if you would like to.  I've carried over the plethora of custom lash textures that were created for the Oblivion version of this mod.  In this package, 'Extra Textures Catalog.htm' is a visual map of which files are which inside the Eyelash Extra Textures folder.  Also, support can easily be added to custom races, I've also created lashes that will change color with a characters hair, but that requires a different setup.


- Load F3Eyelashes.esp in the GECK and head to the menu Character>Race, pick the race you wish to edit.
- Now head to the Face Data tab
- I've used the mouth parts to assign the eyelashes to any member of a race, the left column is for models, the right column is for textures.

Mouth:		Merged Mouth	(Contains mouth, tongue, upper and lower teeth)
Teeth(U):	Empty .nif	(The game will re-add default values if the fields are left empty.)
Teeth(L):	Empty .nif	(The empty file holds the spot to keep this from happening.)
Tongue:		Eyelash		(Pick one appropriate for the age)

In Fallout 3, there are six heads:  Child, Middle and Old, with male/female versions of each.  Each has their own unique shape and animations, so the correct lashes need to be assigned to the race you're editing.  The model field for 'head' can be clicked inside and scrolled to the right to see which head is being used.

_Head_			_Mouth_
HeadChild:		MouthHumanChildMerged
HeadChildFemale:	MouthHumanChildFemaleMerged

Middle m/f and Old m/f heads all use MouthHumanMerged.  All mouths use the same texture, except raiders, who have a dirtier texture.

These are all found in Meshes\Characters\Head\, and the texture is found in Textures\Characters\Mouth\.  In this package under 'Eyelash Extras\' is a MouthHumanMergedWhiterTeeth.dds, which has a cleaner/whiter smile.  if you intend to use this for all characters, rename it to 'MouthHumanMerged.dds' and replace the usual one to save yourself some time in the GECK.


For the Teeth slots, pick Meshes\Characters\Head\Vacuus.nif and Textures\Shared\EmptyTrans.dds.

Eyelash models all follow the same naming scheme as the heads, e.g. HeadOldFemale / LashesHeadOldFemale.



// Colorable Lashes:
//

The Eyelash Extras folder in this package contains altered .nifs and textures that utilize the hair shader, allowing them to change color alongside a characters' hair and/or eyebrows.  For space reasons, I didn't duplicate the .egm and .tri files for this folder, just know that the game needs these, and they need to all have the same naming scheme, just re-use the ones from the non-colorable set.  As an example:
LashesHeadHumanColorable.egm
LashesHeadHumanColorable.nif
LashesHeadHumanColorable.tri

However, using the Race::Tongue slot doesn't allow for the hair shader, they need to be set up as a Head Part, making it a wholly different mod.  The Race now *shouldn't* have eyelashes, since you'd have a duplicate, and drawing errors.  Race>Head Parts allows you to set up a new entry, and pick the model for it.  These can be dragged to any NPC's Head Parts tab to allow them to use it.  For the player, head parts can be added to one of the 'Presets', which are prefixed in the NPC list with CGPreset* and have the 'Is CharGen Face Preset' flag checked.  When creating a character, you are always at least starting from the first preset, and its' traits are passed to your character, hence eyelashes.   -However, I do not currently know of a way to add head parts to an existing character.  Adding head parts to all presets did not pass the lashes to an existing character without using the console command 'ShowRaceMenu'.  (and resetting the face in the process.)


// Head Mods:
//

The base models for the heads inside the .nifs can be altered somewhat to assist in making characters look a bit more unique.  As a general rule, eye shape should be modded minimally, as this can cause problems when it comes time for an actor to blink or squint.  Any wild change of eye location should be handled in FaceGen, but smaller edits are fine inside the .nif.  Any customized head .nif that needs them can be fitted with matching eyelashes by editing in a similar fashion.  If you plan on fitting the lashes yourself, be sure the vertices that fall against the face sit inside the head somewhat, check some of my models as an example.  I will also maintain a list and extra package of custom eyelashes as the need arises.

I also reccommend using the models from the Head Fixes as a base for modding for a better match with the eyelashes.


If anyone is interested in learning more about working with .egm and .tri files, I have a guide and tools located here:
http://tesnexus.com/downloads/file.php?id=18566


// Credits and Usage:
//

Models and FaceGen work by throttlekitty, based on jclyde6108's original model.
Special thanks to Scanti and NifTools, who wrote the tools I use.
Main texture by Luchaire
Additional textures by Kalikut, Nanook, Jennifer and Westly

http://fallout3nexus.com/downloads/file.php?id=6363 - Head Fixes original mod
http://fallout3nexus.com/downloads/file.php?id=6362 - Merged Mouths original mod

As mentioned at the top of this readme, I fully support having this mod integrated into larger beauty packs, additions to custom races and so on.  You have my permission to include these assets, so long as credits are maintained.