Smart Spell Targeter

Last Meaningful Update: 4/26/23. Changelog at the bottom of this page.

Description:
Automatically points an arbitrary spell towards a member of your group that meets your customizable criteria. Cast the spell at its target by calling a command from a macro. If nothing meets your criteria, it can fallback to a default target unit, e.g. "player" or "focus" (https://wowpedia.fandom.com/wiki/UnitId for examples), or can optionally fallback to a pet if you have one available.

This weakaura has been made to be more of a creation engine (similar to Weakauras itself) for your own auto-targeting desires rather than a weakaura with a specific purpose. As an example of how it works, the default configuration is set up to cast "Innervate" on a member of your group that is a healer. The installation steps will guide you through setting this up to auto-target Feral Regrowths onto tanks instead. This weakaura is intended to be cloned for every spell and set of conditions that you want to use.

Unfortunately, it's not complex enough to handle intricate usecases, but I hope it can be used to solve many basic ones. I've had some functionality requests and have been seeing people fork my Smart Misdirect weakaura and I wanted to let those who don't know how to code be able to edit a few options and have something usable.

Note that I recommend sticking with Smart Misdirect for misdirecting/tricks still, since it has a little bit of helpful logic that can't be handled generically.

Has verbose printouts when the target changes so you can be aware of what's going on.

Performance:
Literally zero performance hit. The scary-looking cyclomatic complexity, maintainability index, and lines of code reported by wago are almost entirely influenced by how this weakaura unrolls and organizes all the custom settings on startup.

Installation:
A bit of caution here - if bugs are fixed or features are added, the weakaura will be updated. However, this weakaura is intended to be cloned multiple times with different configurations. Take care when updating this weakaura to make sure you're not destroying configurations you've made, or write down configurations and restore them afterwards.

For the following installation, we're going to assume we're a feral druid that wants to autotarget their Regrowths to the tank in their party
0. Requires Details Damage Meter if you're going to be checking any specialization criteria. Blizzard still does not have a way to check what specialization someone is without very convoluted methods. Details implements these methods and allows us to use them.
1. Install the weakaura as normal.
2. Rename the Weakaura to something that represents what you want to do. I'm going to use Kovi's Rad Regrowth
3. Open the "Custom Options" tab of the weakaura
4. Change the Button Frame Name at the top left into something unique, like KovisRadRegrowth. Make note of this name, as we'll be using it later
5. Change the Spell ID to your spell's ID. Some UI configurations will show this if you hold shift and mouse over your spell icon. You can also find it by searching wowhead for your spell and checking the ID in the URL. For Regrowth, we're going to use 8936
6. Set the default unit to a unit that you'll want to receive the spell if no one in your group meets your criteria. We'll set ours to player since we want to use the heal on ourselves if there isn't a tank available (https://wowpedia.fandom.com/wiki/UnitId for more examples)
7. Allow Pet Fallback doesn't matter in our case, since we don't have a pet. This option can be used to let the player's pet become a target instead of the Default Unit we just set
8. If you plan on having a special person that you want to receive the spell over another person when two people meet your criteria, you can specify it with the Priority Target Name textbox. The server name box is not required to be used, but can be used as an extra bit of precision if you happen to have two identically named people in the same group.
9. The rest of the custom options are available for you to set what criteria should be met before someone gets set as your target. For our Regrowth usecase, we're going to set the Group Role to "Tank" and untoggle everything else.
10. Make a macro in your global or personal macros section, with the following data:

#showtooltip Regrowth
/click KovisRadRegrowth LeftButton 1
/click KovisRadRegrowth LeftButton 0

Note that KovisRadRegrowth is the Button Frame Name we set earlier.
11. Put the macro somewhere on your spellbar (probably in place of your original Regrowth spell)
12. Now the weakaura will intelligently scan through your groups, find the first available tank, and set that as your target for Regrowth. Dumbfiring regrowth will cast it onto that tank, no matter what you're currently clicking on. If there's no available tank in your group, it will cast it on yourself instead.
13. Now we're going to clean up the weakaura a bit. Go to the "Load" tab of the weakaura and click the "Spell Known" checkbox, then type in 8936. This will ensure that your other characters don't have this weakaura running unless they know the spell.
14. Similarly, we only want this to be active when we're in the Feral spec. Click "Class and Specialization" and change it to "Feral"
15. Done. I recommend strategically using other load conditions on the "Load" tab and utilizing macro conditionals (https://wowpedia.fandom.com/wiki/Macro_conditionals) on the macro to further extend this weakaura's functionality - making it more dynamic based on the scenario (examples below)

Some modifications for inspiration:
The /click macro command we use has compatibility with normal macro conditionals (https://wowpedia.fandom.com/wiki/Macro_conditionals), which allow you to do various things like reusing your keybinds based on certain scenarios
- Note that any conditional can be negated by prefixing it with "no", e.g. [nocombat] is the inverse of [combat].
- Conditionals can be combined by separating them with a comma within the same brackets ('AND' logic), e.g. [stealth, indoors] requires you to be in stealth AND indoors
- Conditionals can have multiple conditions that allow them to work by separating the conditions into different brackets ('OR' logic), e.g. [swimming][flying] works when you're swimming OR flying
- These pieces can be combined e.g. [nostealth, resting][combat] will work if you're resting without stealth OR if you're in combat

- Limit weakaura execution to characters that can actually cast the spell: WA "Load" tab -> Spell Known
- Limit weakaura execution to a specific spec, if multiple specs know that spell: WA "Load" tab -> Class and Specialization
- Add a forced cast onto your clicked target if you're targeting a friendly unit (e.g. yourself or a specific person), let the smart button handle it if not:
/cast [@target, help, exists] <normal spell name>
/click <ButtonFrameName goes here> LeftButton 1
/click <ButtonFrameName goes here> LeftButton 0
- Add a forced self cast option with a modifier key (e.g. 'alt') to the macro:
/cast [mod:alt, @player] <normal spell name>
/click <ButtonFrameName goes here> LeftButton 1
/click <ButtonFrameName goes here> LeftButton 0
- Add a forced focus cast option with a modifier key (e.g. 'ctrl') to the macro:
/cast [mod:ctrl, @focus] <normal spell name>
/click <ButtonFrameName goes here> LeftButton 1
/click <ButtonFrameName goes here> LeftButton 0
- Repurpose button during raids:
/cast [group:raid] <normal spell name>
/click <ButtonFrameName goes here> LeftButton 1
/click <ButtonFrameName goes here> LeftButton 0
- Repurpose button during normal parties:
/cast [group:party, nogroup:raid] <normal spell name>
/click <ButtonFrameName goes here> LeftButton 1
/click <ButtonFrameName goes here> LeftButton 0
- Only allow smart button to work while stealthed:
/click [stealth] <ButtonFrameName goes here> LeftButton 1
/click [stealth] <ButtonFrameName goes here> LeftButton 0

Troubleshooting:
I'll be notified within a few hours if you write a comment on Wago. Include an error log/detailed description (enable live debug mode in the custom options for extra insight) and I'll try to fix anything that breaks. Make sure you are using the latest version of the weakaura if something isn't working.

Some usecases may require more complexity than this weakaura can handle, and some spells may not work when used in this configuration. Unfortunately I won't be providing support for these usecases as long as the weakaura is working as intended. If you want to fork the logic and tailor it to your own needs, I recommend starting from Smart Misdirect as a base, which is a much simpler version without all the dynamicism. It, along with this weakaura, are deeply-commented in order to help anyone who wants to fork or fix.

You can manually dump the button's values at any time by writing the following in chat:
/dump <ButtonFrameName goes here>:GetAttribute("unit")
/dump <ButtonFrameName goes here>:GetAttribute("spell")

Blizzard's /click macro functionality has been weird since they changed it to the "LeftButton 0/1" system in DF pre-patch. Depending on your game's configuration, /click macros may or may not work properly. This weakaura is not the problem in this case - you need to figure out why /click macros are not working properly for you.

When testing in my game, I get the following results:
Macro set to "LeftButton 0" and ActionButtonUseKeyDown CVar set to "0" works
Macro set to "LeftButton 0" and ActionButtonUseKeyDown CVar set to "1" fails
Macro set to "LeftButton 1" and ActionButtonUseKeyDown CVar set to "0" fails
Macro set to "LeftButton 1" and ActionButtonUseKeyDown CVar set to "1" works

If you want to try different configurations, use the following commands to switch your ActionButtonUseKeyDown CVar:
/run SetCVar("ActionButtonUseKeyDown", 0)
/run SetCVar("ActionButtonUseKeyDown", 1) (default value and recommended by yours-truly)

And try changing your macro back and forth:
/click <ButtonFrameName goes here> LeftButton 0
/click <ButtonFrameName goes here> LeftButton 1

Some users have also had success with switching "LeftButton" to "LeftClick".

If the /dump commands report the correct values and none of these configurations work for you, I can't help. /click macro functionality being broken is outside the scope of this weakaura. Post in the comments if you find out what the problem was.

Changelog:
    * 5/8/23:
        - No code changes, no need to update. Took the off-screen text "SST" off of this weakaura. 2 people have reported that it's not getting placed off-screen, even though I can't reproduce this. Might be related to addon configuration or display size. The only purpose was to make it easier to differentiate icon-less weakauras when scrolling through your WA list, but if it's causing any sort of problem it's not worth it.
    * 4/26/23:
        - Fixed small regression that would always cause name change reports on group events
        - Fixed Priority Target Realm sometimes getting skipped
    * 4/23/23:
        - Small codebase refactor. Theoretically higher performance but shouldn't be measurable because this weakaura already has an infinitesimally small performance footprint
    * 4/16/23:
        - Added a toggle for the verbose printing feature to the options
    * 4/15/23:
        - Initial version