Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
You are viewing a potentially older version of this package.
View all versions.
WeaponSwitchQueue
Queues hotbar weapon switches during attack animations and applies them when the swing finishes. Client only.
| Date uploaded | 2 weeks ago |
| Version | 1.0.5 |
| Download link | cjayride-WeaponSwitchQueue-1.0.5.zip |
| Downloads | 78 |
| Dependency string | cjayride-WeaponSwitchQueue-1.0.5 |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2360README
Weapon Switch Queue
Queue weapon switches during attack animations in Valheim. Press a hotbar slot while swinging, and your weapon will equip automatically when the attack finishes—even while sprinting.
Features
- Queued Weapon Switching — Switch weapons mid-swing without interrupting your attack.
- Sprint Support — Queued weapon switches still apply while sprinting.
- Optional Queued Sheathing — Queue a weapon hide/sheath action using the same method.
- Instant or Animated Sheathing — Choose how queued hide actions are performed.
- Client-Side Mod — No server installation required.
- Inventory Validation — Cancels queued switches if the item leaves your inventory.
- Queue Timeout — Prevents stale requests from remaining queued indefinitely.
Configuration
Config file:
BepInEx/config/cjayride.weaponswitchqueue.cfg
Available options include:
InstantEquip— Instantly equips queued weapons. Default:false.DebugLogging— Enables debug logging. Default:false.QueueSeconds— Sets how long a queued action can wait before expiring.
Compatibility
- Verified against Valheim 1.0.21 (1.0.5). BepInEx dependency:
denikson-BepInExPack_Valheim-5.4.2360. - This mod replaces Queue Me Maybe for cjayride packs (same idea, maintained GUID).
CHANGELOG
1.0.5
- Re-verified against Valheim 1.0.21 (local
assembly_valheim.dlldated 2026-10-28;Player.ToggleEquipped/HideHandItemsstill compile). - Faster idle frames: skip queue ticks when nothing is pending; check sheath keys before
TakeInput; skip Harmony and Update on dedicated servers.
1.0.4
- Verified against Valheim 1.0.21 (Release build).
- BepInEx dependency set to
denikson-BepInExPack_Valheim-5.4.2360.
1.0.3
- Fix: a queued weapon switch still applies while you are sprinting. Valheim clears its equip bar on every sprint tick, so the switch was wiped before it finished. Standing still is unchanged.
1.0.2
- Fix: the queue is drained from the plugin's own update loop. 1.0.0 and 1.0.1 attached every patch to
Player.ToggleEquipped, so a queued switch was never applied. - Queue remembers whether the press meant equip or unequip, and drops it if the item leaves your inventory or the attack never ends (
QueueSeconds). - New:
InstantEquip(off) andDebugLogging(off).
1.0.1
- Fix: patch Player.ToggleEquipped (not Humanoid). Hotbar switches during attacks are queued again.
1.0.0
- Queue hotbar weapon changes during attacks; apply on next FixedUpdate after the swing ends.
- Optional queued hide (sheath) with instant or animated hide.