REQUIREMENTS

1.7.2

CharGen Extension (Core included with RaceMenu 2.5 and greater)

NetImmerse Override Standalone (Included with RaceMenu 2.0 and greater)

PURPOSE

FEATURES

RaceMenu.esp

Numeric display for all sliders

Categorizes all the vanilla options to the SkyUI look

Search filter by name (Same as SkyUI)

Color ANY tint, including hair with an AARRGGBB value

Loads/Saves settings when re-opening the menu

Light On/Off (Spawns a white light directly infront of your character)

Zoom distances adjusted to be closer to the face when In and slightly further when out

Basic plugin interface

Controller support

Works with any race, including custom races

Doesn't modify any vanilla assets (Unlike my Extended Slider Colors mod)

Multi-warpaint support

Warpaint texture hotswapping (Custom warpaint)

Display racial skill bonuses

Save/Load presets to and from windows clipboard

Supports body/hand/feet/face overlays

Save/Load color

Change overlay glow color

Change overlay glow strength

Export head mesh (Requires CharGen)

Save/Load preset to and from a slot file (Requires CharGen v2.0.0 or greater and replaces clipboard save/load)

Show HeadPart name and source mod (Requires CharGen v2.1.2 or greater)

Camera move up/down/left/right zoom in/out

RaceMenuPlugin.esp

(Optional)

Adjust player height

Adjust player bicep size

Adjust player glute size (Only works for meshes that support skeletal scaling e.g. TBBP body meshes)

Adjust player breast size (Only works for meshes that support skeletal scaling e.g. BBP body meshes)

Adjust player breast curve size (Only works for meshes that support skeletal scaling e.g. TBBP body meshes)

RaceMenuMimic.esp

(Optional)

Copies target Actor's facial morphs to player

Copies target Actor's facial presets to player

Copies target Actor's hair to player

Copies target Actor's hair color to player

Copies target Actor's facial hair to player

Copies target Actor's scars to player

Copies target Actor's eyebrows to player

Must be equipped via console (e.g. help "Face Copy" player.equipspell XXXXXXXX left)

RaceMenuOverlays.esp

(Optional)

Adds 8 male body tattoos (Made by krisjay)

Adds 14 partial female body tattoos (Made by TairenSoul)

