About this mod
High Heels anywhere, anytime. Now works with or without the FO4 High Heels System.
- Requirements
- Permissions and credits
- Changelogs
A high-effort mod I wrote years ago. Been using and refining it ever since. Finally uploading it now. Enjoy! :D
HO3 (HHSOutfit 3) fully integrates HHS*, SAM and AAF into a smooth and seamless user experience. With HO3 enabled heels, your toon will sit properly in chairs and in some other furniture, and it'll have it's animations aligned properly in AAF - Even if the heels are really high and if the toon has been rescaled.
HO3 leverages niston's Dynamic Height And Scale tech, successor to the experimental Dynamic Height Adaption Technology from the infamous F-Me Shoes mod, released also years ago. Now this latest marvel of technology from the niston labs supports all HHSHeight values instead of just a single, predetermined one. HO3 therefore works for any and all HHS heels there are and will ever be. Unlike it's predecessor HHSOutfit 2, HO3 doesn't require anyone to rename or recompile any scripts either.
*HO3 works with or without the FO4 High Heels System. HHS will be used if installed, HO3 will provide it's own high heel effect otherwise.
There's pre-made patches for some popular mods I use, you can find them in the Requirements section (mods requiring this file).
Someone even made a Synthesis Patcher for HO3. It'll autopatch your modlist, as far as I understood. Cool stuff, check it out!
If you prefer, there are instructions on how to manually create a patch below. Or, you can suggest mods for patching in comments.
FEATURES
- HHS as optional requirement: HO3 will provide it's own high heel effect if HHS is not installed. Still requires ZeX or CBBE Knee Fix skeleton.
- Enhanced support for sitting animations: Chair, sofa, etc... (Requires Screen Archer Menu)
- Enhanced support for store animations (Requires Screen Archer Menu)
- Enhanced support for all Leito M/F AAF animations (Requires AAF)
Automatic HHS Race enables HHS support for custom race Actors wearing HO3 enabled heels, w/o having to edit the HHS ini file.- Automatic AAF Equipment Protection prevents HO3 enabled heels from being auto-stripped during AAF animations.
- Default OnSit Exception Keywords keep the high heel effect active while using workbenches and some other furniture, w/o HHS ini file editing.
- Experimental: Broken-Ankle-Syndrome Correction for AAF Poses (single Actor only, requires Screen Archer Menu).
- Works with any* HHSHeight value and any* Actor scale
PREREQUISITES
Hard requirements: Game Version 1.10.163, F4SE and SUP F4SE.
Next-Gen Update versions 1.10.980 and 1.10.984 are currently not supported. Support when? Perhaps, some day, maybe never.
Optional: Fallout 4 High Heels System - Will be used when installed. I recommend you do use HHS, it's more sophisticated than HO3's built-in HH effect. But HO3 also works without HHS now. There is nothing to do or configure for this, HO3 will auto-detect HHS' presence or absence.
Optional: Screen Archer Menu - Required only if you want enhanced OnSit handling.
Optional: Advanced Animation Framework & Leito AAF Animations - Required only if you want enhanced AAF support.
For enhanced AAF animation support to work, Idle Reporting must be enabled in AAF_settings.ini and AAF's built-in autoscaling must be disabled. HO3 can't ever work properly with AAF if you have any other mod messing about with Actor scales in AAF scenes.
There is an AAF settings file included, to automagically disable the AAF Autoscaler and enable Idle Reporting.
If the automagic doesn't work for some reason, ensure these settings are in your Data/AAF/AAF_settings.ini file:
[PREFERENCES]
scale_actors_for_animations = false
[ADVANCED SETTINGS]
api_include_idle_forms = true
NOTE: If it's not obvious, you must not use HHS' own AAF Integration together with HO3, or they will fight each other.
HOW TO USE - FOR GAMERS
- Install mod
- Install or make patch for existing armors/clothing
- Enjoy!
HOW TO USE - FOR MOD MAKERS
- Add HHSOutfit3.esl as a master to your mod
- Attach HHSOutfit3 script to ARMO in your mod
- Configure the HHSHeight script property
- Optional: Add and configure the GroundClipAllowance script property; See SOME TIPS below.
- DO NOT include any HHSOutfit scripts with your mod; Pay attention when packing BA2 archives.
- Add HO3 to your mod and it'll auto-support HHS where available, with fallback to HO3's built-in high heels effect. No txt or json file required.
- Done
HOW TO CREATE A HYBRID MOD - FOR MOD MAKERS
Hybrid mods will work with either HHS, HO3 or with both, but do not depend on HO3 being installed.
The creation process is the same as above, except:
- Do not add HHSOutfit3.esl as a master to your mod
- Include the usual .txt files for HHS with your mod
SUPPORT
- It just works!
HOW TO MAKE A PATCH WITH xEdit, IN 20 SIMPLE, ENCOURAGING STEPS
- Install the PatchTemplate Plugin found in Misc Files section. DO NOT ENABLE THIS PLUGIN IN YOUR LOAD ORDER.
- Did I mention to not ever enable the PatchTemplate Plugin in your game? Don't enable it.
- Load both the mod you want to patch and the HHSOutfit3-PatchTemplate plugin into your xEdit.
- Whenever xEdit asks to add any masters during this procedure, say YES.
- Copy all the mod's ARMO (Armor) records for High Heels and High Heeled Outfits from the mod as override into a new ESLified ESP file.
- You never need to override any records other than ARMO. You can override flat shoes and give them a HHSHeight of zero, see SOME TIPS below.
- Copy the HO3T_DummyARMO record (FormID FEXXX001) from the PatchTemplate plugin as new record into the new ESLified ESP file.
- When prompted for a new record name, just add the number 1 at the end, so that it reads HO3T_DummyARMO1.
- Navigate to the new ESLified ESP file in xEdit and find the freshly created HO3T_DummyARMO1 record.
- You can now copy the VMAD subrecord from the HO3T_DummyARMO1 record to any other ARMO record in ESLified ESP file.
- When done copying, remove the HO3_DummyARMO1 record from the new ESLified ESP file.
- Press Ctrl-S to save the plugin.
- Apply "Clean Masters" to the new ESLified ESP file. This will remove the both HHSOutfit3.esl and the PatchTemplate plugin from master table.
- Re-Add HHSOutfit3.esl as a master to the new ESLified ESP file.
- Specify a proper value for the HHSHeight script property of each ARMO record in the new ESLified ESP file. Set this to the same value as there is, or would be, in the well known HHS txt files (HO3 enabled heels do not need any txt files).
- Apply "Sort masters" to the new ESLified ESP file.
- Close xEdit and save the newly created ESLified ESP file -> This file is your patch now. In your LO, move it right below the mod you patched.
- Activate, verify and test in game. Correct any defects found.
- Yes, it is done! You did it!
- Congratulations, a patch just has been made by you.
SOME TIPS
* HO3 enabled heels are best worn by female Player Character or NPC. Male characters are currently untested and may not work properly.
* The Dynamic Height And Scale algorithm has two contradictive goals:
- Keep the equipped heels from clipping into ground during animations, in effect enforcing the specified HHSHeight offset as required.
- Keep the Actor animation aligned, in effect minimizing towards zero any influence of the Actor's specified HHSHeight offset.
To obtain the smoothest possible results, it is advised that the Actor wearing HO3 enabled heels be a bit smaller in scale than Actor(s) without heels.
* More details please?
For a rather simplified explanation: Dynamic Height And Scale algo relies on 1) a proprietary dataset that is known as a DHAS Transform and 2) some black magic. DHAS Transforms express multidimensional scale/offset relationships that are specific to a particular animation and independent of HHSHeight. After a preconditioning step to avoid ground clipping, the proper adjustment for the Actor in an animation is calculated, based on the availability of a DHAS Transform for the particular animation. If successful, the result is subsequently corrected for distortion introduced by the HHSHeight of the Armor (that's what the black magic is used for). Finally, the corrected adjustment gets applied to the Actor.
* What is HHFX4SUP?
This is HO3's own -somewhat rudimentary- implementation of the high heel effect, based on SUP F4SE. It'll engage whenever HHS is unavailable and provide for the necessary COM_Override skeleton node adjustments instead. On systems with a working HHS install, HO3 will defer to it through HHFX4HHS.
* Why is HHS still recommended, now that there is HHFX4SUP?
HHS is much more sophisticated than HO3's built-in effect. For example, HHS adjusts camera height in 1st person view for player chars with heels. HHFX4SUP does not and won't ever do this. There are other benefits to using HHS wherever it's possible, especially for player characters in heels.
* DHAS Transform data is currently available for Leito M/F animations only. Creating DHAS Transforms is heavily involved and utterly tedious. I'm extremely lazy. Also, I don't have time. Also, I wrote this so long ago that I probably forgot all the specifics of the process.
* It is possible to use HO3 with a HHSHeight of zero. This lets actors with flat shoes benefit from HO3's scale independent processing. There is also a "Zero HHSHeight" ring that can be crafted at the chem station for testing purposes. Scale independent OnSit handling is an experimental feature. Results may vary.
* Add the GroundClipAllowance script property for shoes/heels with very thick soles. This property's value will instruct the DHAS algorithm to allow the heels/shoes to clip into ground for the specified amount of in-game height. This can prevent excessive Actor rescaling for large HHSHeight values at the cost of introducing some visual disturbances by ground clipping, at levels deemed acceptable by the armor/plugin designer.
* Recommended HHSHeight is between 0 and 13. This covers most HHS Heels currently in existence. Negative values are not supported by HHS. There's nothing to stop you from exceeding the HHSHeight recommended maximum, but it may produce increasingly odd-looking results. For the odd fetish heels that absolutely, positively do require extreme HHSHeight values, make sure you deploy the GroundClipAllowance property described above. Allowing for the soles to partially sink into ground as required can prevent excessive Actor rescaling.
* HO3 enabled heels will only ever adjust the Actor on which they are equipped. HO3 will never make any adjustments to any other Actor(s).
* No matter what, HO3 will never rescale any Actors to invisibility; Very small scale values would render an Actor invisible.
* There can only ever exist one active HO3 Armor script instance in control of a particular Actor. Once a HO3 enabled Armor is equipped on an Actor, the HO3 script on that Armor will start up and try to acquire a lock on the Actor. If you have multiple HO3 scripts running on an Actor for whatever reason, only one Armor's script will actually gain control of the Actor - Usually the first one to be equipped. Control of the Actor will be relinquished only as the active Armor is unequipped. On unequip, the Armor's HO3 script will shut down. Unequipped HO3 scripts remain inactive while the Armor is in the Game world, or inside a Container such as Player's inventory or a Workshop.
* If AAF Idle Reporting cannot be activated for whatever reason, you might still get AAF support to work by uninstalling UAP. No guarantees.
* Do not try to convert this ESL into an ESLified ESP. There is absolutely no need to do so and it would just break things.
* HO3 scripts are very verbose - Enable Papyrus Debug Logging to observe. This is a prime source of info if you encounter any problems.
* What the VMAD subrecord for HO3 enabled Armor should look like:
