Rotamatic

Rotamatic is a lightweight, user-driven sequence builder for World of Warcraft: Midnight. Build ordered sequences from spells, items, and native WoW macros, assign them to a key, and advance them one physical key or mouse-button press at a time.

You decide which actions are included, how they are ordered, which target they use, and under which conditions they are available. Rotamatic does not press keys, repeat inputs, broadcast commands, or cast anything without player input. Every sequence step requires a new input; World of Warcraft's protected-action, macro, cooldown, resource, range, and global-cooldown rules remain in control.

Main features

• Visual sequence dashboard with drag-and-drop action ordering
• Spell, item, trinket, and native macro actions, including /castsequence
• Active sequence slots and reusable saved profiles
• Language-independent sequence and profile import/export
• Full-profile packages with validation and import previews
• Direct updates for saved profiles linked to an active sequence
• English and German interface text
• No required external libraries or companion addons

Targets, modifiers, and conditions

• Per-action targets: @target, @focus, @pet, @player, @cursor, @mouseover, and @party1
• Direct Shift, Ctrl, and Alt action lanes
• Multiple actions can share the same modifier and advance one press at a time
• @player targeting for native /castsequence macro actions selected through Rotamatic's Target field
• Tank-taunt protection for Warrior, Paladin, Death Knight, Druid, Monk, and Demon Hunter
• Direct tank taunts are kept on @target instead of being sent to @player
• A /castsequence containing a tank taunt does not receive an automatic @player target
• Known-spell and replacement-spell conditions
• Once-per-target actions for marks, debuffs, and similar effects
• Per-action Cast on Move, Cast on Stay, and Only in Air conditions
• Per-action disable switch and optional character-local action-toggle hotkey or macro

Important target limitation: WoW applies one target condition to a complete native /castsequence. A mixed sequence containing both a self-targeted spell and a hostile taunt should therefore be split into two Rotamatic actions: keep the self-targeted sequence on @player and place the taunt in its own action on @target.

Combat flow

• Stable ordered sequence flow
• Definitely unavailable actions can be skipped when WoW exposes safe readiness information
• Reset after confirmed successful casts
• Optional wait for the real global cooldown and Spell Queue Window
• Per-action Priority Retry with fair scheduling
• Optional per-action Action Pause
• Optional protection for casts, channels, and empower spells
• Optional enemy targeting and pet actions
• Optional action overlay
• Automatic safe reset after combat
• Protected or unavailable combat values fall back safely to WoW's normal secure cast attempt

Priority Retry and readiness checks only decide which configured action is prepared for the current player input. They never generate another input or cast automatically.

Sequence Manager

The built-in Sequence Manager keeps active sequences, saved profiles, and import/export tools in one place. You can:

• Create, rename, duplicate, reorder, and delete sequences
• Save an active sequence as a reusable profile
• Load saved profiles into specialization slots
• Update linked profiles directly from the open sequence
• Export or import one sequence
• Export or import all saved profiles as a portable package
• Preview new, changed, unchanged, and locally newer profiles before import
• Validate active sequences and saved profiles

Imported profile packages are stored in Saved Profiles first and do not silently replace active sequences.

Action Monitor and diagnostics

Rotamatic includes an optional Action Monitor for prepared actions, successful casts, channels, and empower events. Successful casts can be copied as language-independent Spell IDs or as a Rotamatic sequence import.

For support cases, the opt-in diagnostic mode records a limited local event log:

1. Run /ra diag start.
2. Reproduce the issue.
3. Run /ra diag stop.
4. Run /ra diag copy and copy the selected text.

The diagnostic buffer:

• Exists only in memory
• Is limited to the latest 400 entries
• Does not contain character or realm names
• Does not contain sequence names
• Does not contain internal action UUIDs
• Does not contain macro bodies

Always review diagnostic text before sharing it.

Quick start

1. Open Rotamatic with /ra or the minimap button.
2. Open General > Sequence Manager.
3. Create, import, or open a sequence.
4. Add spells, items, or macros and drag them into the desired order.
5. Right-click an action to configure its target, modifier, conditions, retry behavior, or channel protection.
6. Configure the sequence under Combat & Casting, Flow & Display, and Pet Automation.
7. Bind the sequence to a key.
8. Press the assigned key once for each sequence step.

Sequence and protected-button editing is intentionally disabled during combat because World of Warcraft locks protected action state while fighting.

Recommended WoW settings

• Enable Cast action keybinds on key down for responsive input, then reload the UI.
• Leave Press and Hold Casting disabled. Blizzard does not apply it consistently to all macros and items.
• Do not configure mouse or keyboard software to repeat, mirror, or broadcast inputs. Rotamatic is intended for manual input only.

Slash commands

• /ra or /rotamatic — Show or hide Rotamatic
• /ra manager — Open the Sequence Manager
• /ra import — Open sequence import
• /ra monitor — Open the Action Monitor
• /ra diag start — Start diagnostic capture
• /ra diag stop — Stop and freeze diagnostic capture
• /ra diag copy — Open diagnostics as selected text for copying
• /ra toggle <sequence> <action> — Command used by Rotamatic action-toggle macros
• /ra debug — Toggle developer debug logging
• /ra commands — Show the command list

Installation

CurseForge app

Install Rotamatic from the CurseForge app and make sure the selected game flavor is WoW Retail.

Manual installation

