⚔️ FastSwap

FastSwap makes changing weapons and putting them on your back smoother in Valheim. Switch weapons without being slowed to a walk, including while holding Shift to sprint. Normal equipment animations play; attacking can interrupt weapon drawing or switching.

🎮 Features

• Weapon animations preserved: weapons, bows, shields, torches and hand tools use the normal equip/unequip animation and timing. An attack can interrupt a hand-equipment switch and use the selected weapon.
• Switch while sprinting: hold your movement keys and Shift, then press a hotbar key. The keyboard fallback follows your configured hotbar bindings.
• Selective movement freedom: by default, removes Slow Walk only for sheathing/drawing, changing equipment (including armor), and consuming food or potions. Doors, harvesting and other interactions keep their normal slowdown.
• Attack cancel: attacking can interrupt drawing a weapon from your back or switching hand equipment. Armor and reload actions cannot be completed by this shortcut. Disable this feature with AllowAttackCancel.
• Sprint stamina cost: sheathing, drawing or changing hand equipment while running on the ground costs 12 stamina by default. If you lack the required stamina, sprinting stops.
• Normal equipment checks: switching still respects attacks, dodges, broken-item durability and DLC requirements. Water equipment checks are left to Valheim and installed mods, including Use Equipment in Water. Armor keeps its normal equip duration.

⌨️ Controls

Action	Default controls
Switch weapon	1–8 with a weapon in the corresponding hotbar slot
Switch during a sprint	Hold W/A/S/D + Shift, then press 1–8
Sheathe / draw weapon	R
Interrupt weapon drawing / switching	Press your attack button during the animation

Existing game key bindings are used; the mod does not add another hotkey.

⚙️ Configuration

Launch the game once to create BepInEx/config/com.skarif.fastswap.cfg.

Section / setting	Default	Effect
General / Enabled	true	Enable or disable the mod.
Balance / SprintStaminaCost	12	Stamina cost per hand-equipment action while sprinting on the ground. Set to 0 for no extra cost.
Features / AllowAttackCancel	true	Allow attacks or starting a bow draw to interrupt weapon drawing and switching animations.
Features / AllowWeaponSwitchWhileRunning	true	Allow weapon switching while sprinting. When false, tools such as the hammer, hoe, cultivator, serving tray and items with a build menu remain available as in vanilla.
Features / LimitSlowdownRemovalToEquipmentAndConsumables	true	Remove Slow Walk only for sheathing/drawing, equipment and consumables. false restores removal for all minor actions, including interactions.

Author: Skarif. Plugin GUID: com.skarif.fastswap. The display name remains Better Sheathing and Mobility. On first launch, settings are copied from the legacy com.author.bettersheathing.cfg if the new config does not already exist; the old file is preserved.

📥 Installation

1. Install BepInExPack Valheim.
2. Copy FastSwap.dll into Valheim/BepInEx/plugins/ (or the equivalent folder in your mod-manager profile).
3. Replace your previous FastSwap.dll; keep only one copy of this plugin installed.
4. Start the game. This is a client-side mod; install it on each player's client that should use its features.

When AllowWeaponSwitchWhileRunning = false, combat hand-equipment switches are blocked while sprinting, without queuing a switch or charging switch stamina. Tools keep vanilla switching and stamina behavior regardless of this setting. Switching while walking or standing and sheathing/drawing from the back remain available.

📝 Version 1.0.13

• Exempted tools and build-menu items from the sprint weapon-switch restriction and additional switch stamina cost.
• Removed FastSwap water checks that prevented equipment mods from applying their permissions in EquipItem.
• Preserved equipment animations, attack cancellation and sprint queue protection.

Version 1.0.10

• Fixed bows waiting for the unsheathing animation to finish before drawing an arrow. With AllowAttackCancel enabled, holding attack interrupts unsheathing and starts the normal bow draw without requiring a button release.
• Ammo checks, stamina costs, draw duration, and crossbow behavior remain unchanged.

Version 1.0.9

• Fixed sprinting cancelling queued weapon switches after equipment animations were restored.
• Sprinting now preserves hand-equipment equip/unequip actions when AllowWeaponSwitchWhileRunning is enabled. Normal animation timing and attack cancellation remain available.
• Jumping, dodging and attacks retain their normal action-queue cancellation.

Version 1.0.8

• Restored normal hand-equipment animations and timing; they are no longer skipped automatically.
• Attacks can interrupt weapon switching when AllowAttackCancel is enabled, including swaps between bows and melee weapons.
• Kept sprint switching and selective slowdown configuration.

Version 1.0.7

• Added configurable selective Slow Walk removal for equipment and consumables, enabled by default.
• Restored vanilla slowdown for doors, harvesting and other interactions in selective mode, including animation transitions.

Version 1.0.6

• Added the Features / AllowWeaponSwitchWhileRunning toggle (default: true).

Version 1.0.4

• Added instant switching between hand equipment, extending the existing sheathing mobility improvements.
• Added a fallback for missed configured hotbar key presses while holding Run or Shift.
• Applied the existing configurable sprint stamina cost to hand-equipment switching.

💬 Developer Contact & Support

• Discord: skarif_q
• Steam: Skarif_W
• Support development: Ko-fi

---

⚔️ FastSwap — Русский

FastSwap делает смену оружия и его убирание на спину удобнее в Valheim. Меняйте оружие без замедления до шага, в том числе во время бега с зажатым Shift. Стандартные анимации экипировки проигрываются; атака может прервать доставание или смену оружия.

🎮 Возможности

