Skip to content

senzei88/THUD_Raid_Tools

Repository files navigation

THUD Raid Tools

Thud Raid Tools for Turtle WoW. Tracks all standard and custom Turtle WoW consumables. Features an easy-to-use GUI for raid leaders to verify buffs instantly. Coded by Senzei and Erros. Inspired by Method Raid Tools and OG-Raid Helper.

A World of Warcraft 1.12 (Vanilla / Turtle WoW) addon designed for raid leaders and Warlocks to streamline recruitment, consumable tracking, ready checks, auto-inviting, summoning, and cooldown readiness — all from a single compact UI bar.


Table of Contents


Installation

  1. Download or clone this repository
  2. Place the THUD_Raid_Tools folder into your WoW addons directory:
    World of Warcraft/Interface/AddOns/THUD_Raid_Tools/
    
  3. Log in and enable THUD Raid Tools in your addon list

Main UI

A small draggable bar appears on screen with buttons for all modules. It can be repositioned anywhere by left-click dragging. A minimap button (monkey icon) toggles the bar and can be dragged around the minimap edge. Its position is saved between sessions.

┌──────────────────────────────────────────────┐
│                THUD Raid Tools               │
├─────────────┬────────────┬───────────────────┤
│ Guild Rec   │    Rdy     │     Consume       │
├─────────────┼────────────┼───────────────────┤
│  Auto Inv   │ Chronicle  │    Auto Sum       │
├─────────────┴────────────┴───────────────────┤
│ [Rebirth] [AOE Taunt] [Innervate] [H▓▓▓ 94%]│
│                                   [M▓▓░ 78%]│
└──────────────────────────────────────────────┘

Progress bar panels for active modules (Recruitment, Auto Summon) anchor above the main bar with a countdown timer showing time until the next auto-post.


Modules

Guild Recruit

Automates posting recruitment advertisements to chat channels on a configurable timer.

Features:

  • 5 message slots — write different ads and switch between them
  • Optional second message per slot (posts immediately after the first)
  • Message rotation — check multiple slots to cycle through them automatically
  • Channel selection: General, Trade, World, or Raid
  • Configurable interval in minutes
  • [TTP] tag — automatically replaces with minutes remaining until a set Target Time (e.g. [TTP] mins until pull!)
  • Progress bar panel above the main bar showing countdown to next post
  • Settings persist between sessions via SavedVariables

Slash Commands:

/thudgr

Ready Check (Rdy)

A single button that instantly fires a standard WoW Ready Check on your raid.


Consume Inspector

A full raid buff and consumable inspection window. Scans all raid members and displays their active buffs in a grid. Only raid leaders and officers can use the announce and flask check functions.

Features:

  • Tracks 10 class buffs per player: Fortitude, Mark, Intellect, Spirit, Shadow Protection, Might, Kings, Wisdom, Salvation, Champion
  • Tracks a comprehensive list of consumables by priority:
    • Priority 1 — Flasks: Flask of Supreme Power, Flask of Distilled Wisdom, Flask of the Titans
    • Priority 2 — Protection Potions: GFPP, GSPP, GNPP, GAPP, GFRPP
    • Priority 3 — Elixirs & Alcohol: Mongoose, Mageblood, Giants, Shadow Power, Firepower, and many more
    • Priority 4 — World Buffs & Food: Juju Might, Juju Power, Zanza, Rage of Ages, Well Fed, Scorpok, etc.
  • Check Flasks button — reports to officer chat who is missing a Priority 1 flask
  • Announce Buffs button — announces missing class buffs to raid chat by category (raid leader/officer only)
  • Log Consumes button — exports a full consume log to a .txt file via SuperWoW's ExportFile (saved to WoW/Exports/)
  • Supports Ready Check integration — displays ready/not ready icons live during a ready check

Slash Commands:

/TRT
/THUDinspect   — open the consume inspector window
/trta          — announce missing buffs to raid
/trtlog        — export consume log to file

Auto Invite

Automatically invites players who whisper a configured keyword.

Features:

  • Set one or more keywords separated by commas
  • Whisper matching is case-insensitive and exact full-message match
  • Simple Start / Stop toggle
  • Settings persist between sessions

Slash Commands:

/trtai

Chronicle

A quick-access button to open the ChronicleLog addon options panel directly from the THUD bar. Requires the ChronicleLog addon to be loaded.

  • Single click opens the ChronicleLog options window
  • Clicking again while the window is open closes it (toggle)

Auto Summon

(Warlock-focused) A full auto-summon system that scans public chat for players looking for summons, auto-invites them, and gives you a one-click popup to cast Ritual of Summoning.

Public Chat Scanner

Monitors General, Trade, World, and Whisper channels. All three of the following must be present in a single message to trigger:

  1. Location keyword — one of your enabled scan locations (e.g. "hyjal", "mount hyjal", "hj")
  2. Intent keywordwtb, want to buy, lf, lf1, lf2, lf3, lfs, or looking for
  3. Summon keywordsummon, summons, summ, or sum

Example trigger: "LF summon Hyjal" ✅ | "LFM Hyjal" ❌ | "summon Hyjal"

