Rotation Trainer - World of Warcraft Addon (WoW 12.1.0+ & TWW 11.x)

Rotation Trainer is an advanced, modern World of Warcraft addon (compatible with WoW 12.1.0+ / Interface 120100 and The War Within 11.x+), created by Sidagel. The addon is designed for learning, verifying, and evaluating combat rotation execution in real time across all specs (PvE / PvP / Leveling).

Supports 4 languages (Polish, English, German, and French) with a sleek dark UI, custom rotation creator, live priority condition tracking, encounter grading, and combat history analytics.

📖 Addon User Guide

1. Startup and UI Controls

After logging into the game, the addon loads automatically. You can open or close the main interface at any time using:

• In-game chat command /rot or /rotation.
• The addon options button in WoW Settings.
• Command /rot reset to reset current session statistics and grades.

2. Main Interface Overview

• Header Control Bar:

  • [L] / [U]: Lock / Unlock window screen position (drag window with mouse when unlocked [U]).
  • PL / EN / DE / FR: Quick UI language toggle button without restarting the game.
  • History: Opens the Combat & Rotation History window.
  • + Custom: Opens the Custom Rotation Creator window.
  • [Active] / [All]: Filter rotation list – show rotations for current spec only or all available.
  • 70% [-] [+]: UI scale adjustment bar (from 50% to 150%).
  • Reset: Resets session combat statistics and performance grade.

• Stats & Performance Grade Banner:

  • Accuracy %: Real-time percentage accuracy of casted spells in current session.
  • Correct / Mistakes / Completed: Counter for valid spell casts, mistakes, and finished full rotation cycles.
  • Encounter Grade: Real-time performance rank shown on the right:
    • S+ (100% - Flawless Execution)
    • S (>= 95% - Masterful)
    • A (>= 85% - Great)
    • B (>= 75% - Good)
    • C (>= 60% - Average)
    • D (>= 45% - Poor Performance)
    • F (< 45% - Critical Mistakes)

• Active Build Banner:

  • Displays the currently tracked rotation build and its source (Wowhead, Icy-Veins, SimC APL, Archon, or Custom).

• Rotation List & Spell Icons:

  • Each rotation row features Enable / Disable buttons to toggle active rotations.
  • Custom rotations include a Delete button to remove them from the database.

3. Creating Custom Rotations & Conditions (+ Custom)

Includes an in-game editor for creating custom rotation sequences with step-by-step priority conditions (buffs, debuffs, cooldowns, notes).

1. Click + Custom in the header.
2. Enter your custom rotation title in Rotation Name (e.g., My BM Hunter Rotation).
3. Adding Spells: Click spell icons in the Available Spells grid at the bottom to add them to your sequence.
4. Configuring Step Conditions:
   • Left-click a spell icon in your sequence to select it for condition editing.
   • Required Buff: Enter a spell name or buff ID (e.g. Bestial Wrath or 19574) that must be active on your player for this step to be recommended.
   • Target Debuff: Enter a target debuff name or ID (e.g. Barbed Shot).
   • Require CD Ready: Check the box if this spell should only be recommended when its cooldown is ready (0s).
   • Description / Note: Enter custom text that will appear in live combat tooltips.
5. Removing Steps: Right-click any spell icon in your sequence to remove it.
6. Click Save & Enable to save your custom build.

4. Viewing Combat History (History)

Automatically logs each combat encounter in SavedVariables (stores up to 30 past encounters).

1. Click History in the header.
2. View detailed encounter cards featuring:
   • Date & time of the encounter.
   • Player class and specialization.
   • Encounter duration (MM:SS).
   • Final grade achieved (e.g. S+, A).
   • Count of correct casts and mistakes.
   • Rotations used during combat with [COMPLETED!] or [IN PROGRESS] status tags.
3. Click Clear History to reset saved history logs.

5. In-Combat Mechanics & Reset Rules

• Auto Attack Filter: Auto Attack (Auto Attack / Auto Shot) is automatically excluded from mistake counters and rotation evaluations.
• Green Checkmarks: Completed spell steps display a clear green checkmark indicator.
• Post-Combat Auto-Reset: Checkmarks remain visible for 10 seconds post-combat for review, after which they automatically reset. Entering a new combat resets checkmarks immediately.
• Partial Encounter Completion: If combat ends while a rotation is in progress and at least 1 step was completed, it counts as a completed rotation.

🌟 Technical Features & Architecture

• WoW 12.1.0+ Compatibility (Interface: 120100): Fully compliant with current and upcoming WoW client builds.
• Lua Taint & Secret Value Protection: Safe pcall evaluation for C_Spell.GetSpellCooldown protects against Blizzard secret number Taint errors.
• Pure Lua UI (Zero XML Dependencies): Built using BackdropTemplate and object pooling (iconPool, rowPool).
• Clean ASCII Font Rendering: All UI text utilizes clean formatting compatible with default WoW client font engines.

📦 Build & Packaging Scripts

Includes 2 automated PowerShell and batch scripts in the root directory:

1. update_rotations.bat / update_rotations.ps1

Syncs current project files directly to your WoW client AddOns directory (E:\Games\World of Warcraft\_retail_\Interface\AddOns\Rotation). Type /reload in game after running.

2. package.bat / package.ps1

Generates a clean distribution archive in package/Rotation.zip and deploys it to your game folder.

💻 Slash Commands

👤 Author & License

• Author: Sidagel
• API Target: WoW 12.1.0+ / Interface 120100 / TWW 11.x
• License: MIT. Free for personal use, modification, and redistribution.