1. Close World of Warcraft.
2. Extract the Rotamatic folder into World of Warcraft/_retail_/Interface/AddOns.
3. Confirm that this file exists: Interface/AddOns/Rotamatic/Rotamatic_Mainline.toc.
4. Start World of Warcraft and enable Rotamatic in the AddOns list.
5. Open it with /ra.

When updating from an older manually installed Rotamatic build, delete only the old Interface/AddOns/Rotamatic folder before extracting the new version. Do not delete the WTF folder; sequences, profiles, settings, and keybind data are stored there.

Compatibility

• Game: World of Warcraft Retail
• Expansion: Midnight
• Interface: 12.0.7 (120007)
• Languages: English and German
• Dependencies: None
• Classic support: Not included in this build

Privacy and data handling

Rotamatic has no telemetry and does not connect to an external web service. It does not upload sequences, settings, diagnostics, or character data. Account-wide and character-specific settings are stored locally through WoW SavedVariables. Import, export, support reports, and diagnostics are shared only when the player manually copies their text.

Support

For help, bug reports, and shared sequences, join the community Discord:

https://discord.gg/szvv8hac2m

When reporting a problem, please include:

• Rotamatic version
• WoW version and locale
• A short description of what happened
• The built-in support report
• Diagnostic text from /ra diag, when relevant
• A BugSack error or screenshot if a Lua error appeared

Add-on policy and technical transparency

Rotamatic is built entirely as an in-client Lua UI addon. It uses WoW's secure action-button system for protected actions and respects combat lockdown. It does not include an executable program, input driver, key repeater, input broadcaster, web client, or Battle.net web-API integration.

Rotamatic is distributed free of charge. Its Lua source is readable in the addon package and is not obfuscated. The in-game addon contains no paid or premium features, advertisements, or donation requests. Protected action configuration is performed outside combat, while combat execution remains subject to Blizzard's secure UI restrictions.

The main WoW UI API surfaces used by this build are:

• Secure UI and input: CreateFrame, SecureActionButtonTemplate, SecureHandlerAttributeTemplate, SecureHandlerBaseTemplate, SecureHandlerMouseUpDownTemplate, secure frame attributes, SetOverrideBindingClick, ClearOverrideBindings, and InCombatLockdown

• Spells: C_Spell.GetSpellInfo, GetSpellName, GetSpellTexture, GetSpellCooldown, GetSpellCharges, GetSpellIDForSpellIdentifier, GetBaseSpell, GetOverrideSpell, IsSpellPassive, and IsSpellUsable

• Spellbook: C_SpellBook.GetNumSpellBookSkillLines, GetSpellBookSkillLineInfo, GetSpellBookItemInfo, GetSpellBookItemName, and GetOverrideSpell

• Items and action bars: C_Item.GetItemInfo, GetItemNameByID, GetItemIconByID, GetItemSpell, IsUsableItem, RequestLoadItemDataByID, C_Container.GetItemCooldown, and C_ActionBar.GetActionInfo

• Specializations: C_SpecializationInfo.GetSpecialization, GetSpecializationInfo, GetSpecializationInfoByID, and GetSpecializationInfoForClassID
• Addon, configuration, and timing: C_AddOns.GetAddOnMetadata, C_CVar.SetCVar, and C_Timer.After

• Native macros and bindings: WoW's macro information/creation functions, binding functions, and the native macro parser for /cast, /use, and /castsequence
• Player state and events: unit cast/channel state, combat lockdown and regeneration events, spellcast events, specialization and spellbook updates, movement/airborne state, macro updates, item-data events, and binding updates
• Local persistence: SavedVariables and SavedVariablesPerCharacter

These are client-provided UI APIs. Rotamatic does not bypass protected functions; if Blizzard marks a value or action as protected, unavailable, or restricted in combat, that restriction remains effective.

Policy, API, submission, and license sources

• Blizzard — World of Warcraft User Interface Add-On Development Policy: https://us.forums.blizzard.com/en/wow/t/ui-add-on-development-policy/24534
• Blizzard — Policy Update for Input Broadcasting Software: https://worldofwarcraft.blizzard.com/en-us/news/23558957/policy-update-for-input-broadcasting-software
• Blizzard — End User License Agreement: https://www.blizzard.com/legal/fba4d00f-c7e4-4883-b8b9-1b4500a402ea/blizzard-end-user-license-agreement
• WoW in-game API documentation: use /api in the World of Warcraft client
• Warcraft Wiki — World of Warcraft API reference and Blizzard API-documentation index: https://warcraft.wiki.gg/wiki/World_of_Warcraft_API
• Warcraft Wiki — SecureActionButtonTemplate reference: https://warcraft.wiki.gg/wiki/SecureActionButtonTemplate
• CurseForge — Creating and Submitting a Project: https://support.curseforge.com/support/solutions/articles/9000197241-creating-and-submitting-a-project
• Third-party library — rxi/json.lua v0.1.2, MIT License: https://github.com/rxi/json.lua and https://github.com/rxi/json.lua/blob/master/LICENSE

The bundled json.lua file retains its copyright and MIT permission notice. The remaining Rotamatic project is published under the license selected on its CurseForge project page.

Important: Blizzard does not individually pre-approve or certify third-party addons. The sources above document the public rules and client API used when Rotamatic was built. Blizzard may change, restrict, or disable addon functionality at any time, and its current policies and EULA always take precedence.

Rotamatic is an independent community addon and is not affiliated with, endorsed by, sponsored by, or approved by Blizzard Entertainment. World of Warcraft, Warcraft, and Blizzard Entertainment are trademarks or registered trademarks of Blizzard Entertainment, Inc.