Why does this mod exist?

The purpose of this mod is to allow switching equipment without digging through the menus.

This mod takes inspiration form Elden Ring's hotkey system and focuses on being easy to use while being responsive. This mod also takes some design inspiration from mods such as Souls Quick Menu and iEquip, but by no means is a replacement or derivative work. This is only an alternative.


Why does this mod require SkyrimPlatform?

This is the main hindrance (to some) and a reason this mod exists. With SkyrimPlatform, mods are programmed in TypeScript, which is easier to learn than C++ and is faster than Papyrus. Also, with SkyrimPlatform, widgets are created with HTML/CSS rather than Adobe Flash (problematic to get nowadays).

With all these advantages said, SkyrimPlatform is not perfect, and the experience varies from user to user. Some people (including myself) use it with hardly any issues, but others seem to have the worst experience with that mod.

Maybe I will create a version of Elden Equip that does not require SkyrimPlatform in the future. These things take time, and I feel like people overlook that I can’t work on mods all the time.


Preview video?

Preview video



Requirements

Use the latest versions of these mods that are compatible with your version of Skyrim.

• SkyrimPlatform
• JContainers SE
• MCM Helper
  

Installation

Install the requirements, then install Elden Equip with a mod manager.

Also, install any of the optional controlmaps if you use a gamepad.

Priority does not matter much, but let this mod be overwritten by its reskins and/or translations.



Reskins

Nordic Equip by hayd removed for some strange reason.

Information for creating reskins.




Translations

Information for creating translations.





Core Feature - MCM Settings

All settings are found in the MCM. This was created using MCM Helper, so these settings are persistent across all saves. These settings are separated into four subcategories.

• Controls - Assign buttons and hold times for actions.
• Equipping - Set QoL options such as dual casting, cycle hold reset, optimal potions, etc.
• Interface - Tweak equipment/gold widget positioning, set dynamic visibility, etc.
• Misc - Print cycles to console, disable messages, uninstall, etc.
  

Core Feature - Widget

Displays currently equipped shout/power, left hand item, right hand item, ammo (when bow/crossbow is equipped), and queued quick item. Layout and positioning similar to Elden Ring.





Core Feature - Cycles

In Elden Ring, and other Souls games, the player has four cycles for spells, quick items, left hand, and right hand items. This system allows the player to switch items with a button press. This mod includes a similar system from the Souls games and mods such as Souls Quick Menu. Anyway, here is a list of the cycles and what can be contained in them.

• Voice (up button) - shouts and powers
• Quick items (down button) - potions, food, poisons, and armor pieces
• Left hand (left button) - one-handed weapons, spells, shields, and torches
• Right hand (right button) - one-handed weapons, two-handed weapons, ranged weapons, and spells
• Ammo (left button) - arrows (if bow is equipped) and bolts (if crossbow is equipped)
  

Core Feature - Cycle Editor

This mod’s Cycle Editor feature allows adding and removing items from each cycle. This is partially inspired by Assignment Mode in Souls Quick Menu, but requires no additional assigned buttons.

To enter the Cycle Editor, hold the “Cycle Editor Button”, then the widget frames will become a different color and a notification will appear saying “Opened Cycle Editor”.

Items are added to their respective cycles as they are equipped or used. See the “Cycle” section above to know what can be contained in each cycle.

Items are removed from their cycle as their respective button is pressed. Doing so will equip the next item in the cycle.

To exit the Cycle Editor, press the Cycle Editor Button.



Optional Feature - Pouch Items

Another feature taken from Elden Ring are the pouch items. In Elden Ring, this allows quick and convenient usage of consumable items without needing to deal with cycles.

In Elden Equip, this functions like Elden Ring, but includes weapons, spells, potions, etc. These items are based on favorites item hotkeys 1-4, but can be offset in the MCM to be hotkeys 2-5, 3-6, etc. To keep this description simple, these hotkeys will be referred to as hotkeys 1-4.

• Hotkey 1: left pouch item
• Hotkey 2: up pouch item
• Hotkey 3: right pouch item
• Hotkey 4: down pouch item
  

