BadRotations (BR) is a free, open-source combat rotation addon for World of Warcraft. It reads the fight around you (enemies, your group's health, your cooldowns and resources) and casts your class's rotation for you. Movement stays with you: BR never moves or turns your character on its own.
BR needs a Lua unlocker to run. Setting up BR with your unlocker explains how, step by step.
BR is not tied to one version of WoW. Each client gets a thin layer under Expansions/ with its spell
lists and game rules. Adding a version means adding that layer, not changing BR itself. Profiles are
written for one game version, and BR offers only the profiles made for the client you are playing.
The profile list below shows which game versions currently have profiles.
- Download BR with the green Code → Download ZIP button above (or clone it with git) and name the
folder exactly
BadRotations. A ZIP extracts asBadRotations-master, so rename it. - Icons and fonts: copy the
Mediafolder from3rd Party Filesinto your game'sInterface\AddOnsfolder, so you haveWorld of Warcraft\<game version>\Interface\AddOns\Media. WoW only loads images and fonts from its ownInterfacefolder. Without this step BR's windows have no icons and use the game's default font. When an update changes theMediafolder, copy it again. - Set up your unlocker to load BR: Setting up BR with your unlocker has the steps for each one BR supports.
- Log in. The BR button appears on your minimap.
Updating: pull with git, or extract the new ZIP over your BadRotations folder. Don't delete the
folder to install a fresh copy: your settings (Settings/) and logs (Logs/) are inside it.
-
Minimap button: left-click opens Bot Options, right-click the profile window (choose the rotation, Base Options, Rotation Options). Shift+left-click shows or hides the toggle bar. Alt+Shift drags the button.
-
Toggle bar: buttons for the things you switch often in play: on/off, AoE, cooldowns, defensives, interrupts and whatever else the profile adds. Hover over a button to see what each state does.
-
Options: Bot Options (BR itself, per character), Base Options (shared features such as racials, trinkets and healthstones, per character and spec) and the profile's own Rotation Options. Settings are saved under
Settings/, separately for each game version. -
Chat commands:
/brturns BR on or off, and/br helplists the rest. Some useful ones:Command What it does /br why <spell>Says why BR last refused to cast a spell /br targetShows which enemy BR is focusing on and why /br logShows BR's recent chat lines in a window you can copy from /br pause togglePauses or resumes BR
- BR doesn't load at all: check the folder is called exactly
BadRotations(notBadRotations-master) and is where your unlocker expects it. - No icons, or the game's default font in BR's windows: copy the
Mediafolder (Installing, step 2). - "no rotation for spec ... on ..." in chat: there's no profile for your spec on this game version yet. The profile list shows what there is.
- A spell is never cast:
/br why <spell>says why BR last refused it. - Lua errors: they're in
BadRotations/Logs/Errors.log. Report them as below.
Open an issue or ask on
Discord. Say what went wrong and roughly when, and attach Session.log and
Errors.log from BadRotations/Logs/ (or zip the whole folder). The logs usually show the cause without
you having to make it happen again.
BR writes what it does to these plain text files while you play. Nothing is ever sent anywhere. The files stay on your computer until you choose to share them, and other players' names in them are replaced. You can switch them off under Bot Options → Debug Options → Write Log Files. Logs/README.md explains each file.
A profile is one Lua file in Rotations/<Class>/<Spec>/. It registers itself, so dropping a new file in is
enough for BR to find it. No coding experience is needed to start.
- Writing a profile walks through it step by step, from the little Lua you need to trying it in game.
- Start from
Rotations/sample rotation.lua. - The profile API is documented at https://cuteone.github.io/BadRotations/, generated from the
System/APIsource. Types/gives editors that use the Lua language server (such as VS Code with sumneko Lua) completion for the whole profile API.- AGENTS.md describes how BR is put together and the conventions profiles follow.
Pull requests are welcome.
Generated from each profile's registerRotation table whenever a profile changes. Starter profiles cover
the levels before you pick a specialization.
| Class | Spec | Rotation | Author | Last updated |
|---|---|---|---|---|
| Death Knight | Blood | CuteOne | CuteOne | 2026-10-29 |
| Starter | Initial | CuteOne | 2026-10-29 | |
| Demon Hunter | Havoc | CuteOne | CuteOne | 2026-10-29 |
| Vengeance | CuteOne | CuteOne | 2026-10-31 | |
| Starter | Initial | CuteOne | 2026-10-29 | |
| Druid | Feral | CuteOne | CuteOne | 2026-11-12 |
| Starter | Initial Druid | CuteOne | 2026-11-12 | |
| Evoker | Devastation | CuteOne | CuteOne | 2026-11-01 |
| Starter | Initial | CuteOne | 2026-11-01 | |
| Hunter | Marksmanship | CuteOne | CuteOne | 2026-10-29 |
| Starter | Initial | CuteOne | 2026-10-29 | |
| Paladin | Retribution | CuteOne | CuteOne | 2026-11-01 |
| Starter | Initial | CuteOne | 2026-11-01 | |
| Priest | Starter | Initial | CuteOne | 2026-11-01 |
| Rogue | Starter | Initial | CuteOne | 2026-10-29 |
| Warlock | Starter | Initial | CuteOne | 2026-10-29 |
| Warrior | Fury | CuteOne | CuteOne | 2026-10-29 |
| Class | Spec | Rotation | Author | Last updated |
|---|---|---|---|---|
| Death Knight | Frost | CuteOne | CuteOne | 2026-10-29 |
| Druid | Feral | CuteOne | CuteOne | 2026-11-01 |
| Starter | Initial Druid | CuteOne | 2026-11-01 | |
| Mage | Starter | Initial | CuteOne | 2026-10-29 |
| Monk | WindWalker | CuteOne | CuteOne | 2026-10-29 |
| Starter | Initial | CuteOne | 2026-10-29 | |
| Paladin | Retribution | CuteOne | CuteOne | 2026-11-01 |
| Starter | Initial | CuteOne | 2026-10-29 | |
| Rogue | Subtlety | CuteOne | CuteOne | 2026-10-31 |
| Shaman | Enhancement | CuteOne | CuteOne | 2026-11-01 |
| Starter | Initial | CuteOne | 2026-11-01 | |
| Warrior | Arms | CuteOne | CuteOne | 2026-10-29 |
| Starter | Initial | CuteOne | 2026-10-29 |
| Class | Rotation | Author | Last updated |
|---|---|---|---|
| Druid | CuteOne | CuteOne | 2026-11-12 |
| Claude | Claude | 2026-11-01 | |
| Hunter | CuteOne | CuteOne | 2026-10-29 |
| Shaman | Earthcaller | Earthcaller | 2026-11-11 |
| CuteOne | CuteOne | 2026-11-01 |
| Class | Rotation | Author | Last updated |
|---|---|---|---|
| Druid | CuteOne | CuteOne | 2026-11-12 |
| Hunter | CuteOne | CuteOne | 2026-10-29 |
| Class | Rotation | Author | Last updated |
|---|---|---|---|
| Druid | CuteOne | CuteOne | 2026-11-15 |
BadRotations is maintained by CuteOne, with contributions from everyone in the commit history. It is released under the GNU General Public License v3.0. If you build on it, please credit BadRotations and link back to this repository.