Decursive 12.1 Compatibility Patch

Description

Decursive 12.1 Compatibility Patch is a compatibility-focused modification of the original Decursive addon for World of Warcraft 12.1.

The project is intended to preserve the familiar Decursive experience while adapting the addon to Blizzard's newer protected and secret aura API behavior.

The goal is not to redesign Decursive.

The goal is to keep the original addon working as closely as possible to the way long-time Decursive users expect, while replacing only the portions of the addon that are no longer compatible with World of Warcraft 12.1.

This compatibility build preserves the original Decursive interface and workflow, including:

• Original Decursive configuration interface
• Micro Unit Frames (MUFs)
• Mouse-button curing
• Curing options
• Priority List
• Skip List
• MUF colors and display settings
• Party and raid support
• Secure curing macros
• Custom spell support
• Existing Decursive profiles and configuration behavior where possible

It also adds several new compatibility and quality-of-life features for modern World of Warcraft.

---

WoW 12.1 Compatibility

World of Warcraft 12.1 changed how addons are allowed to access aura and debuff information.

Some aura information can now be protected or secret. Older Decursive code paths that directly inspected these values could produce Lua errors or stop functioning when those restrictions were active.

This compatibility patch replaces those incompatible detection paths with Blizzard-managed aura handling.

The primary managed aura filter used by the compatibility layer is:

HARMFUL|RAID_PLAYER_DISPELLABLE

This allows Blizzard to determine whether a harmful aura is dispellable by the player without Decursive directly inspecting protected aura information.

The result is that the familiar Decursive Micro Unit Frames can continue to provide curing indicators while respecting Blizzard's current addon restrictions.

---

Features

Original Decursive Experience

• Original Micro Unit Frames
• Original curing interface
• Original mouse-button curing system
• Original Priority List
• Original Skip List
• Original colors and appearance controls
• Original party and raid handling
• Original secure mouse-click curing behavior

WoW 12.1 Aura Compatibility

• Blizzard-managed dispellable aura detection
• Protection against secret aura values
• Protection against protected UNIT_AURA event data
• Avoids direct Lua inspection of restricted aura information
• Keeps the WoW 12.1 compatibility layer isolated from the original Decursive code wherever practical

Automatic Dispel Spell Detection

The addon automatically determines which friendly curing spell Decursive is currently configured to use.

The tracked curing spell is refreshed when:

• Your specialization changes
• Your talents change
• Your spellbook changes
• Decursive rebuilds its curing spell configuration
• A different curing ability becomes the preferred option

The resolver can account for curing abilities that remove:

• Magic
• Poison
• Disease
• Curse
• Bleed, where supported

Offensive dispels such as Purge-style enemy removal abilities are excluded from cooldown tracking.

Cooldown Overlay

The addon can display the cooldown of the currently tracked curing ability directly on the Micro Unit Frames.

The cooldown display includes:

• Faded black overlay
• Numeric countdown timer
• Adjustable overlay darkness
• Option to hide or show the countdown number
• Option to completely enable or disable the cooldown overlay

The cooldown display intentionally does not use:

• Radial cooldown animation
• Edge animation
• Cooldown bling

This keeps the display simple and easy to read.

MUF Sizing

Additional Micro Unit Frame sizing controls are available directly through the Decursive options.

The MUF square size can be adjusted from approximately:

10 px - 80 px

A reset option is also provided to quickly return the MUFs to their default size.

12.1 Status and Testing

A dedicated World of Warcraft 12.1 status section is included to make troubleshooting easier.

The status information can display:

• Current class
• Current specialization
• Detected friendly curing spell
• Managed aura backend
• Number of active MUFs
• Number of managed aura containers
• Cooldown overlay status
• Cooldown countdown-number status
• Cooldown overlay darkness
• Combat-lockdown state

A Refresh detected dispel option is also available.

The addon also provides:

/dcrstatus

for a compact compatibility status report in chat.

Test MUF Visuals

A MUF visual test option is included so appearance settings can be previewed without waiting for a real dispellable debuff.

The visual test can preview:

• Dispelling highlight/border
• Cooldown overlay
• Cooldown countdown styling

