Description:

This mod allows bouncy HDT physics to unequipped/sheathed weapons. This mod comes in two variants:

Craftable Weapon Sling:
You can craft a Weapon Sling item at a tanning rack for 3 leather strips and 1 iron ingot. The weapon sling allows bouncy HDT physics to unequipped/sheathed weapons when worn. When crafting the sling item, you will be presented with several options of which type to craft:

• Weapon Sling - The default weapon sling. Will only apply physics to vanilla-type weapon positions.
• Weapon Sling (Dual Sheath) - Compatible with dual sheaths. Uses the default dual sheath arrangement.
• Weapon Sling (Belted Quiver) - Compatible with dual sheaths. Uses the default belted-quiver arrangement.
• Weapon Sling (Dual Back Scabbard) - Compatible with dual sheaths. Uses the default back one-handed sword arrangement.
• Weapon Sling (Belted Back Armory) - Compatible with dual sheaths. Uses a custom arrangement, combining the belted quiver with the back one-handed swords.
• Weapon Sling (Well Fitted) - This may also spawn as the player's default weapon sling if Groovtama's XPMSE v2.60+ is installed (is also craftable at a tanning rack). Will work with any custom weapon configurations set by the RaceMenu by Expired. Do not use this weapon sling if your character is not using the proper XPMSE version! Compatible with dual sheaths.
• Weapon Sling (Personalized) - If you have a blacksmith's hammer in your inventory while crafting, you can also make a custom sling reserved for your own preferences (if you are using v0.2d+, customization can be made via the MCM). Compatible with dual sheaths.
  

Note: "Compatible with dual sheaths" means that the physics will apply to both the right- and left-handed sheaths. This, in turn, allows you to see both sheathed weapons, given the proper mods installed. Depending on how many actors have this going on at once and your system setup, it may bog down your game. Alternatively, the vanilla variants apply physics to less bones, thus using less resources to calculate the physics.

If you have follower NPCs, you may also be able to give them slings as well. You can mix and match different sling arrangements even if you
don't have a matching main skeleton. Though a matching skeleton is preferred, it is not required. Certain visual glitches between pause screens may be prevalent when using an arrangement that does not match your skeleton, but it is purely graphical and not game-breaking.

In version 0.2b+ of this mod, the player character will automatically have a default weapon sling added to his/her inventory and equipped upon starting the game. The mod is also able to automatically add and equip a weapon sling to any valid NPC near the player character (this includes Draugr, Skeletons, and Falmer as well). If the NPC has a weapon and it is equipped, they will automatically get a weapon sling, if they are unarmed, they will not get a sling until they equip a weapon. The options can be found in SkyUI's MCM under "HDTPE Weapon Sling". By default, the add-and-equip to NPCs feature is turned off for safety reasons. It is highly recommended that you set your desired slot number first before enabling the NPC feature--as once the slot number has changed, the sling needs to be unequipped and re-equipped in order to refresh the changes (some NPCs cannot un-equip/re-equip items automatically).

The NMM Installer of this variant includes options for alternate physics movements as well as alternate dagger and 2-handed weapon positions. It also includes animation and image references for the user to compare. The installer also includes .esps for MCM, No MCM, Craft Only, and Craft + Outfits (the latter two do not use scripts).

Performance friendly. Plugin made by Jacques00.

Everyone:
This variant of the mod will enable the sheathed weapon physics to the player character and all valid NPCs. It does this by replacing HDT Physics Extension's default .xml file. This will overwrite any custom hdtPhysicsExtensionsDefaultBBP.xml file you may have.

For those with close-to-vanilla setups, there is also a Vanilla version of this variant (TBBP/BBP and dual sheath compatibility, and the XPMSE requirement are not a part of this version--though see the Known Issues section below for specification.) Install this if you don't want any errors in the hdtPhysicsExtensions.log file concerning missing bones to bind physics to--this is because you are using a vanilla-like skeleton that omits the Breast and Butt bones.

(Note: the "Everyone" version of this mod has now been moved to the 'Old Versions' section to prevent confusion with the current version of the
mod. When further breakthroughs happen for this version, it will be updated accordingly. For now, development on this version is on hiatus.)

Optional Downloads:

• HDTPE Wearable Lanterns Mesh Replacement - Replaces worn lantern meshes for Wearable Lanterns by Chesko and makes them HDTPE-compatible. Either variant of the main mod is not required for this add-on, but the add-on does require Wearable Lanterns to be installed first. This affects all worn lanterns (default, paper, and torchbug jar lanterns). Because there is a technical difficulty for making the physics show on held weapons/shields/torches (if possible at all), the held lanterns could not have physics implemented, unfortunately. If this changes in the future, then this add-on may be updated for that. After installing this replacement, additional replacements also include Wearable Lanterns SMIM Patch by Telamont and Wearable Lanterns - Lighting Fix by IcePenguin. Alternate edits to this mod can also be found: Travel Lanterns Art -HDT Equipment- by SrRamrod.
  

