Equipment and Quick Slots

by RandyKnapp, rewritten by MidnightsFX

Version 3.0 is a complete rewrite.

Give equipped items their own dedicated inventory slots — Head, Chest, Legs, Shoulder, Utility and Trinket — plus up to six hotkeyable quick slots.

• Client-side installable; does not need to be on servers.
• When the server does run the mod (requires Jotunn), the balance settings (slot toggles, quick slot count, keep-on-death) are server-synced and admin-controlled.
• Existing 2.x characters are migrated automatically on first login. Do not downgrade to 2.x after saving under 3.0 — the automatic slot backup protects your items, but the old format is not written anymore.
• Quick slot hotkeys no longer trigger vanilla actions on the same key.
• Optional extra utility slots (Equipment Slots / Utility Slot Count, 1–3, default 1): wear more than one belt, Wishbone or Megingjord. Off by default and server-synced, because it is a balance change. You can never wear two copies of the same item, and the extra items show on your character for everyone.
• Configurable keep-on-death and auto-equip-on-gravestone-pickup behavior.
• Other mods can add custom slots through the API — see docs/API.md.

Please report bugs on our discord: https://discord.gg/ZNhYeavv3C

Source: Github

Install with BepInEx: copy EquipmentAndQuickSlots.dll into the BepInEx/plugins folder.

Console commands

• eaqs_validate — revalidates the slots and relocates overlapping/out-of-grid items
• eaqs_api — prints API version, endpoints and slot states
• invcheck — prints the inventory grid contents
• eaqs_restorebackup (cheat) — restores the automatic slot backup into free slots
• breakequipment, dropall (cheat) — testing helpers

Compatibility

• BetterUI works out of the box. While BetterUI's HUD editing is enabled (its default), BetterUI positions the quick slot bar: move it with BetterUI's HUD edit key (F7 by default) and BetterUI remembers where you put it. Quick Slots Anchor / Quick Slots Position in this mod's config only decide where the bar starts. If the bar sits somewhere odd after updating from 3.0.0, press F7 and drag it back, or reset BetterUI's uiData setting to none.
• Better Archery works out of the box. Its quiver used to add two hidden rows to the player inventory, which showed up as a block of empty cells under the inventory and could swallow items. Its quiver is now hosted as three ammo-only slots in the equipment panel, keyed to Better Archery's own hotkeys; everything else it does is untouched. Set Compatibility / Better Archery quiver integration to false to switch its quiver off entirely instead and use the quick slots for ammo.
• Other slot mods — AzuExtendedPlayerInventory, ExtendedPlayerInventory, ExtraSlots, ComfyQuickSlots — are declared incompatible; BepInEx will not load this mod next to them.

Notes

The following things WILL NOT BE ADDED OR CONSIDERED.

• Player wardrobe features (instead use Advizes Armoire)
• Slots which provide: dedicated arrow, or food slots, stat changes per slot (instead use Extra Slots)
• 3D or otherwise interactable character model (use Azu Extended Inventory instead)

3.0.2

• Better Archery compatibility

3.0.1

• Drag-to-unequip works again, with the unequip progress bar
• Compatibility with mods that make the player inventory scrollable (Valheim Plus with its [Inventory] section enabled).
• BetterUI compatibility.
  • Once BetterUI has taken the bar over, a one-time line in the log says so, rather than leaving you to wonder why Quick Slots Anchor and Quick Slots Position appear to do nothing.
• The readme now documents which mods are compatible and which are refused outright.

3.0.0

• Complete rewrite of the slot system.
  • All configs that impact balance or functionality now are server synced (if the mod is installed on the server).
• Your items are migrated automatically. On first login per character, items from the old 2.x slot storage (including pre-Mistlands saves) move into the new slots. There is no downgrade path — after a character has saved under 3.0.0, going back to 2.x will not restore the old format (the automatic backup still protects the items themselves).
• New Trinket equipment slot.
• Configurable utility slots (Equipment Slots / Utility Slot Count, 1–3, default 1): optionally wear more than one utility item. (This was previously a glitch that could happen, but is now supported as an optional feature)
• Quick slot count is configurable (0–6, default 3)
• Extra inventory rows (Inventory / Extra Inventory Rows, 0–5 default 0): Optionally enable additional inventory rows.
• Base carry weight (Inventory / Base Carry Weight): the player's carry capacity before belts; 300 (vanilla) leaves other mods' carry-weight changes untouched.
• Death fixes: Death item dropping/equipping now works correctly
• Hotkey conflict prevention: quick slot hotkeys no longer trigger vanilla actions bound to the same key.
• Public API for other mods — add custom slots, query slot contents, subscribe to changes. See docs/API.md; an embeddable typed shim (EquipmentAndQuickSlotsAPI.dll) is available from the repository or follow the doc example to use reflection to access the API.
• Console commands reworked: eaqs_validate repairs misplaced items (replaces the broken fixinventory); destructive commands now require cheats.
• Removed the dead Creature Level and Loot Control integration remnants and the second death tombstone (one grave now holds everything, sized to fit).

2.1.14

• Updated for Valheim 0.219.13 Patch (Bog Witch)