• Анимации оружия сохранены: оружие, луки, щиты, факелы и ручные инструменты используют стандартные анимации и время экипировки/снятия. Атака может прервать смену предмета в руках и использовать выбранное оружие.
• Смена на бегу: удерживайте клавиши движения и Shift, затем нажмите клавишу панели быстрого доступа. Дополнительная обработка ввода использует назначенные вами клавиши панели.
• Выборочная свобода движения: по умолчанию Slow Walk убирается только при убирании/доставании оружия, смене экипировки (включая броню) и употреблении еды или зелий. Двери, сбор растений и другие взаимодействия сохраняют стандартное замедление.
• Отмена атакой: атака может прервать доставание оружия со спины или смену предмета в руках. Этот механизм не позволяет мгновенно надевать броню или завершать перезарядку. Отключается параметром AllowAttackCancel.
• Расход выносливости на бегу: убирание, доставание и смена предметов в руках во время бега по земле по умолчанию расходуют 12 выносливости. Если её недостаточно, спринт прекращается.
• Проверки игры сохраняются: смена учитывает атаку, перекат, поломку предмета и требования DLC. Возможность экипировки в воде определяют Valheim и установленные моды, включая Use Equipment in Water. Время надевания брони остаётся стандартным.

⌨️ Управление

Действие	Клавиши по умолчанию
Сменить оружие	1–8, если в соответствующей ячейке панели лежит оружие
Сменить оружие на бегу	Удерживайте W/A/S/D + Shift и нажмите 1–8
Убрать / достать оружие	R
Прервать доставание / смену оружия	Нажмите кнопку атаки во время анимации

Мод использует назначения клавиш игры и не добавляет отдельную горячую клавишу.

⚙️ Настройки

После первого запуска появится файл BepInEx/config/com.skarif.fastswap.cfg.

Раздел / параметр	По умолчанию	Назначение
General / Enabled	true	Включить или отключить мод.
Balance / SprintStaminaCost	12	Расход выносливости за действие с предметом в руках на бегу по земле. Укажите 0, чтобы убрать дополнительный расход.
Features / AllowAttackCancel	true	Разрешить удару или началу натяжения лука прерывать анимации доставания и смены оружия.
Features / AllowWeaponSwitchWhileRunning	true	Разрешить смену оружия на бегу. При false молоток, мотыга, культиватор, поднос и другие инструменты с меню строительства остаются доступны по правилам игры.
Features / LimitSlowdownRemovalToEquipmentAndConsumables	true	Убирать Slow Walk только для убирания/доставания оружия, экипировки и еды/зелий. false возвращает снятие замедления со всех вспомогательных действий, включая взаимодействия.

Автор: Skarif. GUID плагина: com.skarif.fastswap. Отображаемое имя остаётся Better Sheathing and Mobility. При первом запуске настройки копируются из старого com.author.bettersheathing.cfg, если новый конфиг ещё не существует; старый файл сохраняется.

📥 Установка

1. Установите BepInExPack Valheim.
2. Скопируйте FastSwap.dll в Valheim/BepInEx/plugins/ или соответствующую папку профиля менеджера модов.
3. Замените предыдущий FastSwap.dll; должна быть установлена только одна копия плагина.
4. Запустите игру. Мод работает на клиенте; его устанавливают игроки, которым нужны эти возможности.

При AllowWeaponSwitchWhileRunning = false смена боевых предметов в руках на бегу блокируется: запрос не ставится в очередь и не расходует выносливость за смену. Инструменты сохраняют стандартное поведение смены и расхода выносливости независимо от настройки. Смена стоя или шагом, а также убирание и доставание со спины остаются доступны.

📝 Версия 1.0.13

• Инструменты и предметы с меню строительства исключены из ограничения смены оружия на бегу и дополнительного расхода выносливости за смену.
• Убраны водные проверки FastSwap, мешавшие другим модам применять разрешения в EquipItem.
• Сохранены анимации экипировки, прерывание атакой и защита очереди смены на бегу.

Версия 1.0.10

• Исправлено ожидание конца анимации доставания перед натяжением лука. При включённом AllowAttackCancel удержание атаки прерывает доставание и запускает обычное натяжение без необходимости отпускать кнопку.
• Проверки стрел, расход выносливости, длительность натяжения и поведение арбалетов не изменены.

Версия 1.0.9

• Исправлена отмена смены оружия спринтом после восстановления анимаций экипировки.
• При включённом AllowWeaponSwitchWhileRunning бег сохраняет очередь смены предметов в руках. Стандартное время анимации и прерывание ударом сохранены.
• Прыжки, перекаты и атаки сохраняют обычную отмену очереди действий.

Версия 1.0.8

• Восстановлены стандартные анимации и время смены предметов в руках: они больше не пропускаются автоматически.
• При включённом AllowAttackCancel удар прерывает смену оружия, включая переходы между луком и оружием ближнего боя.
• Сохранены настройки смены на бегу и выборочного снятия замедления.

Версия 1.0.7

• Добавлено настраиваемое выборочное снятие Slow Walk для экипировки и еды/зелий, включённое по умолчанию.
• В выборочном режиме восстановлено замедление для дверей, сбора растений и других взаимодействий, включая переходы анимаций.

Версия 1.0.6

• Добавлен переключатель Features / AllowWeaponSwitchWhileRunning (по умолчанию true).

Версия 1.0.4

• Мгновенная смена предметов в руках дополняет существующие улучшения убирания и доставания оружия.
• Добавлена обработка пропущенных нажатий назначенных клавиш панели при зажатом беге или Shift.
• Существующий настраиваемый расход выносливости на бегу распространён на смену предметов в руках.

💬 Контакты и поддержка разработчика

• Discord: skarif_q
• Steam: Skarif_W
• Поддержать разработку: Ko-fi