(Note: The basic requirement for these optional add-ons is the HDT Physics Extensions plugin.)

---

Requirements:

All Versions Require:

• HDT Physics Extensions by HydrogensaysHDT - Physics engine. Latest version.
• SKSE - Skyrim Script Extender. Latest version.
  

Required for "Weapon Sling" Variant (for version 0.2b and higher):

• SkyUI - to access the mod options using the MCM settings. (A non-MCM version is included in the NMM Installer if you choose not to use SkyUI or the MCM.)
• NetImmerse Override (for v0.2d+) - for the "Personalized" Weapon Sling features. If you are using the latest version of Expired's RaceMenu, this plugin should already be included.
• Brawl Bug Patch or Brawl Bug Plugin (Optional) - to avoid brawl bug issues with the cloak spell function (regardless, a "Brawl Check" safety option is also included in the MCM).
• Note: This variant of the mod should work for any skeleton, as long as it contains vanilla weapon nodes. However, there have been a couple reports saying there is a strange conflict using this mod and XPMSE, with Pretty Female Idles and/or Victoria's High Heel Walk. The solution to this is if you are using those particular animations, to roll back to an earlier XPMS. This is not a fault of the mod or the skeleton, but it may be issues with the animations themselves. This conflict does not affect the "Everyone" version.
  

Required for "Everyone" Variants (Recommended for Craftable Sling variant, but not necessarily required):

• Groovtama's XPMS Extendend skeleton by Groovtama & xp32 - The latest version of Groovtama's extended skeleton.
• Note: Currently, the "Dual Sheath Redux" version for "Everyone" has a modified skeleton that overwrites the XPMSE skeleton for technical dependency reasons. We are looking to removing this dependency, but until then, using this version will overwrite any custom weapon placements you may have when installing XPMSE! Because the overwriting of the skeleton is necessary, be sure to install this mod after installing any skeleton.
  

Recommended Mods for All Versions:

• Dual Sheath Redux by Neovalen - For left hand weapons to show up and shield on back.
  

Or

• Equipping Overhaul by DragonDude1029 - To see the mod in all it's glory.
  

Or

• All Geared Up by MrJack - To see the mod in all it's glory.
  

Remember to read the prerequisite for these mods in order to get them working!

---

Installation:
Note: Please make sure all the prerequisites are installed and working first--then install this mod.

Craftable Weapon Sling:

• Use the mod manager or extract all files manually into their respective folders (drop the "data" folder into your Skyrim folder). Be sure to back up any files that require overwriting as a precaution. Users of the NMM Installer version will need to install with the mod manager and will be guided through the install options step-by-step.
• Activate the HDTPhysicsWeaponSling.esp in your plug-in list.
• The Weapon Sling items can now be crafted at any tanning rack in the game.
• For v0.2b+, you can access the option via SkyUI's MCM after the menu registers.
  

Everyone:

• Use the mod manager or extract all files manually into their respective folders (drop the "data" folder into your Skyrim folder). Be sure to back up any files that require overwriting as a precaution (namely, the hdtPhysicsExtensionsDefaultBBP.xml file).
  

---

Uninstallation:
Note: Please make sure to have backups in case something goes wrong.

Craftable Weapon Sling:
Use the mod manager or remove the following files:

• data\HDTPhysicsWeaponSling.esp
• data\meshes\weapons\weaponsling (entire folder and contents within)
• data\skse\plugins\hdtPhysicsExtensions\weapons\weaponsling.xml
  

In addition, if using v0.2b or higher, remove the following files:

• data\interface\HDTPhysicsWeaponSling (entire folder and contents within)
• data\interface\translations\HDTPhysicsWeaponSling_(LANGUAGE).txt
• data\scripts\HDTPE_WeaponSlingApplyingScript.pex
• data\scripts\HDTPE_WeaponSlingMCMScript.pex
• data\scripts\HDTPE_WeaponSlingPlayerScript.pex
• data\skse\plugins\hdtPhysicsExtensions\weapons\weaponsling_b1hs.xml
• data\skse\plugins\hdtPhysicsExtensions\weapons\weaponsling_dsr.xml
• data\skse\plugins\hdtPhysicsExtensions\weapons\weaponsling_user.xml
• data\skse\plugins\hdtPhysicsExtensions\weapons\weaponslingdraugr.xml
• data\skse\plugins\hdtPhysicsExtensions\weapons\weaponslingdraugr_user.xml
• data\skse\plugins\hdtPhysicsExtensions\weapons\weaponslingfalmer_.xml
• data\skse\plugins\hdtPhysicsExtensions\weapons\weaponslingfalmer_user.xml
  

Also, if using v0.2b or higher:

• It is highly recommended to use a save tool to remove any leftover latent scripts (see script names above--file extension ".pex") on a save game after uninstalling and optionally creating a "clean save".
  

Everyone:
Use the mod manager or remove the following files:

• data\skse\plugins\hdtPhysicsExtensionsDefaultBBP.xml
  

In addition, if using the current "Dual Sheath" version, remove or replace the following files:

• data\meshes\actors\character\character assets\skeleton.nif
• data\meshes\actors\character\character assets\skeletonbeast.nif
• data\meshes\actors\character\character assets female\skeleton_female.nif
• data\meshes\actors\character\character assets female\skeletonbeast_female.nif
  

---

Known Issues:

General Issues:

• Sometimes the physics freak out (usually relates to .xml file and other variables, such as system setup, ENBs, render settings, vsync, time-scaling and/or frame/altering mods). Some have said capping the frames-per-second to about 50 or 60, disabling v-sync, and/or enabling WaitBusyRender will help remedy this. The frame rate does have an impact on how the physics is calculated with the HDTPE plugin, so do keep that in mind. This is an HDTPE plugin issue, not an issue with this mod in particular. For more support or information, please visit HDT Physics Extension for Skyrim.
• Clipping is inevitable (clipping has been minimized, but certain combinations will inevitably clip--this is a common problem with features that are highly modular as there is no one-size-fits-all). There are adjustable features (via the MCM) for the Personalized Weapon Sling that may help remedy that, but only for the player character and not for NPCs.
• Though no longer an early test version, this mod is still a work in progress from time to time.
  

Craftable Weapon Sling:

• When using a sling that does not match the actor's skeleton, the weapons for that actor may jump back to their original positions between pause menus (inventory, console, etc.--this is a limitation of the HDT PhysicsExtension plug-in and skeleton files, not the items themselves).
• Slot limitation--If you are using mods that occupy the Biped Object Slot 44, this mod may conflict with it (Slot 44 is the default slot this mod uses on start-up, but it can be changed if using v0.2b+ of this mod).
• (v0.2b+) The player can infinitely farm weapon slings from an NPC if the cloak spell remains active while removing a weapon sling from an NPC. To avoid this, turn off the cloak effect via the MCM or console before removing a weapon sling from a living and armed NPC.
• (v0.2b only) There was an issue with the HDTPE_WeaponSlingApplyingScript.pex rewrite in which I forgot to reincorporate my dispel safety feature before uploading. This may result in a save bloat/script lag. If you are using this version, please check the Update section, under the Files tab, for a patch (it will replace the previous script). If the save still bloats (or game script lags during excessive play) after installing the patch and cleaning the latent scripts using a save tool, please let me know in the comments/forum. Future releases will incorporate the update already, so no worries if you are using a newer version of this mod.
• When using the Default "Weapon Sling" for NPCs, sometimes the back weapons spin when too far from the player character. To get passed this, it is probably best to spawn the "Dual Sheath" or other custom weapon sling aside from the default. For v0.2e and under, the issue will still be present for Creatures, but it will be solved for the future releases. This has been fully resolved in v0.3a+.
  

Everyone:

• Places with mounted/hanging weapons (like outdoor vendor stands), may have their weapons offset--making the weapons appear to float (this is an artifact of the HDT Physics Extension plug-in's auto-binding system and how weapons are handled by Skyrim's engine).
• Because of how the hdtPhysicsExtensionsDefaultBBP.xml works, the weapons physics may only apply to female characters--it seems the best solution for full gender support is to use the latest XPMSE.
  

---

Alternate Downloads and Fixes:
Third-party fixes made by others in the community. If you have any problems with the current setup and are looking for alternative solutions, you may find these links useful.

Everyone:

• HDT Equipment v0.2 - Everyone - Breast Fix by Mirage711 - Fixes parameters of breasts in v0.2. Also includes a Dual Sheath Redux version.
• HDT Equip With Belly and Collision for Everyone by Carloss32 - Edited parameters for the breasts, butt, and added belly node in v0.2. Also includes a Dual Sheath Redux version.
  

---

Current Plans/Development:

Weapon Sling:

• Possibly add universal preset slots for the Personalized Weapon Sling.
  

Everyone:

• Development on the "Everyone" versions are on hiatus at the moment due to technical hurdles. Once there is a compatible way to making them work with dual sheaths without having to result in overwriting skeletons, improvements will resume (most likely it will either involve a skeleton.hkx patch, or dependency on one exclusive skeleton--similar to how it is now, but "better").
• It is recommended to use the performance-friendly "Weapon Sling" version for dual sheaths if you have an issue with overwriting your current skeleton.
• For those who don't mind just one additional .esp, an ongoing "light" script, and sacrificing that one Biped Object Slot, I highly suggest migrating over to the "Weapon Sling" version as it comes with more options, more user control, and won't kill your system with numerous NPCs on the screen at one time (though that last statement may be debatable!). Though you can theoretically use both variants at the same time, it is gradually getting redundant to do so, so it may be best to choose one over the other.
  

Thank you for your patience and I hope you enjoy the mod!

---

Credit to Jacques00 for helping me make this possible.