Description:

This addon displays a very large attention-getting warning window in the center of your screen when it detects certain event (trigger) messages.

The addon comes with some pre-defined warnings for certain "bomb" style debuffs. These are debuffs where you either want to run away from everyone else, or stop whatever you are doing immediately.

There are options to play a sound, make the warning blink, display a timer, and to change the opacity, scale, and colours of the warning. Each warning can be individually enabled, and there are test buttons to try them out at any time.

The warning window will not prevent you from clicking on something behind it. You can either leave the warning on screen until the warning's timer counts down to zero, or you can click on the close button to hide the warning.

The pre-defined warnings that currently come with the addon are:

• Burning Adrenaline (Vaelastrasz the Corrupt, Blackwing Lair)
• Corrupted Healing (Nefarian, Blackwing Lair)
• Flame Wreath (Shade of Aran, Karazhan)
• Lava Wall (Sartharion, Obsidian Sanctum)
• Living Bomb (Baron Geddon, Molten Core)
• Mutating Injection (Grobbulus, Naxxramas)
• Plague (Anubisath Defender, Temple of Ahn'Qiraj)
• Threatening gaze (Bloodlord Mandokir, Zul'Gurub)
• Water spout (The Lurker Below, Serpentshrine Cavern)
• Wrath of the Astromancer (High Astromancer Solarian, The Eye)

Command summary:

• /ekbomb -- Show/hide the EkBomb window.
• /ekbomb help -- Display this command summary.
• /ekbomb reset -- Reset position of all EkBomb windows.
• /ekbomb test -- Test bomb warning window.

Calling from another addon

If you are writing an addon and want to show or hide a warning using EkBomb, you can use these two functions: EkBomb_Show("bigText", "smallText", seconds) and EkBomb_Hide(). Refer to the notes at the top of the EkBomb.lua file for more details.

OPTIONS

Warning window scale

This allows you to adjust how large the warning window will be when it is displayed.

If a warning is too wide to display on the screen using the scale that you set, the addon will automatically resize the warning when it is displayed so that it fits on the screen.

Warning window opacity

This allows you to adjust how transparent the warning window is. At 0% opacity the window is see through, and at 100% it appears as a solid color.

Small text, Large text, Background

These color buttons allow you to adjust the colors used for the warning window.

Blink the warning

This will make the warning window flash slowly.

Show the warning background

This will make the warning window's background visible behind the small and large text that make up the warning messages.

Play a sound

This will make the addon play a sound when the warning window appears.

Show the countdown timer

Most warnings will be only displayed for a certain amount of time. By enabling this option, the addon will display a countdown timer on the 'Close' button that appears on the warning window. If the warning does not use a timer (ie. its duration is set to 0), then no countdown timer will appear on the 'Close' button.

Show detailed tooltips

This will enable or disable the display of detailed tooltips. The next option will allow you to choose where to display the tooltips.

Show tooltips by the mouse pointer

This allows you to choose where to show the detailed tooltips. If you don't choose to display them by the mouse pointer, then they will be displayed in the game's default tooltip location (the lower right hand corner of the screen).

Test/Move button

The "Test/Move" button on the options window will display a warning and allow you to reposition the warning window. While the test warning is displayed you can left-click and drag the warning to a new location.

This particular test button ignores the duration assigned to a warning in order to allow you more time to position the warning or change options.

A Left-Click of the button will show the next warning. A Ctrl-Click of the button will show a random warning.

PRE-DEFINED WARNINGS

The "Pre-defined" tab allows you to test and enable/disable the warnings that come with the addon.

Left-Click a warning to select it. Right-Click a warning to enable/disable the warning (or you can click on the checkbox to the left of the warning).

Left-Click the "Test" button to show the selected warning, Shift-Click the button to show the next warning from the pre-defined list, and Ctrl-Click the button to show a random warning from the pre-defined list. You can reposition the warning while it is displayed by left-clicking on the warning and then dragging it to a new location. While the mouse is over the warning the countdown timer will be paused.

CHANGE HISTORY

Version 5.01 changes (Aug 28, 2012):

• Updated for WoW 5.
• Version number increased to match the game's major version number.

Version 2.20 changes (Nov 28, 2011):

• Updated for the WoW 4.3 patch.

Version 2.19 changes (Jun 28, 2011):

• Updated for the WoW 4.2 patch.
• Updated to handle changes Blizzard made in the COMBAT_LOG_EVENT_UNFILTERED event arguments.

Version 2.18 changes (Apr 26, 2010):

• Updated for the WoW 4.1 patch.
• Updated to handle a change Blizzard made in the COMBAT_LOG_EVENT_UNFILTERED event arguments.

Version 2.17 changes (Oct 12, 2010):

• Updated for the WoW 4.0.1 patch.

Version 2.15 changes (Dec 7, 2009):

• Updated for the WoW 3.3 patch.

Version 2.14 changes (Aug 14, 2009):

• Updated for the WoW 3.2 patch.

Version 2.13 changes (Apr 13, 2009):

• Updated for the WoW 3.1 patch.

Version 2.12 changes (Apr 1, 2009):

• Added warning for Sartharion's lava wall (Obsidian Sanctum).

Version 2.10 changes (Oct 13, 2008):

• Updated for the WoW 3.0.2 patch.

Version 2.03 changes (Mar 26, 2008):

• Due to the combat log changes introduced in WoW 2.4, custom warnings and the option to display a chat frame event link have been disabled for now.
• The addon will no longer show a warning if you are already dead.
• The pre-defined warnings have been modified to use the new WoW 2.4 combat log events.

Version 2.02 changes (Mar 8, 2008):

• Added pre-defined warning for Water spout (Lurker Below).

Version 2.01 changes (Mar 5, 2008):

• Added a period to the end of the "search for" values for Anubisath Defender, Baron Geddon, Vaelastrasz, and Grobbulus so that they should now work with EkBomb 2.x.
• Added pre-defined warning for Flame Wreath (Shade of Aran).
• Added pre-defined warning for Wrath of the Astromancer (High Astromancer Solarian).

Version 2.00 changes (Nov 14, 2007):

• Updated for the WoW 2.3.0 patch.
• If a warning is too wide to display on the screen using the scale you have set, the addon will automatically resize the warning so that it fits on the screen.
• You can now reposition the warning window by clicking one of the "Test" buttons and then dragging the warning that is displayed. The test button on the options window ignores the warning's duration in order to allow you more time to position the warning or change options.
• Tabs have been added to the bottom of the EkBomb window (options, pre-defined, custom).
• The new "Pre-defined" tab allows you to view the warnings that come with the addon.
• The new "Custom" tab allows you to add your own general or character specific warnings.
• Warnings are checked for in this order: custom character, custom general, pre-defined.
• A "Default" button has been added to the color selection windows.
• Added a new option: "Show detailed help tooltips". This enables the display of detailed tooltips.
• Added a new option: "Show tooltips by the mouse pointer". This allows you to choose whether to show the detailed tooltips by the mouse pointer, or in the game's default tooltip location.
• Added a new option: "Capture chat frame events and show event link". This records chat frame events and adds an [E] event link on each chat line. Clicking the link opens an event details window, which can be used to automatically create a warning based on the event.
• Added a new option: "Size of chat event history". This allows you to adjust how many chat frame events are remembered by the addon.
• The command "/ekbomb" now toggles the EkBomb window instead of just opening it.
• Updated the documentation file (index.html).

Version 1.49 changes (Sep 29, 2007):

• Updated for the WoW 2.2.0 patch.

Version 1.48 changes (Jun 4, 2007):

• Updated for the WoW 2.1.0 patch.

Version 1.47 changes (Jan 10, 2007):

• Updated for the WoW 2.0.3 patch.

Version 1.46 changes (Dec 5, 2006):

• Updated for the WoW 2.0.1 patch.

Version 1.45 changes (Nov 28, 2006):

• Some internal changes in preparation for the WoW 2.0 patch.

Version 1.44 changes (Aug 22, 2006):

• Fixed the issue of it not scaling the warning window unless you had opened the EkBomb options window at least once after logging in.
• Added warning for Mutating Injection (Grobbulus, Naxxramas)
• Updated the UI version to 11200 to match the WoW 1.12 patch.

Version 1.42 changes (Jul 3, 2006):

• Some minor internal changes.
• Now shows the version number in the title of the EkBomb configuration window.

Version 1.41 changes (Jun 22, 2006):

• Added an option to display (on the warning window's close button) the time remaining until the warning window automatically closes.
• Changed the name of the debuff warning for Bloodlord Mandokir from "Watched" to "Threatening gaze" on the options window.
• Changed the "Threatening gaze" warning timer from 30 to 10 seconds.
• If you are making an addon and want to use EkBomb to show a warning you can call the following LUA function: EkBomb_Show("bigText", "smallText", seconds)
• If you are making an addon and want to use EkBomb to hide the current bomb warning you can call the following LUA function: EkBomb_Hide()
• If you want to show a custom warning in a macro, you can type something like this: /script EkBomb_Show("bigText", "smallText", 30)
• If you want to hide the current bomb warning in a macro, you can type this: /script EkBomb_Hide()

Version 1.4 changes (Jun 18, 2006):

• Added a "stop" warning when Bloodlord Mandokir (Zul'Gurub) is watching you.
• Updated the UI version to 11100 to match the WoW 1.11 patch.

Version 1.3 changes (May 31, 2006):

• Added option to hide the background of the warning window so you just see the text.
• Added slider to change the scale of the warning window.
• Added ability to change the color of the small text, large text, and background.

Version 1.2 changes (May 29, 2006):

• Changed Anubisath Defender plague timer to 30 seconds instead of 20. This now matches the actual duration of the debuff.
• Changed Nefarian's corrupted healing timer to 30 seconds instead of 8. This now matches the actual duration of the debuff.
• Localized the text strings for english.
• Initial public release.

Version 1.1.1 changes (Mar 28, 2006):

• Updated UI version from 10900 to 11000 (to match the 1.10 WoW patch).

Version 1.1 changes (Mar 5, 2006):

• Added a configuration window for EkBomb.
• Typing "/ekbomb" will now open the configuration window instead of showing a command summary. To show a command summary use "/ekbomb help".
• Removed the command line configuration options.
• Added an option to play a sound when the warning window appears.
• Added a test for Anubisath Defender's plague (Temple of Ahn'Qiraj).
• Added a test for Nefarian's corrupt healing (for priests in Blackwind Lair).
• Added a "/ekbomb reset" command to reset the position of the configuration window.

Version 1.0.1 changes (Jan 3, 2006):

• Updated UI version from 1800 to 10900 (to match the 1.9 WoW patch).

Version 1.0 changes (Sep 14, 2005):

• Initial release.
• Oct 22, 2005: Updated UI version from 1700 to 1800 (to match the 1.8 WoW patch).