AutoAttack

Press a key to start continuous attacking — the mod keeps the attack button held for you — and press it again to stop. No more holding the attack button through long fights.

Client-side only: neither the server nor other players need the mod.

Features

• Toggle on/off with a keyboard shortcut (default Mouse1 + LeftAlt) or a gamepad combo (default JoyLBumper, JoyRBumper = L1 + R1).
• Pause: holding a configured button (block, jump, secondary attack, movement by default) temporarily pauses the toggle; it resumes automatically when you release it.
• Cancel: pressing a configured button stops the toggle completely.
• Weapon change protection: automatically cancels when the equipped weapon changes (can be disabled).
• Bows: keeps drawing and releases the shot automatically once fully drawn.
• Crossbows: waits for the reload instead of holding through it.
• On-screen messages for on/off/cancelled, with configurable texts (empty text = hidden) and position.
• Per-button configuration: every input button the game registers gets its own on/off entry, split into keyboard and gamepad sections and generated from the game's own input registry at startup.
• Master switch ([General] Enabled) to turn the mod fully off and get vanilla behavior.

Installation

Using a mod manager (recommended)

Install via NexusMods r2modman, Gale or the Thunderstore Mod Manager. BepInExPack is installed automatically as a dependency.

Manual

1. Install BepInExPack for Valheim.
2. Drop AutoAttack.dll into <Valheim>/BepInEx/plugins/.

Configuration

Config file: BepInEx/config/orax.AutoAttack.cfg — every entry is documented inline.

• [General] > Master switch, cancel-on-weapon-change
• [Keyboard] > Toggle shortcut (Unity KeyCode names, e.g. Mouse1 + LeftAlt)
• [Gamepad] > Toggle combo (ZInput button names, e.g. JoyLBumper, JoyRBumper)
• [Keyboard cancel buttons] > [Gamepad cancel buttons] > Press to cancel the toggle
• [Keyboard pause buttons] > [Gamepad pause buttons] > Hold to pause the toggle
• [HUD], [Messages] > Message display, position and texts

Notes:

• The gamepad button list is generated at startup from the game's own input registry and reflects the controller layout active at that moment; restart the game after changing the layout to regenerate it.
• Unknown button names simply never trigger, and a warning is logged once.

Misc

Source code: GitHub repository

Changelog

All notable changes to AutoAttack are listed here, newest first. Generated from the git history by scripts/changelog.ps1 - do not edit manually.

[0.1.0] - 2026-10-02

Added

• generate Package/CHANGELOG.md from the git history (27fc1be)
• create the GitHub release as a draft and open it in the browser (e0975b8)
• create a GitHub release when building the Release configuration (7b9e4d8)
• document all bindable keys in config descriptions (c718b57)
• create translation (ee4133c)
• use reflection to create config (8cc8ed4)
• add cancel/pause attack (6acffd7)

Changed

• rename the mod to AutoAttack (GUID orax.AutoAttack) (6b12722)

Fixed

• update the README references after the move to the root (cbeb8b1)
• open the releases list page in the browser instead of the tag URL (79eede2)
• drop the Full Changelog line from the generated release notes (e9f56f8)
• fix bows (9e65dd2)
• fix change weapon (afdeebe)
• Jump fix (5e42171)
• add justToggled (cba4c53)
• fix translation (32b9b78)

Other

• use a generic namespace example and UI setup hints in configuration errors (95e0e0f)
• document GitHub Secrets and variables setup in workflow header (3fd02eb)
• shorten the mod description (66fc0e4)
• publish to thunderstore.io for real (drop dev mode, use category slug mods) (e25e946)
• test publish on thunderstore.dev (temporary dev mode, riskofrain2 community) (b1f7535)
• use GreenTF/upload-thunderstore-package action instead of custom tcli (acec592)
• discover the package manifest instead of hardcoding its path (8207dbd)
• publish the release zip to Thunderstore (31101c7)
• format the source link as a Markdown link (4a9c716)
• keep a single README at the repository root (b2841c2)
• rename Nexus variables to NEXUSMODS_* (b129aa1)
• upload published releases to Nexus Mods (77a3323)
• finalize the mod icon (256x256) (f31dced)
• prepare the Thunderstore package (b970143)
• add JoyStick (5adc7ad)
• README.md + manifest.json (fb3ad3b)
• README.md (bd5e3d5)
• format (9c1a139)
• update project (5a5023a)
• remove Attack from Pause buttons (ae025e4)
• format (de62c2c)
• add DEV.md (024239b)
• add defaultValues (16edbe4)
• init (c038bb0)