Action Combat Mode brings modern action-game controls to World of Warcraft, replacing traditional tab-targeting with intuitive aiming, more engaging controls, and immersive combat.
Grab it on CurseForge or Wago Addons.
After installing the AddOn, you'll be greeted by this message. Click Okay to proceed and follow the Setup Wizard.
You can report bugs, request features and provide feedback over on our Discord.
Action Combat Mode is organized by domain. Runtime lives under CombatMode/Core/; settings under CombatMode/UI/; static tables under CombatMode/Constants/.
| Domain | Owns |
|---|---|
| Runtime | AddOn shell, events, CVars, binding queue, bootstrap (Core/Runtime/) |
| FreeLook | Mouse look / mouselook state + auto cursor unlock |
| Crosshair | Reticle, Assist HUD (next-cast suggestion and interactable indicator), Target Lock focus marker, cast animations |
| ClickCasting | Mouse override bindings + targeting macro builder |
| AllyCycle | Party/raid ally cycling + Ally HUD (secure UP/DOWN, help/harm macros) |
| Options toolkit | Standalone options window + editors (UI/Options/, UI/Editors/) |
Load order and public entry points: STRUCTURE.md. Agent/contributor rules: CLAUDE.md.
You can submit a PR with your contributions to Action Combat Mode's repository on GitHub.
- Clone and install the addon into your Retail
Interface/AddOnsfolder for local testing. - Skim the architecture table above, then STRUCTURE.md for load order.
- Follow CONTRIBUTING.md — especially the first-hour path (change a toggle, add a constant, secret-value rules).
- Run a focused manual pass from TESTING.md for your changed features.
- Open a PR and complete
.github/PULL_REQUEST_TEMPLATE.md. Use RELEASE.md when shipping a version.
- Install StyLua and Selene.
- Script index helper:
pwsh ./scripts/help.ps1 - Setup sanity helper:
pwsh ./scripts/dev-check.ps1 - Default changed-files helper:
pwsh ./scripts/lint-changed.ps1 - Default local gate (changed files):
pre-commit run --files <changed files> - Tool-specific debug checks:
stylua --check <paths>,selene --config selene.toml <paths> - Install pre-commit hooks (recommended):
pip install pre-commitpre-commit install- Release prep / full sweep only:
pre-commit run --all-files