In the Favorites menu, assigning pouch items on keyboard requires pressing any of the 1-4 keys. However, on gamepad, the controls are different and requires Auto Input Switch (or any alternative mod) to work correctly.

• Pressing the left button assigns to hotkey 1
• Holding the left button assigns to hotkey 2
• Pressing the right button assigns to hotkey 3
• Holding the right button assigns to hotkey 4
  

Outside of any menus, these items are accessed by holding the assigned “Visibility/Pouch Button” and are equipped/used by pressing the up, down, left, or right button.



Optional Feature - Dynamic Visibility

And one of the last features ripped from Elden Ring is its Auto HUD setting. With Auto HUD in Elden Ring, the Interact button is used to show the HUD and fades away after a few seconds. Also, the HUD shows up during combat when equipment information is vital.

In Elden Equip, a similar feature has been implemented called Dynamic Visibility. This feature is optional and can be enabled in the MCM, along with its contexts to show on combat and/or on button press.



Optional Feature - Custom Controlmap for Gamepad

Ignore this section if you’re using a keyboard and mouse or use a different controlmap.

This mod includes an optional download for an Elden Ring Style controlmap and a Vanilla Style controlmap. Designed mainly for gamepad controller users.

To install a controlmap, open the Skyrim SE base directory and delete a file called ControlMap_Custom.txt. If it doesn’t exist, you should be fine. You can install the controlmap file like any other mod.



Since this controlmap changes the left/right hand attacks to LB and RB, you will need open SkyUI's MCM and remap the Previous Column and Next Column buttons to LT and RT (or L2 and R2 on PlayStation). That way, equipping items to a specific hand will not change the order of items.

The Elden Ring Style controlmap was designed with these two mods and controls in mind, but any alternative mod can be used.

• Dodge - Modern Combat Overhaul (DMCO)
• One Click Power Attack (OCPA)
  

In case you're having issues with DMCO, use Classic Sprinting Redone.



The Vanilla Style controlmap only removes the favorites buttons (d-pad) and replaces the favorites button. Also, you will need to remap the Pouch/Visibility Button to A (or cross on PlayStation) and set the Quick Item Use setting to Alternate.



Compatibility

• Compatible with Quick Loot RE and QuickLoot EE.
• Widget is not compatible with any SkyrimPlatform mod with a widget.
• Widget is not compatible when using Linux (SkyrimPlatform's browser is not compatible on Linux).
• Pouch is not compatible when using Extended Hotkey System.
• Should be compatible with anything else, but who knows?
  

Known Issues

• SkyrimPlatform dependency (maybe you’re the lucky ones).
• Minor stutter when cycling. My code could be very janky.
• Widget appears in unfaded loading screens.
• Effects are still obtained from potions in the Cycle Editor.
• Weapon enchants are lost when equipping them through the LH/RH cycles.
• Mod does not load when starting a new game or running a coc command.
  

Troubleshooting

At minimum, check the console and see if there is an initialization message related to this mod ("Elden Equip is initialized!").

If you're loading into Skyrim with a new game or coc (location), Elden Equip will not load. Loading an existing game save (new or old) will load EE.

Otherwise, make a bug report. Just explain in detail what the issue is and how to replicate it. Also, in your report, mention the version of Skyrim SE, dependencies, and Elden Equip you are using.

SkyrimPlatform issues can be reported in their issue tracker.


Uninstallation

Uninstalling mods during a playthrough is never a great idea, but you can uninstall Elden Equip safely as long as you follow these steps.

• Open Elden Equip's MCM, navigate to "Misc", then enable the "Uninstall Mod" setting.
• Exit the MCM then the system menu, and you simply need to create a save, exit the game, and remove/deactivate the mod.
  

To uninstall the controlmap, you need to deactivate it, open the Skyrim SE base directory, and delete a file called ControlMap_Custom.txt if it exists.

Bear in mind that you should not uninstall SkyrimPlatform during a playthrough since doing so may break your game save. Then again, there have been posts on SkyrimPlatform's mod page from other users that you could work around those issues by removing instances of "TESModPlatform" using a tool such as ReSaver.


Source

GitHub