Immersive Equipment Displays (2024)

Feature highlights

Installation

As of version 1.7.2, XPMSSE is no longer a requirement. The plugin will dynamically create the necessary nodes as needed.Vanilla and many other non-xp32 skeletons are now supported. The system that creates these nodes is fully configurable so modders can add support for their skeletons without having to reach out to me. As a bonus, most followers with custom, non-xp32 skeletons and mods that overhaul race skeletons are automatically supported due to this change and support for those that use unrecognized skeleton meshes can easily be added.

Any XP32-compatible skeleton remains supported, however I generally don't recommend using thebloaty XPMSSE scripts since they can negatively impact performance. IED includes gear positioning/scaling and style fitting animations (through OAR), if you only used the scripts for this purpose you can replace XPMSSE with one of the light variants or uninstall it completely. Otherwise, read the first two points in the compatibility section below.

• SKSE64
• Address Library for SKSE Plugins
• Simple Dual Sheath- Required to showequipped left hand weapons, staves and for the ability to have the shield equipped on back.
  

• Weapon Styles - Draw-Sheathe animations for IED - animations that work with IED's gear placement system
  

Getting started

After installation there's not much to be done if these default settings are fine for you:

• All player and NPC equipment displays enabled (player must have the item favorited).
• NPC equipment displays turn off if they're not wearing armor.
• Gear nodes(equipped and displayed) setup in an adaptive way where offsets are applied based on what's equipped to minimize clipping and floating items. Weight and armor adjusts are applied to all items, including left hand weapons and shield.
  

UI

If you have issues opening the UI, configure your keys in the ini (ToggleKeys) and setOverrideToggleKeys=true. Keep in mind it can't be opened in a paused menu unless you setEnableInMenus=true in the INI.

This is just some basic stuff about the layout, I'll write an article with more details later. Everything is accessible from the main menu bar at the top of your screen.

• Save/load parts or the entire configuration. The files are written to and read fromData\SKSE\Plugins\IED\Exports.
  

Configuration views (top bar->View menu):

Configuration for equipment and custom displays.Anything configured here only affects the respective displaywith the exception of effect shaders which apply to the equipped weapon as well. Split into two subviews, accessible through the View menu inside the window:

• Equipment slots -main equipmentdisplays: 1h/2h sword, 1h/2h axe, mace, dagger, staff, bow, crossbow, shield, torch and ammo
• Custom- custom item displays: create miscellaneous displays from any supported in-game object
  

Gear nodes

Configuration for nodes that affectequippedanddisplayedgear. Split into three subcategories, accessible by clicking on the radio buttons inside the window:

• Positions- position, rotation, scale, visibility, offsets
• Placement- gear node placement, determines where the gear gets attached
• Physics- equipment physics config for gear nodes
  

If you opt to use the built-in equipment physics, you need to enable it in settings first (top bar->Tools->Settings) and if upgrading, a preset will need to be applied to your existing configuration. A basic one is included in the mod package. The physics engine is based on the original CBP implementation but heavily modified to be very CPU efficient while still providing fairly realistic simulation - it utilizes multiple CPU cores, SIMD instructions and shuts down simulation on nodes that don't have geometry attached.

Each configuration view is split into four classes:

• Global - applies to all actors
• Actor - applies to specific actors (references)
• NPC (ActorBase) - applies to specific npcs
• Race - applies to specific races
  

Each class holds a separate configuration for male and female.Equipment and gear nodes global classes are split into player and npc configs, you'll probably want to configure most stuff there.

Each view has an area where you can save/load presets which apply only to the config you're currently editing (both male and female are stored in the presets). Gear nodespresetsinclude both position and node placement.

Known issues

• Scabbard straps on weapons displayed on the left side stick out after installing 'XPMSSE Left Hand Sheath Rotation Fix' optional file from Simple Dual Sheath. Solution: use ImmersiveEquipmentMeshGen Synthesis patcherby SteveTownsendto automatically generate mirrored left-hand scabbard nodes for 1H sword/axe/mace/dagger meshes. Zip contents of the output folder and install it with your mod manager (place at the end of your load order).
  

Compatibility

• If you want to continue using the full XPMSSE plugin,styles in the MCM and placement in the gear nodes menu of this plugin need to be configured exactly the same to avoid node placement conflicts.
• If you use the XPMSSE racemenu plugin (or another plugin) to position your gear, turn it off and use this instead (navigate to View->Gear nodes). There's no hard conflict but the other plugin might clobber dynamic weapon position adjustments on actors. XPMSSE sets positions through skee64 (nioverride) and these settings may linger in the save even after the XPMSSE racemenu plugin is removed. They are applied after 3D loads so it may clobber IED positions after a race switch (for example after werewolf/vampire transformations).
• Not compatible with other mods that display unequipped gear (you'd see duplicate items)
• Mu Joint Fix is known to cause various issues with IED (reportedly with other display mods as well). Check its mod page for possible solutions.
• This plugin is fully compatible with CBP, HDT body physics and their variants. However, if you enable the built-in equipment physics, CBPC Equipment physics SE and AE needs to be disabled. This won't affect your body physics at all.
  

Credits