Adds 1 female UNP nail paint (Made by me, but it's pretty awful)

BodyGen randomize

Skyrim.esm|F62F0=Sevenbase,Breasts

All|Female=Sevenbase,Breasts

Equippable Transforms

[

{"name":"NPC L Breast","scale":2.0,"pos":[0,0,0],"rot":[0,0,0]},

{"name":"NPC R Breast","scale":2.0,"pos":[0,0,0],"rot":[0,0,0]}

]

[{"name":"NPC","pos":[0, 0, 5.0]}]

Sculpt Mode

There will not be, nor will ever be controller support for the Sculpt feature, sorry.

CHANGE LOG

High-Resolution Warpaint

Locate your Data directory

Create SKSE folder if it is not already there

Create SKSE.ini if it is not already there

Add "[Display]" category

Add "iTintTextureResolution=2048"

Data/SKSE/SKSE.ini

[Display]

iTintTextureResolution=2048

Note: This may cause low resolution textures to look worse due to upscaling, hopefully this will encourage high-resolution replacements.

Keymapping

Choose Color/Accept - Activate (Default E)

Done - Ready Weapon (Default R)

Light - Sneak (Default Ctrl)

Zoom - Sprint (Default Shift)

Search - Jump (Default Spacebar)

Choose Texture - Wait (Default T)

Load Preset - Quickload

Save Preset - Quicksave

Export Head - Shout (Default Z)

Choose Color/Accept - Activate (Default A)

Done - Ready Weapon (Default X)

Light - Wait (Default Back)

Zoom - Sprint (Default RB)

Search - None

Choose Texture - Jump (Default Y)

Load Preset - Left Stick

Save Preset - Right Stick

Export Head - Shout (Default LB)

Change Sub Category - Left/Right Trigger

FAQ

Q

A

Q

A

Q

A

Q

A

Q

A

PLUGINS



Making a plugin

Extract the modders package to your Data folder

Open Creation Kit (You do not need to load Skyrim.esm)

Create new quest

Give quest a unique ID

Press Quest Aliases tab

tab Right click the list, New Reference Alias

Name the alias Player

Tick Specific Reference

Press Select Force Reference

Select Cell (any) , Ref PlayerRef ('Player') click OK

, Ref click OK Press the Add button in the Scripts group

button in the Scripts group Type RaceMenuLoad into the filter and click OK

into the filter and click OK Press OK in the Reference Alias window

Go to the scripts tab and Add

Click [New Script] , give the script a name

, give the script a name Open the script in your editor of choice and change extends Quest to extends RaceMenuBase

to Copy contents of PluginTemplate.psc to your new script

to your new script Read the comments inside of the template

Click OK in the Quest window

Save your plugin

Add your warpaints/sliders to your script

Compile your script

COMPATIBILITY

LOAD ORDER

INSTALLATION

Click the Download with manager button on top of the file.

RaceMenu will appear in in NMM's Mods list once it's downloaded. Double-click the RaceMenu entry to Activate it.

Start NMM and click on Mods.

In the left icon bar, click on Add Mod From File and select the downloaded archive file.

RaceMenu will now appear in the list. Double-click to Activate it.

Locate the Data/ folder in your Skyrim installation directory. Typically it's found at Program Files/Steam/steamapps/common/skyrim/Data/.

Extract the contents of the downloaded archive file to your Data/ folder.

In the Skyrim Launcher, select Data Files and enable RaceMenu.esp.

KNOWN ISSUES 2.0.0 to current

KNOWN ISSUES 1.4.0 to 1.4.3

KNOWN ISSUES 1.3.4 AND EARLIER

Vampires - Colors will not work properly for vampire characters due to the "overlay head parts" flag, this flag generally only occurs on vampire races and interferes with not only head parts but tints as well, resulting in colors you were not expecting, this happens with the vanilla game as well. This flag can be removed, but it means you will lose the vampire eyes.

Hotkeys not working - Zoom and Light will not work if you have started a new game directly from the main menu. You will need to save and reload your game, this is a bug with SKSE 1.6.6 and has been fixed for the next version.

Head, Breast, Glute, Biceps settings reset on load - This is a problem with scaling skeletal nodes if you save in first person and reload your game the 3rd person mesh will not have been loaded yet to update, this is fixed for the next SKSE version by using a new event to determine if you have entered 3rd person.

Invisible weapon - This is caused by a function being used to visually update your face when your game starts, unfortunately this function has some strange side effects that aren't really related to the RaceMenu, loading your game with your weapon drawn will make your weapon appear as though it is sheathed, redraw your weapon or saved with it sheathed until the next version.

Horse flipout - Same cause as invisible weapon, the cause has been removed for the next version so for now don't save on a horse, or immediately dismount when you load your game.

TROUBLESHOOTING

The Skyrim Script Extender (SKSE) , Version(or newer) isto run the RaceMenu.If you don't know how, or cannot install SKSE on your own I recommend watching:RaceMenu related SKSE Plugins:For ECE to RaceMenu migration see:If you experience crashing while opening the menu please consider acquiring the optional download DisableFaceGenCache (integrated as of version 2.7+, no longer necessary). This is an SKSE plugin that disables caching of FaceGen parts that can crash your game if you have many hair/eye/brow mods installed.The RaceMenu was redesigned with the intention of using SKSE to allow for more in-depth customization of your character. This mod does not fix the problems with the internal class to this menu; it merely redesigns it and adds more features. Please ensure that you don't have problems opening the ORIGINAL RaceMenu before blaming this mod.Not recommended for cross-gender, cross-species, or horse-mounted use.There is now new syntax to the previous feature to allow randomization of all actors of a particular gender.To setup an initial BodyGen file you need to create two ini files at:meshes/actors/character/BodyGenData/%MOD_FILENAME_WITH_EXT%/morphs.initemplates.iniThe templates file outlines BodyMorphs by nameHere is a sample:The morphs file defines what morphs should be available to what ActorBases, here is an example:For the new All feature, this would say:Make sure you have empty new lines at the end of your ini files.If you have explicit overrides in other mods they will overwrite by load order, so if you have all in an earlier mod, then have one explicit in a later mod, the ActorBase will use the later setting.What are Equippable Transforms? They are essentially additional data that can be attached onto Armor that will apply an NiTransform internally to the skeleton. What would you use this for? Replacing High Heels of course! The transform is also done natively so it's near instant application.How do you use it? Simple, add an NiStringExtraData named "SDTA" without quotes (Skeleton Data) to your NiTriShape or NiTriStrips of the armor you want to apply it to (You may need to apply to both _0 and _1)The "String Data" will be a JSON formatted string, here is a sample:The "name" field is the name of the node you are transformingThe "pos" field is a relative translation of the node you are transformingThe "rot" field is a rotation in degress in euler angles (heading, attitude, bank)Here is a sample for replacing High HeelsYou may need to tweak the units as I just eyeballed it for the particular boots I was using.This runs off the existing Transform framework that NiOverride provides, so any modifications to particular nodes will stack with these, you can only have one internal equipped node transform (i.e. two pieces of armor cant modify the same node, overwriting will happen and the behavior will most likely be last written or undefined).This feature will import the geometry of a nif file that is formatted for NPCs (You either exported it, or you copied an NPC's into the directory)This feature is complicated, the tools you have available are Inflate, Deflate, Smooth, Move, and Mask.Drag with right mouse clickHold the Secondary button and drag with right mouse click to pan.Moves the hit vertices out/in based on an average of adjacent face normalsMoves the hit vertices to an average position of all adjacent vertices,do not use near openings such as the mouthMoves vertices in the direction you move the cursor, orthogonal to the view planeExcludes vertices from being altered, including imported geometry, if you are importing a head with a different neck seam you should mask add around the neck area before importingHistory will store all previous vertex actions including Clear Sculpt, Import Geometry, and all brush actionsThis is the window for changing the wireframe preview including locking the mesh (so it can't be edited) making the mesh visible, or changing the wireframe colorThis will wipe all sculpting data from all ACTIVE parts (Editable must be checked)Presets are now saved to explicit file names and have changed format to json, as such will be saved as .jslot files, if you are replacing an existing slot file, refrain from replacing a .slot file, clicking on a selected file when saving will overwrite the selected file, and the file extension will be for binary but will try to load the json and fail. Binary slot files can still be loaded for legacy purposes, however this format is no longer saved by CharGen.See Changes sectionAn INI setting has been added to SKSE to allow for higher resolution warpaint to be applied to your character. The default resolution is 256, this is a terrible resolution if you want to do some really fancy warpaints.Yourshould look something like this:Putting a higher resolution should be possible but I have only tested it at 2048.Keyboard:Controller:. How do I change the number of overlays available?. Open Data/SKSE/Plugins/NiOverride.ini in any text editor and change the values here.. Do I need to install CharGen Extension?. Not for versions 2.7 and up, CharGen Extension is completely included, you should uninstall it if you had it prior to installing 2.7 and up.. I see dollar signs everywhere and many features appear to be missing what do I do?. Install SKSE, or if you have installed it, run your game using skse_loader.exe as you should be.. Is this compatible with ECE?. Partially, only a few features will work, generally I do not recommend using them together as presets will not work.. How do I get more Face/Body/Hand/Feet Paint?. Open Data/SKSE/Plugins/NiOverride.ini in a text editor, you will see a section for the amount of paints you can have per type, you can change this up to 128, but it is highly recommended you only set what you intend to use as too many can result in significant performance losses.This short tutorial assumes you have SKSE 1.6.6 (or greater) correctly installed, already have basic knowledge in compiling scripts, using the Creation Kit, can solve compiling errors on your own, and assumes you have already downloaded the modders package.To package and distribute your plugin you only need to include:Data/Scripts/YourPlugin.pexData/YourPlugin.espEnhanced Character Edit is not directly compatible. RaceMenu has compatibility code to accommodate some of the extra facial morphs, install ECE first, then install RaceMenu to take advantage of this. There will be a CharGen verison of ECE sliders soon.Extended Slider Colors (My previous mod) is not incompatible, but it is highly recommended you uninstall it as it is no longer necessary.Irrelevant, put it anywhere you want it won't make a difference.ORORBody/Hand/Feet paint may appear to be rendered overtop of some effects, this is a known issue. The reason this happens is due to the AlphaProperty flags on the overlay template meshes, changing these to the other set of flags results in overlays occasionally partially rendering on the skin.The right bicep scale increases strangely. This is a problem with the skeleton and associated mesh, it cannot be fixed on my part and probably won't be fixed by anyone else either. The bug has propagated to pretty much every armor ever made from the base bodies so it's probably far too late to be ever fixed.There may be some oddities regarding custom scales. They aren't game breaking but they may occasionally unintentionally reset themselves if you frequently enter the RaceMenu with modified scales (I.E. height, head, breast, bicep, or glute values other than 1). This is due to the NetImmerse update being missed in SKSE 1.6.8, the current workaround will ensure that when actually playing these scales will maintain themselves, but you may need to set the value again if you enter the RaceMenu again.Version 2.1.0 to 2.1.1 TroubleshootingIf you are unable to use glows uninstall 'Loose Main Scripts' completely, check your Data/Scripts folder for any RaceMenu*.pex files and delete them. Then install 'Loose Base Scripts' that is compatible for your version.If you are having issues where the Makeup, Body/Hand/Feet Paint categories are completely empty, install 'Loose Base Scripts'Version 2.0.8 TroubleshootingIf you are having issues where the Makeup, Body/Hand/Feet Paint categories are completely empty, install 'Loose Main Scripts'Version 2.0.0 TroubleshootingAre the last 3 categories unavailable? If so this indicates you don't really have the latest version of SKSE running. Many people misunderstand what the latest version is, the _1_9_32 on the end of the DLL is not SKSE's version. This is the game's runtime version indicating that the DLL will only run for that game version, there can be multiple versions of SKSE for the same game version.If the last 3 categories are there but you only have "default" to choose from when you change the body texture: You are missing the Overlays Plugin, this plugin contains a number of textures by various authors and are not included in the main mod (simply because they are large and I don't want to be uploading a few MB to update the mod every time; my upload is awful).If the categories are there but you don't even have "default" to choose from in the texture list: you have a RaceMenu plugin that is distributing an older version of RaceMenuBase, download "Loose Main Scripts" to override scripts from the outdated plugins, the newer script is backwards compatible.If you're experiencing immediate crashing upon opening of the RaceMenu, you have too many assets loading and are overflowing the HeadPart cache. I recommend downloading DisableFaceGenCache, this will disable caching when loading the menu, as a result you will briefly lag or stutter when changing hair, eyes, brows, or beards. Short lag is far better than crashing.If your problem is none of the above you probably have far bigger issues like not even running SKSE with the loader (or not as admin). Or your just simply pushing the game engine way too hard (too many mods, too many high-res textures, too much going on etc). The limitations of the game engine are independent of your PC. If your PC is great save yourself the trouble of typing it out as it's probably irrelevant.Please make sure your game does not crash opening the original RaceMenu before posting your issue. This mod does not fix the internal class to this menu, it merely redesigns it and adds more features.If your head appears to be so small you can't see it try cleansaving and installing the latest version.If your game crashes when you color too many warpaints, this is normal. Currently the game has some sort of hard limit on the number of tints you can have at one time and is currently being investigated.If your zoom or light toggle do not work this is because there is currently a glitch in SKSE that does not hook the key input system when you start a new game. You need to save your game and reload then showracemenu in the console to fix this. This is corrected for the next SKSE version.If your game crashes when you create a new game, this is likely because you have SKSE 1.6.5 install, and not SKSE 1.6.6, this also means you will likely have some of the other issues in this section.If you see [???] for button icons this means you either do not have SKSE installed, it is not updated to the appropriate version, or you are not running your game with SKSE in effect.If neither hair color nor tint colors do anything this means that your SKSE scripts are not up to date. Note: This still requires you actually have and run SKSE.If you are experiencing random crashing. This is, unfortunately normal behavior. The internal class for the RaceMenu isn't completely stable to begin with, this is a rework of the menu with some additional features using SKSE, I can not, nor have the responsibility to fix these issues.If you are experiencing freezing when opening the RaceMenu, this is due to your game loading many assets all at once and needs to queue drive requests, wait patiently for it to load. If it takes longer than 3 minutes than there is likely an internal issue usually caused by having too many hair mods. This same freezing would happen regardless of having my mod.If you are experiencing crashing on startup, you likely have a problem with another mod, please take those complaints elsewhere as this mod should not ever conflict.If there is anything off with the translation and you would like to help correct it, see the Google Spreadsheet for the RaceMenu.