When all three match, the addon will:

  • Auto-invite the player
  • Whisper them confirming the free summon
  • Show a summon popup with their name and destination
  • Play the ReadyCheck sound

Scannable Locations:

Key Keywords
Hyjal hyjal, mount hyjal, hj
EPL epl, eastern plaguelands, eastern plague
Azshara azshara, azsh
UBRS ubrs, upper blackrock, upper br
Winterspring winterspring, wspring
Silithus silithus, sili

123 Party/Raid Scanner (Warlock only)

Always active regardless of whether auto-summon scanning is running. When any player in your current party or raid types 123 in say, yell, party, or raid chat:

  • Whispers them "Summons inc!"
  • Opens the summon popup immediately
  • Plays the ReadyCheck sound

Summon Popup

A small draggable popup that appears when a summon is triggered. Shows the player's name and destination.

  • Summon — targets the player by name, casts Ritual of Summoning, sends a party message, and whispers the player confirming the summon
  • Dismiss — closes the popup without acting
  • Popups queue if multiple players trigger simultaneously — they appear one at a time so none are missed

Auto-Post Timer

Automatically posts your configured message to a channel on a set interval (in minutes) while running. A progress bar panel above the main bar shows the countdown to the next post.

Channels: General, Trade, World, Raid

Config Window

Accessible via the Auto Sum button or slash command. Configure:

  • Custom auto-post message (up to 255 characters)
  • Channel selection
  • Post interval in minutes
  • Which locations to scan for

Slash Commands:

/thudas
/autosummon

Cooldown Readiness Icons

Three spell icons on the bottom row of the main bar track raid-wide cooldown availability for key abilities. No external addon required — fully self-contained.

Tracked Abilities:

Icon Ability Classes Cooldown
Rebirth Rebirth Druid 30 min
AOE Taunt AOE Taunt (Challenging Shout / Challenging Roar) Warrior, Druid 10 min
Innervate Innervate Druid 6 min

Icon tint:

  • 🟢 Green — all eligible members are ready
  • 🟡 Yellow — some are ready, some on cooldown
  • 🔴 Red — none are ready
  • Gray — no eligible class members in raid / no data

Left-click — announces current readiness to raid chat (or raid warning if you are leader/officer). Shows who is available and who is on cooldown with remaining time.

Right-click — starts a readiness poll. Sends a /rw message asking eligible classes to type + in raid chat. Responses are collected for 15 seconds. Only one poll runs at a time.

Hover tooltip — shows Available / Total count, list of ready players (green), and list of players on cooldown with remaining time (orange).

How cooldown tracking works:

  • Actual spell casts (Rebirth, Challenging Shout, Challenging Roar, Innervate) are detected from the combat log and start the cooldown timer automatically
  • Players who respond + to a poll are marked ready and have their cooldown cleared
  • Cast timestamps persist through /reload — cooldowns already in progress are correctly restored

Raid Health & Mana Bars

Two stacked status bars on the right side of the bottom row display aggregate health and mana percentages across your entire raid in real time.

  • Green bar — raid-wide average health %
  • Blue bar — raid-wide average mana % (mana-using classes only)
  • Updates every 0.5 seconds
  • Hover to see exact percentages in a tooltip
  • Shows your own health/mana when not in a raid

Slash Commands Summary

Command Module Description
/thudbar Main UI Toggle main bar show/hide
/thudgr Guild Recruit Open recruitment config
/TRT or /THUDinspect Consume Inspector Open consume/buff inspector
/trta Consume Inspector Announce missing buffs to raid
/trtlog Consume Inspector Export consume log to file
/trtai Auto Invite Open auto-invite config
/thudas or /autosummon Auto Summon Open auto-summon config

Requirements

  • World of Warcraft 1.12.1 (Vanilla) or compatible private server (e.g. Turtle WoW)
  • SuperWoW — required only for the consume log export (ExportFile function). All other features work without it.
  • Auto Summon 123 scanner and summon casting require the player to be a Warlock
  • Announce Buffs and Check Flasks require raid leader or officer rank

Notes

  • Settings are saved between sessions via the THUD_Settings, THUD_AutoInvite, THUD_ConsumeLog, and THUD_MinimapDB SavedVariables
  • The addon is built for the 1.12 Lua environment — it uses string.gfind, math.mod, table.getn, and this in event handlers as expected for that client version

Screenshots

Main Panel image

Guild Recruitment Panel image

Consume Panel — Log Consumes exports with timestamp to \TurtleWoW\Imports\. /trtlog does the same. image

Auto Invite — enter comma-separated keywords; anyone who whispers an exact match gets auto-invited image

Auto Summon — configure a custom summon message and scan chat for location-specific summon requests image

Auto Summon and Guild Recruitment both show a countdown timer panel above the main bar image

Check Flasks announces to officer chat who is missing a Priority 1 flask image

Announce Buffs reports missing class buffs to raid chat image

About

Thud Raid Tools for Turtle WoW. Tracks all standard and custom Turtle WoW consumables. Features an easy-to-use GUI for raid leaders to verify buffs instantly. Coded by Senzei and Erros.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages