HunterSuite

by muggles

2.1K downloads Updated 2 game versions

About

From the README

The complete Hunter toolkit for WoW Forever. Also runs on Burning Crusade Anniversary.

One addon, one clean modern look: your pet, your Auto Shot, your range and every reminder a Hunter needs.

Download on CurseForge · Changelog · Report a bug

Features

Pet card

  • Portrait, health and mood (Happy / Content / Unhappy) on one card.
  • Left-click feeds the best food in your bags. Right-click casts Mend Pet.
  • The game tells HunterSuite what your pet will eat. On Burning Crusade Anniversary it uses a built-in list of every pet food in the game. Smart mode uses the cheapest food that still gives full happiness, skips food that's too low level, and finishes small stacks first.
  • If your pet refuses a food, the card moves on to the next one.
  • Pick the food yourself - Click the food icon for a list of every food your pet will eat in your bags. The card then feeds only that food for this pet family, and shows no food rather than switching when it runs out. Auto, at the top of the list, goes back to the setting.
  • Never feed a food - Right-click a food in that list and Auto skips it, for rare foods or quest items you want to keep. Right-click it again, or use Allow all again in the settings, to undo.
  • Glows when your pet is unhappy or below your Mend Pet threshold.
  • Shows up in combat whenever you need it, and stays out of the way when your pet is happy.

Pet missing or dead

  • A card appears the moment your pet is gone, even mid-fight.
  • Left-click casts Call Pet, right-click casts Revive Pet.
  • Hidden while mounted or on a flight path.

Auto Shot timer

  • Built on Forever's native swing timer, so it's accurate without the combat log.
  • Shows the 0.5s aim window: amber when you must stand still, red if you're still moving.
  • Casts are drawn onto the bar and turn red when they'll clip your shot.
  • Also shows a global cooldown line, how late your last shot was, and a flash on every shot.

Range and dead zone

  • Melee, Dead zone (inside 8 yards), In range or Too far, with a yard estimate.
  • Docks beside the Auto Shot bar or stands on its own.

Reminders

All reminders share one tidy stack. Right-click one to dismiss it.

  • No aspect, and Cheetah or Pack still on in combat.
  • Growl on in dungeons and raids, and Growl off while solo.
  • Track Humanoids in battlegrounds, or whenever no tracking is active.

Ammo, traps and stings

  • Ammo counter with low and critical warnings and "~N minutes of shooting left". Hidden for thrown weapons and wands.
  • Ammo restock: at a vendor that sells your ammo, a panel beside the vendor window tops you up with the best you can use, to the amount you keep (1200 by default) or a full quiver. /hs ammo, or a click on the ammo counter, pins the nearest vendor that sells it.
  • Trap timers: arming, then the time left before each trap despawns.
  • Sting timers: Sting, Hunter's Mark, Concussive Shot and Wing Clip countdowns for your target, on a bar you can place anywhere or dock under the Auto Shot bar, on enemy nameplates, or both.
  • Freezing Trap timer: how long a frozen mob stays frozen, targeted or not, on a row of its own that you place in edit mode.
  • Serpent Sting tick marks: where each damage tick lands on the sting's bar, flashing as it goes off.

Burning Crusade clients

  • Weaving Bar: a Steady Shot rotation guide based on diziet559's rotation tools.
  • Auto-mark enemy pets in battlegrounds.

Settings and layout

  • /hs opens the settings window. Its overview page has a switch for every module, and every option is a click away.
  • /hs edit (or Edit layout) turns on edit mode:
    • Drag any frame; it snaps to a grid (hold Shift to place freely).
    • Arrow keys nudge the selected frame (Shift moves 10px).
    • Right-click a frame to reset it.
  • Grow up or down: under Appearance > Layout, sting and trap timers and the alert stack add rows downward or upward from the spot you placed them. A docked sting bar sits above the Auto Shot bar when it grows up.
  • Choose an accent colour, font, bar texture, HUD scale and shadows under Appearance. On English and European clients, fonts from EllesmereUI or SharedMedia are picked up automatically. Chinese clients keep the game's font, which has the Chinese characters.

Localization

HunterSuite follows the game client's language. English, Simplified Chinese (zhCN), and Traditional Chinese (zhTW) are included; other locales fall back to English. Skill names come from the game when available.

Translations live in Locales/: enUS.lua defines the default keys, while each language file overrides them. Add new player-facing text to the default table and the translation files, and preserve format specifiers such as %s, %d, and %%. Keep saved setting values, slash commands, and API identifiers language-independent. To add another language, load its file after enUS.lua in HunterSuite.toc.

From the repository root, run the localization checks with Lua 5.1:

lua tests/localization.lualua tests/weaving_locale.lualua tests/addon_load.lua

Commands

Command
/hsSettings window
/hs editEdit mode
/hs feedShow which food the pet card will use
/hs ammoPin the nearest ammo vendor on your map
/hs testPreview the alerts
/hs diagCopyable client report (please include it in bug reports)
/hs resetReset all settings (asks first)

Key bindings: Esc → Options → Key Bindings → AddOns → HunterSuite has Feed Pet and Mend Pet.

Macro:

#showtooltip Feed Pet/click HunterSuiteFeedButton

Use /click HunterSuiteFeedButton RightButton for Mend Pet.

Install

  • CurseForge app: search for HunterSuite.
  • Manual: download the zip from CurseForge or GitHub releases. Extract the HunterSuite folder into your client's AddOns folder, for example World of Warcraft\_forever_\Interface\AddOns for WoW Forever. Restart the game after adding a new addon.

WoW Forever notes

Forever runs the modern engine. Addons can't read the combat log, and in combat, encounters and PvP the game hides buff, cooldown and health details from addons. HunterSuite is built around that:

  • Swing timing comes from the native swing timer.
  • Aspect timers follow your own casts, and sting timers start when the shot lands.
  • The Freezing Trap row is drawn by the game itself, so it stays exact in combat.
  • The pet cards use secure buttons that keep working in combat.
  • Anything exact (food choice, aspect checks) is re-read the moment combat ends.

Auto-marking enemy pets is off on Forever, because raid marks are hidden during PvP matches.

Upgrading from 3.x

  • Your module on/off choices and main options carry over.
  • Frame positions reset because every frame was redesigned. Use /hs edit to place them.

Releasing

Push a version tag. The GitHub Action packages the addon, creates the GitHub release and uploads the file to CurseForge:

git tag -a v4.0.1 -m "HunterSuite 4.0.1"git push origin v4.0.1

Write the release notes in CHANGELOG.md before tagging. The upload needs a CF_API_TOKEN repository secret (a token from CurseForge).


Author: muggles · Twitch: twitch.tv/muggles

WowUp installs HunterSuite and keeps it up to date, along with the rest of your addons.

Download WowUp