The test mode does not cast a spell and does not inspect protected aura information.

---

Opening Decursive

Use:

/decursive

This opens the original Decursive configuration interface.

From here you can configure:

• Micro Unit Frames
• Mouse bindings
• Curing options
• Priority List
• Skip List
• Colors
• Display options
• Cooldown overlay
• MUF size
• Custom spells
• WoW 12.1 compatibility/status options

---

How to Use Decursive

Decursive displays small squares called Micro Unit Frames, or MUFs.

Each square represents a member of your party or raid.

When Blizzard determines that a player has an effect your character can remove, that player's square indicates that the player can be cured.

Simply click the player's square using your configured Decursive mouse button.

You do not need to manually target the player first.

---

Mouse Button Curing

Decursive uses secure mouse bindings to cast curing spells directly on party or raid members.

Mouse bindings can be configured under:

Custom Spells → Mouse Bindings

Depending on your configuration, Decursive can use combinations such as:

• Left Click
• Right Click
• Middle Click
• Modifier + Mouse Button

The original Decursive secure mouse-binding system is preserved.

---

Curing Options

Open:

Decursive Options → Curing Options

Decursive automatically detects which friendly curing abilities are available to your current character.

Depending on your class, specialization, and talents, this can include removal of:

• Magic
• Poison
• Disease
• Curse

Decursive uses its existing curing system to determine which spell should be used.

---

Cooldown Overlay Settings

Open:

Decursive Options → Micro Unit Frame Settings → Display Options

From here you can configure the dispel cooldown overlay, including:

• Enable or disable the cooldown overlay
• Show or hide the cooldown countdown number
• Adjust cooldown overlay darkness

The settings are saved with your Decursive configuration.

---

Changing MUF Size

Open:

Decursive Options → Micro Unit Frame Settings → Display Options

Use:

MUF square size (pixels)

The patched version supports MUF sizes from approximately:

10 px - 80 px

You can also use:

Reset MUF size

to restore the default Decursive square size.

The original percentage-based MUF Scale setting remains available.

---

Party and Raid Support

Decursive automatically adjusts to your current group.

It supports:

• Solo play
• Parties
• Raids

When you join a raid, the Micro Unit Frames expand to represent raid members according to your existing Decursive configuration.

The original Priority List, Skip List, MUF arrangement, mouse bindings, colors, and display settings remain available.

---

Known WoW 12.1 Limitations

Because Blizzard now protects some aura information, certain original Decursive features that depended on directly inspecting debuff data may behave differently than they did in older versions of World of Warcraft.

This can affect features that require:

• Exact debuff names
• Exact debuff types when protected
• Per-affliction filtering
• Some Live List behavior
• Some aura timer or chronometer behavior
• Alerts that require direct access to protected aura details

The project will continue to favor Blizzard-supported managed APIs rather than attempting to bypass or circumvent protected aura restrictions.

---

License, Attribution, and Original Project

Important GPLv3 Attribution

This project is a compatibility modification of the original Decursive addon. It is not a claim of authorship over the original Decursive project.

The original Decursive addon is authored and maintained by Archarodim.

The current Decursive project is distributed under the GNU General Public License version 3 (GPLv3).

This compatibility modification retains the GPLv3 licensing requirements of the original project.

The original project's copyright notices, license information, and attribution should be preserved in redistributed versions of this compatibility patch.

Anyone redistributing or modifying this project should also comply with the terms of the GNU General Public License version 3.

For clarity, this project should include a prominent README attribution section and/or an AUTHORS.md file identifying:

• Original project: Decursive
• Original author/maintainer: Archarodim
• License: GNU General Public License version 3 (GPLv3)
• Modification: World of Warcraft 12.1 compatibility patch and related quality-of-life additions

The original Decursive CurseForge project currently identifies the addon as licensed under GNU GPLv3.

---

Project Goal

The goal of this compatibility patch is not to replace Decursive or take ownership of the original project.

It is to preserve the original Decursive experience on modern World of Warcraft versions while adapting incompatible portions of the addon to Blizzard's current API restrictions.

Classic Decursive behavior, updated for World of Warcraft 12.1.