Game: WoW Forever. Version: 1.4.0.
Aggro Watch shows nearby enemies while you play solo and an aggro count for each party or raid member when grouped. It can warn you when you pull aggro, approach a threat threshold, or lose aggro in tank view. Text, flashing edges, and sounds can be adjusted separately.
Install
Use the CurseForge app first. Select your Forever game installation, search for Aggro Watch, and install the matching release. The catalog lists https://www.curseforge.com/wow/addons/aggro-watch.
For a manual install, place the release folder at World of Warcraft/_forever_/Interface/AddOns/AggroWatch/. Keep AggroWatch.toc directly inside that folder, with its Lua files and media beside it. Avoid an extra nested release folder. Fully close and restart the game, then enable the addon for the character in the AddOns list.
Quick start
- Type
/aw setupto walk through the meter and its controls. - Open
/aw config, choose whether warnings should follow your role, and use Test warning. - Drag and resize the meter, then enable Lock meter position. Turn on enemy nameplates so nearby enemies can be counted.
Slash commands
| Command | What it does |
|---|---|
/aw, /aggro | Toggle the meter. Both names accept every subcommand below. |
/aw config, options, settings | Open settings. |
/aw setup, guide, tutorial | Open the setup guide. |
/aw tank, dps, auto | Force tank warnings, damage/healer warnings, or follow your role. |
/aw test | Preview warning text, flash, and pulled-threat sound. |
/aw sound | Toggle warning sounds. |
/aw sound on, sound off | Enable or disable warning sounds. |
/aw sound test | Test the pulled-threat sound, even when warning sounds are disabled. |
/aw lock | Toggle the position lock. |
/aw reset | Recenter the meter and restore scale to 100%; show it again. |
/aw minimap | Toggle the minimap button. |
/aw help | Print command help. |
Settings and controls
Defaults below describe a new installation. Existing saved choices can carry forward after an update.
| Setting or control | Default | Where | What it does |
|---|---|---|---|
| Lock meter position | Off | General | Prevent dragging; Shift-wheel can still change scale. |
| Show minimap button | On | General | Show the draggable launcher. |
| Meter scale | 100% | General | Size from 70% to 140%, in 5% steps. |
| Background opacity | 95% | General | Background strength from 20% to 100%. |
| Show the meter | Always | Display | Always, combat only, group only, or group and combat. Selecting a choice brings back a manually hidden meter. |
| Rows shown | 15 | Display | Maximum visible rows, 1–15; available window height also limits rows. |
| Bar style | Textured | Display | Textured or flat bars. |
| Name text size | Normal | Display | Small, Normal, or Large. |
| Meter look | Standard | Display | Clean text removes the panel and bars; controls appear on hover. |
| Show warning text on screen | On | Warnings | Display large warning text. |
| Animate warning text | On | Warnings | Fade warning text instead of removing it without a fade. |
| Warning text size | 26 | Warnings | Size 16–40 in steps of 2. |
| Flash screen edge | On | Warnings | Brief red edge flash when warned. |
| Warning threshold | 90% | Warnings | High-threat threshold, 50–100% in 5% steps. |
| In a group, show | Follow my role | Group view | Choose role-based, tank, or damage/healer warning behavior. Group rows remain aggro counters. |
| Play warning sound | On | Sound | Master switch for automatic warning sounds. |
| Pulled threat (AGGRO!) | Automatic | Sound | Sound used when you gain aggro. |
| High threat | Automatic | Sound | Sound used at the threshold. |
| Lost aggro | Automatic | Sound | Sound used when aggro is lost. |
| Sound channel | Master | Sound | Master, Sound effects, or Dialog. |
| Custom file name | pull.ogg | Sound | Press Enter to save a file name or path; used with Custom file. |
| Meter position and size | Center; 320 × 280 | Drag frame and bottom-right corner | Save placement and dimensions. |
| Minimap position | 200 degrees | Drag minimap button | Save position around the minimap. |
| Reset position / Reset all settings | Action buttons | Settings | Recenter and normalize scale, or restore all defaults. |
Features and windows
Read the meter
Solo rows show hostile units the addon can observe, their health where available, and who they are attacking. The header counts enemies in combat with you. New enemies and a pet losing aggro can trigger warnings. This is a nearby-unit view, not a census of an entire dungeon.
In a group, rows stay in roster order and include members with zero aggro and pets. A number counts visible hostile nameplates in combat for which that member holds aggro. Class colors identify players; pets use their owner's color. Assigned tanks have a T. A +? suffix means some enemy threat information is unavailable, so the number is only the known portion. Scroll to reach more group members. Hold Shift while scrolling to change scale.
Warnings in practice
Tank mode warns about lost aggro and a group member approaching the threshold on your target. Damage/healer mode warns when you gain aggro or cross the threshold. Auto follows the detected role. Changing modes does not replace the current group counter display with the older threat-percentage list.
Warnings react to changing conditions instead of repeating every refresh. Each sound type has a three-second cooldown. Normal text lasts about 2.2 seconds; animated text begins fading after about 1.6 seconds. Unavailable threat information cannot produce a reliable percentage or count.
Choose a sound
Each warning can use Automatic, Voice warning, Tank voice, Aggro alarm, Threat rising, Aggro lost, Raid warning, Ready check, Alarm clock, Boss whisper, Whisper, Party invite, Queue ready, Map ping, Level up, Custom file, or No sound. Voice warning follows your role; Tank voice always uses the tank lines. Each voice type alternates between two lines.
Automatic first looks for aggro.ogg, high.ogg, or lost.ogg in _forever_/Interface/AggroWatchSounds/. It also accepts .mp3, checking .ogg first. Without your own matching file it plays the bundled warning. Files named sound1 through sound9, with either extension, can appear as My sound choices. Fully restart after adding files. The separate Interface folder survives addon replacement.
For Custom file, enter a file name and press Enter. A bare name is tried in the separate sound folder first, then in Interface/AddOns/AggroWatch/sounds/. A path is used directly. Test sound plays the pulled-threat selection. Choosing No sound for that warning still silences the test.
Windows and minimap
Left-click the minimap button to toggle the meter. Right-click it for the quick menu, then choose Settings; drag it around the edge. The meter gear opens settings directly. Right-click the meter for settings, setup, lock, role choices, testing, and hiding. Escape closes settings without closing the meter. Settings changes apply immediately. The setup guide uses sample rows and can wait for combat to end. More from Korivash opens the addon catalog.
FAQ
Why does everyone show zero?
Counts require visible hostile nameplates in combat with readable threat. Zero does not prove no unseen enemies are attacking.
Why is there a +? after a number?
Some visible enemies have unavailable threat information. The count is incomplete.
Why did tank mode leave the rows unchanged?
In 1.4.0, group rows are counters in every mode. The mode changes warnings.
Can I silence only one warning?
Yes. Select No sound for that warning under Sound.
Why does Test sound play with sounds off?
Tests deliberately bypass the automatic-sound switch and cooldown.
Why is the meter missing?
Check visibility conditions, then toggle /aw or use /aw reset. Picking a Show the meter choice also restores it.
Can I move a locked meter?
Unlock it first. Shift-wheel scaling remains available while locked.
Are custom files discovered with /reload?
New files require a full game restart. Detection runs shortly after loading.
Troubleshooting and saved data
Settings are stored account-wide in AggroWatchDB. If new bundled sounds are silent after an update, fully restart once. Check the selected sound channel and the game volume for that channel.
The addon does not appear. Check the game installation selected in CurseForge, the folder name above, and the AddOns checkbox for this character. A full game restart is needed when adding an addon or new files; a UI reload is not a substitute for that first restart.
A manual update seems to disappear. Check whether CurseForge is managing the same folder. An app update or reinstall can replace a hand-installed build. Keep a backup outside AddOns and use one update method for that installation.
Settings are missing or reverted. WoW writes saved settings during a normal logout or UI reload. Back up saved files while the game is closed. Account data is normally under _forever_/WTF/Account/<Account>/SavedVariables/AggroWatch.lua, with a .lua.bak backup when present. Do not confuse that file with the addon's source files in Interface/AddOns. A different account or game installation has a different saved-data folder.
Something still looks wrong. Use the recovery controls described above, then reload. For help, include the addon version, game flavor, what you clicked, and the exact error text: https://discord.gg/YxFRuEPSxZ.
Recent changes
- 1.4.0 — Group aggro counters include pets and zero counts, with class colors, tank markers, and scrolling.
- 1.3.9 — Added More from Korivash.
- 1.3.8 — Added tank voice lines and automatic role switching for Voice warning.
- 1.3.7 — Automatic sound selection and discovery of user sound files.