Curse Surge Alert v1.7.0
========================

A lightweight World of Warcraft: Midnight 12.1 addon for the rotating Curse
Surges on The Coiled Isle.

Features
--------
- Small movable countdown box for the next Curse Surge.
- Display the box on The Coiled Isle only, throughout Midnight zones, or in all zones.
- Lock/Unlock button prevents or allows dragging.
- Shows clickable event coordinates.
- Clicking the coordinates creates a TomTom waypoint when TomTom is enabled.
- Select a warning at 5 minutes, 2 minutes or 1 minute before the Surge begins.
- Select either the bundled "You Are Cursed" voice clip or WoW's Raid Warning.
- Select the playback channel: Master, Sound Effects, Music, Ambience or Dialog.
- Dedicated Test button plays the current sound through the current channel.
- Pause Next suppresses only the upcoming Surge reminder.
- The next later Surge automatically returns to normal alerting.
- Position, visibility, display scope, lock state, warning time, sound choice, channel and alert state are saved.
- Uses Blizzard's Event Scheduler and retries if POI details arrive late.

Install
-------
1. Exit World of Warcraft completely.
2. Extract the CurseSurgeAlert folder into:
   World of Warcraft\_retail_\Interface\AddOns\
3. Start WoW and ensure Curse Surge Alert is enabled in the AddOns list.

Louder custom sound
-------------------
The bundled MP3 is:
Sounds\YouAreCursed.mp3

The bundled copy has been loudness-normalised and peak-limited so it plays much
louder than the original upload without digital clipping. WoW still applies the
volume slider for the selected channel.

Display scope
-------------
The Show button cycles between:
- All Zones
- Midnight Zones
- Coiled Isle Only

This controls only the tracker box. Sound alerts remain active in every zone.
Midnight detection follows Blizzard's current map-parent hierarchy, so child
maps and interiors inherit their Midnight zone classification.

If a restrictive choice hides the box where you are standing, use:
/csa scope all

Warning time
------------
The Warning button cycles between:
- 5 minutes
- 2 minutes
- 1 minute

The addon plays one reminder per Surge at the selected time. Changing the
setting does not create a second reminder for a Surge that has already alerted.
The selected warning time is saved between sessions.

Use /csa warning 5, /csa warning 2 or /csa warning 1 to select it directly.

Sound controls
--------------
- Click Sound to switch between Voice Clip and Raid Warning.
- Click Channel to cycle through the available playback channels.
- Click Test to play the displayed sound/channel combination immediately.
- The selected mode and channel are saved between sessions.

Master is usually the most reliable channel for an important warning. The other
channels let the alert follow your Sound Effects, Music, Ambience or Dialog
volume settings.

TomTom
------
TomTom is optional. All countdown and reminder features work without it.
With TomTom enabled, click the cyan coordinate text or use /csa waypoint.

Slash commands
--------------
/csa status              Show the next Surge and current settings.
/csa test                Test the current sound on the saved channel.
/csa test master         Test on Master without changing the saved channel.
/csa test sfx            Test on Sound Effects without changing the saved channel.
/csa test music          Test on Music without changing the saved channel.
/csa test ambience       Test on Ambience without changing the saved channel.
/csa test dialog         Test on Dialog without changing the saved channel.
/csa sound               Show the selected warning sound.
/csa sound voice         Use the bundled voice clip.
/csa sound raid          Use WoW's Raid Warning sound.
/csa voice               Alias for /csa sound voice.
/csa raid                Alias for /csa sound raid.
/csa channel             Show the selected playback channel.
/csa channel master      Save Master as the playback channel.
/csa channel sfx         Save Sound Effects as the playback channel.
/csa channel music       Save Music as the playback channel.
/csa channel ambience    Save Ambience as the playback channel.
/csa channel dialog      Save Dialog as the playback channel.
/csa scope                Show the current tracker display scope.
/csa scope all            Show the tracker in all zones.
/csa scope midnight       Show it only in Midnight zones.
/csa scope coiled         Show it only on The Coiled Isle.
/csa warning              Show the selected warning time.
/csa warning 5            Warn five minutes before each Surge.
/csa warning 2            Warn two minutes before each Surge.
/csa warning 1            Warn one minute before each Surge.
/csa on                  Enable alerts at the selected warning time.
/csa off                 Disable Curse Surge alerts.
/csa pause               Pause only the next Surge reminder.
/csa resume              Resume the next Surge reminder.
/csa waypoint            Create a TomTom waypoint for the next Surge.
/csa way                 Alias for /csa waypoint.
/csa lock                Lock the timer box.
/csa unlock              Unlock the timer box.
/csa show                Show the timer box.
/csa hide                Hide the timer box.
/csa reset               Reset the timer box position.
/csa rescan              Request and refresh Blizzard's event data.
