Reads the equipped ammo count directly and only says OUT OF AMMO when a bow, gun or crossbow is in hand, the ammo slot is empty and there is no ammo in the bags. Adds /ctk ammodebug. The Help window shows the version.
Class Toolkit
Small, useful helpers for every class on Ravencraft (and other 1.12.1 servers). Each character only sees what fits its class, and everything can be switched off.
- Swing timer. Bars counting down to your next melee swing, Auto Shot or wand shot. The red end of the Auto Shot bar is the aim: stand still then, or the shot is delayed. With SuperWoW there's an off-hand bar too.
- Buff reminder. An icon appears when a buff your class keeps up is missing or about to run out: an aspect, an armor, a blessing or aura, Fortitude, Mark of the Wild and so on. Click it to cast, right-click to stop that reminder. Hunters also get a warning when Aspect of the Cheetah or the Pack is still on in a fight.
- Spell ready icons. Watch as many spells as you like. Each gets an icon that greys out with a countdown on cooldown, turns blue without the mana (or rage, or energy), red when the target is out of range, and says READY when you can cast it. Or keep one icon that shows whichever watched spell is ready first. Hunters start with Arcane Shot.
- Reagent and ammo warnings. A chat and mid-screen warning when you run low on a reagent you carry (Soul Shards, Ankhs, runes, candles, symbols, seeds, Flash Powder), and hunters' ammo at 200 and 50 shots.
- Low ammo box for hunters: a red box on screen when you're down to your last 2 spare stacks of arrows or bullets, when the ammo you have equipped is down to 100 shots (
/ctk ammo <shots>to change), or when a bow, gun or crossbow is in your hand with no ammo equipped. It looks only at the equipped stack, not your bags. - Hunters: a range icon (In range, Dead zone, Melee, Out of range) and a pet feed reminder that you click to feed.
These started out in PokeHuntLog, the hunter pet collection log, and moved here so every class can use them.
Install
With an addon launcher (RavenLaunch and similar): paste https://github.com/notforever-ship-it/ClassToolkit into its GitHub addon installer.
By hand:
- Download the zip from the latest release. It contains a ready-made
ClassToolkitfolder. - Copy that folder into
World of Warcraft\Interface\AddOns\. The path should end inInterface\AddOns\ClassToolkit\ClassToolkit.toc. - Fully restart the game.
/reloaddoesn't pick up newly added addons.
Use
- Type
/ctkto open the options: what shows on this character, the spells with a ready icon, and Unlock icons for moving things around. - Press Help in the options, or type
/ctk help, for the How to use window. - Settings are per character, so your Paladin and your Hunter can show different things. Icon positions are shared by all your characters.
- Anything a spell icon or the range icon needs to know about range has to come from an action bar: put the spell on any bar, even a page you never show.
What starts switched on
| | Melee timer | Auto Shot / wand timer | Buff reminder | Spell ready | Reagents | Range icon | Aggro meter and feed | |---|---|---|---|---|---|---| | Warrior, Rogue, Paladin, Shaman, Druid | yes | | yes | add your own | yes | yes | | | Priest, Mage, Warlock | | wand | yes | add your own | yes | yes | | | Hunter | yes | Auto Shot | yes | Arcane Shot | yes + ammo, low ammo box | yes | yes |
Buff reminders by class
| Class | Reminds about |
|---|---|
| Warrior | Battle Shout (in combat only) |
| Paladin | an aura, a blessing (Greater Blessings count) |
| Hunter | an aspect, Trueshot Aura; Cheetah or Pack left on in a fight |
| Priest | Fortitude, Inner Fire, Divine Spirit |
| Mage | Arcane Intellect, an armor |
| Warlock | Demon Skin or Demon Armor |
| Druid | Mark of the Wild, Thorns, Omen of Clarity |
| Shaman | Lightning Shield |
A reminder only appears once you know the spell. Buffs from other players count (a Prayer of Fortitude from your priest is fine).
Commands
| Command | What it does |
|---|---|
/ctk |
Open the options window |
/ctk help |
Open the How to use window |
/ctk commands |
List every command in chat |
/ctk move |
Unlock or lock the icons and bars so you can drag them |
/ctk swing, /ctk ranged |
Melee timer, Auto Shot / wand timer on or off |
/ctk ready, /ctk buffs, /ctk reagents |
Spell ready icons, buff reminder, reagent warnings on or off |
/ctk range, /ctk feed, /ctk ammo |
Hunters: range icon, feed reminder, low ammo box on or off |
/ctk ammo <shots> |
Hunters: show the low ammo box when your equipped ammo is down to this many shots (100 to start) |
/ctk watch <spell> / /ctk unwatch <spell> |
Add or remove a spell ready icon |
/ctk ready all / /ctk ready one |
An icon for every watched spell, or one for the next one ready |
/ctk feed content / /ctk feed unhappy / /ctk feed sound |
When the feed reminder shows, and its sound |
/ctk buffs reset |
Bring back buff reminders you right-clicked away |
/ctk counts |
List your reagents and ammo |
/ctk version |
Show which version you have |
/ctk debug on |
Show what the addon notices in chat, for bug reports |
/ctk reset |
Put this character's settings and all icon positions back to default |
How it works
- Swings. With SuperWoW the game reports every swing and shot directly. Without it, melee swings come from the combat log (your hits and misses, and on-next-swing abilities like Heroic Strike, Raptor Strike and Maul), wand shots from "Your Shoot ..." lines, and Auto Shots from an arrow leaving the quiver while no special shot has just started the global cooldown.
- Buffs. 1.12 only tells addons a buff's icon, so names are read from each buff's tooltip.
- Reagents. A reagent is only watched once you've carried at least its warning amount, so nobody is told they're out of something they never use.
- The combat log parts only work on English game clients.
Reporting bugs
Screenshot the problem, and include what /ctk debug on prints while it happens and any red error text.
For developers
- The addon files live at the repo root, which is the layout launchers expect;
tools/is development only and left out of release zips. node tools/check-lua.jsparses every file as Lua 5.0 and flags things the 1.12 client doesn't have.node tools/install.js [path to Interface\AddOns]copies the addon into a game folder.
Credits
Made by stealthzi.
License
MIT, see LICENSE.
Changelog
1.5.3
- The low ammo box no longer cries wolf. Some clients do not give the ammo slot an item name, which made the box say OUT OF AMMO with a full quiver. It now reads the equipped count directly, and only says OUT OF AMMO when a bow, gun or crossbow is in your hand, the ammo slot is empty, and there is no ammo in your bags either. If the count cannot be read it says nothing.
/ctk ammodebugprints what the game says about your ammo slot, to find out why the box does or does not show.- The Help window shows the version, like the other windows.
1.5.2
- The low ammo box only looks at the ammo you have equipped, not your bags: it shows when that stack is down to 100 shots (
/ctk ammo <shots>to change; it used to count spare stacks), and shows "OUT OF AMMO" when a bow, gun or crossbow is in your hand with no ammo equipped. - The range icon is a plain bow for hunters, so it looks the same every time. Before, it borrowed the watched spell's picture, which came and went depending on where the spell sat on your action bars. Other classes still get the watched spell's picture.
1.5.1
- The low ammo box is easier to see. It now counts the equipped stack as well as the stacks in your bags, shows whenever you are down to 200 shots or fewer in all (the same level as the first chat warning), and shows "OUT OF AMMO" when a bow, gun or crossbow is in your hand and no ammo is equipped. Before, it only counted spare stacks in your bags and showed nothing with an empty quiver slot.
1.5.0
- Aggro meter for hunters. A bar showing how close you are to pulling the mob off your pet, who the mob is really attacking, and what to do: Shoot, Ease off, Hold, or Feign Death. Threat is counted from the combat log (damage, Growl, Distracting Shot, Feign Death) and corrected by what the mob attacks, so it learns your server's Growl numbers as you fight. Switch in
/ctkor/ctk aggro;/ctk aggro growl <threat>if you know what Growl is worth on your server.
1.4.1
- The range icon showed a question mark for some spells (the hunter's Auto Shot among them) because the client gave no icon for them when the spellbook was read. The icon is now taken from the action button holding the spell instead, so the ready icons and DoT timers get it too.
1.4.0
- DoT timers on the spell ready icons.
1.3.0
- Range icon for every class: it watches your class's main attack, or any spell you pick with
/ctk range <spell>.
1.2.0
- Watch as many spells as you like. The four-spell limit is gone; the icons wrap onto another line past six, and the options window grows with the list.
- One icon instead of a row: Ready icons: just the next one in
/ctk(or/ctk ready one) shows whichever watched spell you can cast now, or the one coming back soonest. - While the icons are unlocked for dragging, every ready icon shows, so you can see how much room the row takes.
1.1.0
- How to use window: a Help button in
/ctk, or/ctk help./ctk commandslists every command in chat. - Low ammo box for hunters: a red box on screen when you're down to your last 2 stacks of ammo, with the stacks and shots left. Its own switch in
/ctk, draggable like the rest, and/ctk ammo 3changes when it shows.
1.0.0
- First release: swing timer for every class, buff reminder, spell ready icons, reagent and ammo warnings, and the hunter range icon and feed reminder from PokeHuntLog.