Skip to content

About

No description, website, or topics provided.

Resources

Stars

173 stars

Watchers

37 watching

Forks

Repository files navigation

BadRotations

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.

Game versions

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.

Installing

  1. Download BR with the green Code → Download ZIP button above (or clone it with git) and name the folder exactly BadRotations. A ZIP extracts as BadRotations-master, so rename it.
  2. Icons and fonts: copy the Media folder from 3rd Party Files into your game's Interface\AddOns folder, so you have World of Warcraft\<game version>\Interface\AddOns\Media. WoW only loads images and fonts from its own Interface folder. Without this step BR's windows have no icons and use the game's default font. When an update changes the Media folder, copy it again.
  3. Set up your unlocker to load BR: Setting up BR with your unlocker has the steps for each one BR supports.
  4. 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.

Using BR

  • 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: /br turns BR on or off, and /br help lists the rest. Some useful ones:

    Command What it does
    /br why <spell> Says why BR last refused to cast a spell
    /br target Shows which enemy BR is focusing on and why
    /br log Shows BR's recent chat lines in a window you can copy from
    /br pause toggle Pauses or resumes BR

Common problems

  • BR doesn't load at all: check the folder is called exactly BadRotations (not BadRotations-master) and is where your unlocker expects it.
  • No icons, or the game's default font in BR's windows: copy the Media folder (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.

Reporting problems

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.

Writing a profile

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.

Pull requests are welcome.

Profiles

Generated from each profile's registerRotation table whenever a profile changes. Starter profiles cover the levels before you pick a specialization.

Retail

ClassSpecRotationAuthorLast updated
Death KnightBloodCuteOneCuteOne2026-10-29
StarterInitialCuteOne2026-10-29
Demon HunterHavocCuteOneCuteOne2026-10-29
VengeanceCuteOneCuteOne2026-10-31
StarterInitialCuteOne2026-10-29
DruidFeralCuteOneCuteOne2026-11-12
StarterInitial DruidCuteOne2026-11-12
EvokerDevastationCuteOneCuteOne2026-11-01
StarterInitialCuteOne2026-11-01
HunterMarksmanshipCuteOneCuteOne2026-10-29
StarterInitialCuteOne2026-10-29
PaladinRetributionCuteOneCuteOne2026-11-01
StarterInitialCuteOne2026-11-01
PriestStarterInitialCuteOne2026-11-01
RogueStarterInitialCuteOne2026-10-29
WarlockStarterInitialCuteOne2026-10-29
WarriorFuryCuteOneCuteOne2026-10-29

Mists of Pandaria Classic

ClassSpecRotationAuthorLast updated
Death KnightFrostCuteOneCuteOne2026-10-29
DruidFeralCuteOneCuteOne2026-11-01
StarterInitial DruidCuteOne2026-11-01
MageStarterInitialCuteOne2026-10-29
MonkWindWalkerCuteOneCuteOne2026-10-29
StarterInitialCuteOne2026-10-29
PaladinRetributionCuteOneCuteOne2026-11-01
StarterInitialCuteOne2026-10-29
RogueSubtletyCuteOneCuteOne2026-10-31
ShamanEnhancementCuteOneCuteOne2026-11-01
StarterInitialCuteOne2026-11-01
WarriorArmsCuteOneCuteOne2026-10-29
StarterInitialCuteOne2026-10-29

Burning Crusade Classic

ClassRotationAuthorLast updated
DruidCuteOneCuteOne2026-11-12
ClaudeClaude2026-11-01
HunterCuteOneCuteOne2026-10-29
ShamanEarthcallerEarthcaller2026-11-11
CuteOneCuteOne2026-11-01

Classic Era

ClassRotationAuthorLast updated
DruidCuteOneCuteOne2026-11-12
HunterCuteOneCuteOne2026-10-29

World of Warcraft Forever

ClassRotationAuthorLast updated
DruidCuteOneCuteOne2026-11-15

License

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.

About

No description, website, or topics provided.

Resources

Stars

173 stars

Watchers

37 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages