You are viewing a potentially older version of this package. View all versions.
cjayride-WeaponSwitchQueue-1.0.5 icon

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-5.4.2360 icon
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.2360

README

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.dll dated 2026-10-28; Player.ToggleEquipped / HideHandItems still 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) and DebugLogging (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.