GuildItemScanner
Advanced WoW Classic Era guild chat monitor with comprehensive item detection and social automation.
GuildItemScanner automatically scans guild chat for equipment upgrades, profession recipes, crafting materials, storage bags, and useful potions. Features visual alerts, smart filtering, and automated social responses for a seamless guild experience.
📚 Table of Contents
⚠️ Important Notice
This addon is currently in BETA and actively being developed. While we strive for stability, you may encounter bugs or unexpected behavior.
- USE AT YOUR OWN RISK - We take no responsibility for any issues, lost loot opportunities, or guild drama that may occur
- REPORT ISSUES - Please report bugs at https://github.com/torcriss/GuildItemScanner/issues
- COMMUNITY PROJECT - Contributions and feedback are welcome!
- DATABASE VALIDATED - Item databases cross-referenced with ClassicDB for accuracy
✨ Features
🎯 Six Detection Systems
- ⚔️ Equipment Upgrades - BoE gear comparison with class/level validation + custom stat priorities
- 📜 Profession Recipes - All 8 professions with accurate pattern matching (validated against ClassicDB)
- 🏭 Crafting Materials - 569+ materials with quantity/rarity filtering + custom materials
- 👜 Storage Bags - 100+ bags with customizable size filtering (complete Classic WoW coverage)
- 🧪 Potions & Consumables - 170+ potions with type filtering
- 💰 WTB Request Tracking - Comprehensive parsing and persistent history of Want-To-Buy requests
🤖 Social Automation
- Auto-Congratulations - Random GZ messages for achievements (30% chance, 2-6s delay)
- Level Achievement Priority - Level milestones ("Reach Level X") always trigger congratulations (100% chance)
- Auto-Condolences - Level-based RIP messages for deaths (30% chance, 3-8s delay)
- Complete History Tracking - Records ALL Frontier events (sent + skipped) with actual achievement names
- Roll Transparency - Shows skip reasons with chance percentages for complete visibility
- Clear Feedback - Always shows when messages are skipped due to chance rolls
- Frontier Integration - Monitors Frontier addon achievement/death notifications
⚠️ Note: Social automation features require the Frontier addon to function. They are specifically designed for the guild and respond to Frontier's achievement/death event messages. Without Frontier addon, these features can be configured but won't trigger.
🔧 Smart Filtering
- Universal WTB Filtering - When enabled, filters ALL WTB requests regardless of professions or item types
- Smart Request Recognition - Detects "send me", "mail all", "i need some", COD patterns, etc.
- WTB Request Parsing - Extracts quantities (20x, x20, 20 stacks) and prices (40s, 1g50s, 2g)
- Class Restrictions - Only alerts for gear your class can use
- Level Requirements - Respects item level requirements
- BoP Detection - Excludes Bind on Pickup items
- Stat Comparison Modes - Item level, stat priorities, or both combined
- Profession Matching - Materials only for your learned professions
- Rarity Filtering - Material alerts by rarity (common/rare/epic/legendary)
- Quantity Thresholds - Minimum stack sizes to prevent spam
- Bag Size Filtering - Only bags above specified slot count
- Potion Categories - Filter by combat/profession/misc types
🎨 Visual & Audio Alerts
- Draggable Alert Frame - Movable popup with item details
- Color-Coded Alerts - Different colors for each item type
- Smart Buttons - Context-aware "Greed", "Request Recipe", "Request Material", etc.
- Sound Notifications - Customizable audio alerts with fallbacks
- Auto-Hide Timers - Configurable alert duration
🖥️ Graphical User Interface
Prefer visual configuration over slash commands? Check out the companion UI addon:
GuildItemScanner-UI - Optional graphical configuration interface
- 🎨 Visual Configuration - Replace slash commands with an intuitive 8-panel interface
- 📍 Minimap Button - Quick access to all settings with a single click
- ⚡ Real-Time Changes - Live configuration updates without
/reload
- 👥 User-Friendly Setup - Perfect for users who prefer GUI over command-line
- 🔄 Fully Compatible - Works seamlessly with the main GuildItemScanner addon
The UI addon provides the same powerful features as the slash commands but in a more accessible, visual format. Install both addons for the best user experience!
🚀 Installation
- Download the addon files
- Extract to
World of Warcraft\_classic_era_\Interface\AddOns\GuildItemScanner\
- Ensure you have the complete modular structure:
GuildItemScanner.tocGuildItemScanner.luamodules/Config.luamodules/Databases.luamodules/Detection.luamodules/Alerts.luamodules/Commands.luamodules/History.luamodules/Social.luamodules/WTB.luamodules/MessageLog.lua
- Launch WoW Classic Era and enable the addon
- Configure with
/gis commands
⚙️ Quick Setup
/gis prof add Engineering -- Add your professions
/gis prof add Blacksmithing
/gis rarity rare -- Set material filter to rare+
/gis quantity 1 -- Alert for any quantity (default)
/gis bagsize 12 -- Only alert for 12+ slot bags
/gis potiontype combat -- Only combat potions
/gis status -- Verify configuration
📋 Command Reference
Core Commands
| Command |
Description |
/gis on/off |
Enable/disable the entire addon |
/gis status |
Show complete configuration |
/gis debug |
Toggle debug logging |
/gis sound |
Toggle sound alerts |
/gis duration <seconds> |
Set alert duration (1-60 seconds, default: 15) |
/gis ignorewtb |
Toggle WTB (Want To Buy) message filtering - filters ALL WTB requests when enabled (default: enabled) |
/gis reset |
Reset all settings to defaults |
Equipment Settings
| Command |
Description |
/gis whisper |
Toggle whisper vs guild chat mode |
/gis greed |
Toggle "Greed!" button for equipment |
Whisper Mode: When enabled, all item requests ("Greed!", "Request Material", etc.) are sent as whispers to the item poster instead of guild chat messages.
🎯 Custom Stat Priorities
Overview: Configure custom stat priorities for equipment detection. Choose from three comparison modes and define exactly which stats matter for your character.
Comparison Modes
| Mode |
Behavior |
Use Case |
ilvl |
Item level only (default) |
Simple upgrades, general leveling |
stats |
Stat priorities only |
Specialized builds, min-maxing |
both |
Both ilvl AND stats must be better |
Conservative upgrades, endgame |
Stat Priority Commands
| Command |
Description |
/gis statmode <mode> |
Set comparison mode (ilvl/stats/both) |
/gis stats |
Show current stat configuration |
/gis stats add <stat> [position] |
Add stat at specific priority (default: end) |
/gis stats remove <stat> |
Remove stat from priorities |
/gis stats move <stat> <position> |
Reorder stat priority |
/gis stats clear |
Clear all stat priorities |
/gis stats list |
Show all available stats |
/gis stats help |
Show detailed command help |
Available Stats
- Primary Attributes: strength, agility, stamina, intellect, spirit
- Combat Stats: attackpower, spellpower, healing, mp5
- Rating Stats: crit, hit, haste, spellcrit
- Defense Stats: defense, armor, dodge, parry, block
- Resistances: fire, nature, frost, shadow, arcane, holy
Real-World Examples
🗡️ Rogue (Agility DPS)
/gis statmode stats
/gis stats add agility 1 -- Top priority (100 weight)
/gis stats add attackpower 2 -- Second priority (75 weight)
/gis stats add crit 3 -- Third priority (50 weight)
/gis stats add hit 4 -- Fourth priority (25 weight)
🛡️ Warrior Tank
/gis statmode both -- Must be ilvl AND stat upgrade
/gis stats add defense 1 -- Essential for defense cap
/gis stats add stamina 2 -- Health pool
/gis stats add armor 3 -- Physical mitigation
/gis stats add block 4 -- Block chance
⚡ Priest Healer
/gis statmode stats
/gis stats add healing 1 -- Healing power priority
/gis stats add spirit 2 -- Mana regeneration
/gis stats add intellect 3 -- Mana pool
/gis stats add mp5 4 -- Mana per 5 seconds
🌙 Shadow Priest (Leveling)
/gis statmode ilvl -- Use ilvl mode while leveling
/gis stats add spirit 1 -- Top priority for reduced downtime
/gis stats add stamina 2 -- Survivability for pulling multiple mobs
/gis stats add intellect 3 -- Larger mana pool
/gis stats add spellpower 4 -- Damage increase (rare while leveling)
Why This Leveling Priority:
- Spirit (Top Priority): Dramatically reduces downtime between pulls. Spirit Tap talent makes this even more valuable for mana regen
- Stamina (Second): Shadow Priests face-tank damage while leveling. More health = pull more mobs safely = fewer deaths
- Intellect (Third): Larger mana pool for longer pull sessions. More mana = more DoTs = more Spirit Tap procs
- Spell Power (Fourth): Nice when available but rare while leveling. Kill speed matters less than sustainability
Alternative for Level 40+ (With Shadowform):
/gis stats clear
/gis stats add spellpower 1 -- More valuable with Shadowform
/gis stats add stamina 2 -- Still need survivability
/gis stats add spirit 3 -- Still important but less critical
/gis stats add intellect 4 -- Mana pool support
🔥 Mage DPS (Conservative)
/gis statmode both -- Requires both upgrades
/gis stats add spellpower 1 -- Damage output
/gis stats add intellect 2 -- Mana pool
/gis stats add stamina 3 -- Survivability
How Weighted Scoring Works
- Position 1: 100 points per stat point
- Position 2: 75 points per stat point
- Position 3: 50 points per stat point
- Position 4: 25 points per stat point
- Position 5+: 1 point per stat point
Example Calculation: Item with 12 Intellect, 15 Spirit, 8 Stamina
Priority: intellect > spirit > stamina
Score: (12 × 100) + (15 × 75) + (8 × 50) = 2725 points
Mode Behaviors Explained
📊 Item Level Mode (/gis statmode ilvl)
- Only compares item levels
- Alerts if new item has higher ilvl than equipped
- No stat configuration needed
- Best for: General leveling, simple upgrades
📈 Stats Mode (/gis statmode stats)
- Only compares weighted stat scores
- Ignores item level completely
- Requires stat priorities to function
- Best for: Min-maxing, specialized builds
⚖️ Both Mode (/gis statmode both)
- New item must be BOTH higher ilvl AND better stats
- Most restrictive mode
- Ensures true upgrades in all aspects
- Best for: Conservative upgrades, endgame optimization
Note: In stats or both mode, if no stat priorities are set, you'll see a warning. Configure priorities with /gis stats add <stat> before switching modes.
Profession Management
| Command |
Description |
/gis prof |
List your current professions |
/gis prof add <name> |
Add a profession |
/gis prof remove <name> |
Remove a profession |
/gis prof clear |
Remove all professions |
/gis recipe |
Toggle recipe alerts |
Material Filtering
| Command |
Description |
/gis material |
Toggle material alerts |
/gis rarity <level> |
Set rarity filter (common/rare/epic/legendary) |
/gis quantity <num> |
Set minimum stack size (1-1000, default: 1) |
/gis addmaterial [item] <prof> |
Add custom material for profession |
/gis removematerial [item] <prof> |
Remove custom material |
/gis listcustom [prof] |
List custom materials (all or by profession) |
/gis clearcustom [prof] |
Clear custom materials (all or by profession) |
Bag Settings
| Command |
Description |
/gis bag |
Toggle bag alerts |
/gis bagsize <num> |
Set minimum bag size (6-24 slots) |
Potion Settings
| Command |
Description |
/gis potion |
Toggle potion alerts |
/gis potiontype <type> |
Filter potion alerts by category: |
| |
• all - All potions (default) |
| |
• combat - Healing/mana/buffs/resistance/flasks |
| |
• profession - Utility (invisibility/water walking/detection) |
| |
• misc - Fun items/antidotes/holiday potions |
Social Features
⚠️ Requires Frontier Addon: These commands configure social automation features that only work with the Frontier addon installed. They respond to Frontier's achievement and death notifications for the guild.
| Command |
Description |
/gis gz |
Toggle auto-congratulations for achievements |
/gis gz chance <0-100> |
Set GZ chance percentage (default: 30%) |
/gis gz add <message> |
Add custom GZ message (max 50 chars) |
/gis gz remove <index> |
Remove custom GZ message by number |
/gis gz list |
List all custom GZ messages |
/gis gz clear |
Clear all custom GZ messages |
/gis rip |
Toggle auto-condolences for deaths |
/gis rip chance <0-100> |
Set RIP chance percentage (default: 30%) |
/gis rip add <level> <message> |
Add custom RIP message for level category |
| |
• Level categories: low (1-39), mid (40-59), high (60) |
/gis rip remove <level> <index> |
Remove custom RIP message by level and number |
/gis rip list |
List all custom RIP messages by level |
/gis rip clear [level] |
Clear custom RIP messages (all or specific level) |
History Commands
| Command |
Description |
/gis history [filter] |
Show alert history with optional filtering |
/gis clearhistory |
Clear all alert history |
/gis socialhistory [filter] |
Show social automation history (gz/rip/all) |
/gis clearsocialhistory |
Clear social automation history |
/gis wtblist |
Show WTB (Want-To-Buy) request history (last 20 entries, persistent) |
/gis wtbclear |
Clear WTB request history |
/gis logs [count] |
Show guild message processing log with readable item names (default: 30 messages, optional count parameter) |
Social History Tracking: The addon automatically tracks the last 50 GZ and RIP events from ALL Frontier activity, including both sent messages and skipped events (due to failed rolls). Records timestamps, player names, actual achievement names, player levels, and skip reasons with roll percentages for complete social automation visibility.
Example Social History Output:
[GuildItemScanner] Social History (4 entries):
Time | Type | Player | Message | Details
19:40:43 | GZ | Minibolt | gratz | Achievement: Reach Level 30
19:43:12 | GZ | Fusebanker | [Skipped - Roll Failed] | Achievement: Blessed Run: Loot a Colored Pouch
19:44:33 | RIP | Warrior | F | Level 60
19:45:01 | RIP | Mage | [Skipped - Roll Failed] | Level 23
⚙️ Profile Management
Overview: Save and load different configurations for various activities like raiding, leveling, or farming. Profiles store all your settings including professions, materials, stat priorities, and social configurations.
DEFAULT Profile: A special permanent profile that always exists and contains factory default settings. It cannot be deleted but can be customized and saved. When you delete all other profiles, the DEFAULT profile is automatically loaded.
🔄 Auto-Save Feature: Any setting change automatically updates the current profile (or DEFAULT if no profile is loaded). This ensures your configurations are always preserved without needing manual saves.
| Command |
Description |
/gis profile |
Show current profile status and auto-load profile |
/gis profile save |
Update current profile with current settings |
/gis profile save <name> [description] |
Save current settings as a named profile |
/gis profile load <name> |
Load a saved profile |
/gis profile list |
List all saved profiles (DEFAULT always included) |
/gis profile delete <name> |
Delete a profile (cannot delete DEFAULT) |
/gis profile clear |
Reset DEFAULT to factory settings, delete all other profiles |
/gis profile default |
Load the DEFAULT profile |
/gis profile default <name> |
Set a profile to auto-load on login |
Example Usage:
-- Start with DEFAULT profile (automatically loaded)
/gis profile default -- Load DEFAULT profile
-- Customize DEFAULT and save it
/gis prof add Engineering
/gis rarity epic
/gis profile save DEFAULT -- Update DEFAULT profile
-- Create other profiles
/gis profile save "Raiding" "MC/BWL optimized settings"
/gis profile save "Leveling" "Basic settings for 1-60"
-- Switch between profiles
/gis profile load "Raiding" -- Load Raiding profile
/gis profile load "Leveling" -- Load Leveling profile
/gis profile default -- Load DEFAULT profile
-- Quick save to current profile
/gis profile save -- Update whichever profile is loaded
-- Set auto-load profile for startup
/gis profile default "Raiding" -- Auto-load Raiding on login
-- Delete profiles (DEFAULT cannot be deleted)
/gis profile delete "Leveling" -- Delete Leveling profile
/gis profile delete DEFAULT -- Error: Cannot delete DEFAULT profile
-- Reset everything to factory defaults
/gis profile clear -- Reset DEFAULT to factory, delete all others
What's Saved in Profiles:
- All addon settings (enabled/disabled features)
- Profession list and material settings
- Bag and potion filters
- Custom stat priorities and comparison mode
- Social automation settings and custom messages
- Custom materials for professions
📋 Default Settings Reference
The DEFAULT profile contains these factory settings:
Core Settings:
- Addon:
enabled
- Sound alerts:
enabled
- Alert duration:
15 seconds
- Debug mode:
disabled
- Whisper mode:
disabled
- Greed button:
enabled
- WTB filtering:
enabled (ignores Want To Buy messages)
Detection Settings:
- Recipe alerts:
enabled
- Equipment alerts:
enabled
- Material alerts:
enabled
- Bag alerts:
enabled
- Potion alerts:
enabled
- All request buttons:
enabled
Equipment Settings:
- Equipment quality filter:
uncommon (minimum quality)
- Legendary alerts:
enabled (always alert legendary items)
- Stat comparison mode:
ilvl (item level comparison)
- No stat priorities configured
Filter Settings:
- Material rarity:
common (all rarities)
- Material quantity:
1 (any stack size)
- Bag size minimum:
6 slots
- Potion type:
all
- No professions configured
- No custom materials
Social Automation:
- Auto-GZ:
disabled (30% chance when enabled)
- Auto-RIP:
disabled (30% chance when enabled)
- No custom GZ messages
- No custom RIP messages
To reset to these defaults: /gis profile clear
🎣 Fishing Items
Why Fishing is NOT a Profession: Fish are already tracked through existing professions - Cooking (most fish) and Alchemy (special fish like Oily Blackmouth, Firefin Snapper, Stonescale Eel). Adding "Fishing" as a separate profession would create redundancy.
What Fishing Items ARE Tracked:
High-Value BoE Fishing Equipment
- Big Iron Fishing Pole - Rare BoE drop from Shellfish Traps in Desolace (~1.5% chance, 10-50g value)
- Darkwood Fishing Pole - Rare BoE world drop while fishing (10-50g value)
Valuable Fishing Containers
- Iron Bound Trunk - Contains BoE materials worth ~50s average
- Mithril Bound Trunk - Contains BoE materials worth ~1g average
- Heavy Crate - Locked container with materials (requires lockpicking)
- Waterlogged Crate - Contains crafting materials
Engineering Fishing Consumables
- Aquadynamic Fish Attractor - +100 fishing skill lure (Engineering-made, limited vendor supply)
- Nightcrawlers - Basic fishing lure (tradeable consumable)
Valuable Fishing Recipes
- Recipe: Savory Deviate Delight - Extremely valuable (350-3500g depending on server)
Fish Already Tracked
- Alchemy Fish: Oily Blackmouth, Firefin Snapper, Stonescale Eel, Deviate Fish
- Cooking Fish: All fish species tracked as cooking materials
- Seasonal Fish: Winter Squid (marked as rare, seasonal arbitrage opportunity)
Value Proposition: These fishing-related items can generate significant gold through trading, with some fishing poles worth 10-50g and the Savory Deviate Delight recipe worth hundreds to thousands of gold.
Testing Commands
| Command |
Description |
/gis smoketest |
Run comprehensive test suite (recommended after deployment) |
/gis test |
Test equipment upgrade alert (uses Twisted Chanter's Staff) |
/gis whispertest |
Toggle whisper-based testing mode |
/gis compare [item] |
Compare any item with equipped gear |
🔬 Smoke Test Features
The /gis smoketest command runs all detection systems safely:
- 7 comprehensive tests covering all item detection types
- Safe testing: No guild spam - whispers to yourself only
- Social simulation: Tests GZ/RIP logic without sending messages
- Progress tracking: Real-time test status with [OK]/[X] indicators
- Performance metrics: Shows test duration and pass rate
- Smart skipping: Automatically skips tests requiring missing setup
Sample Output:
=== SMOKE TEST STARTING ===
Safe mode: No guild spam, whispers to self only
[1/7] Testing Equipment Detection... [OK] Equipment test completed
[2/7] Testing Material Detection... [OK] Material test completed
[3/7] Testing Bag Detection... [OK] Bag test completed
[4/7] Testing Recipe Detection... [OK] Recipe test completed
[5/7] Testing Potion Detection... [OK] Potion test completed
[6/7] Testing Whisper Mode (Safe)...
Temporarily enabling whisper test mode...
Sending test whisper to yourself...
Note: Whispers to yourself may not appear in chat (this is normal)
[OK] Test whisper sent - check for alert popup
Whisper test mode restored to disabled
[7/7] Testing Social Features (Simulation)... [OK] Social simulation completed safely
=== SMOKE TEST COMPLETE ===
Tests Run: 7/7 | Tests Passed: 7 | Time Elapsed: 3.5 seconds
Status: All core systems operational [OK]
No guild messages sent - all tests safe
🎯 Usage Examples
Universal WTB Filtering
# When ignoreWTB is ENABLED (default):
[Guild] [Player1]: WTB [Red Mageweave Bag] paying 5g!
→ [GuildItemScanner Debug] WTB request filtered (ignoreWTB enabled)
→ (No alert shown, but logged to WTB history)
# When ignoreWTB is DISABLED:
[Guild] [Player1]: WTB [Red Mageweave Bag] paying 5g!
→ GIS Alert: "Bag detected: [Red Mageweave Bag]" (if matches your settings)
# Selling offers always work normally:
[Guild] [Player2]: WTS [Red Mageweave Bag] cheap!
→ GIS Alert: "Bag detected: [Red Mageweave Bag]"
→ Button: "Request Bag"
Material Detection
[Guild] [Miner]: WTS [Copper Ore] x50 cheap!
→ GIS Alert: "Engineering material detected: [Copper Ore]"
→ Button: "Request Material"
Custom Materials
/gis addmaterial [Crawler Claw] Cooking
→ "Added custom material: [Crawler Claw] to Cooking (rarity: common)"
→ "This material WILL trigger alerts (rarity >= filter)"
/gis listcustom
→ "=== Custom Materials ==="
→ "Cooking: (1 custom)"
→ " - Crawler Claw (common) [ACTIVE]"
Status Indicators:
[OVERRIDE] - Custom material replaces a built-in database entry[ACTIVE] - Material will trigger alerts (meets rarity filter)[FILTERED] - Material won't trigger alerts (below rarity filter)
Bag Detection
[Guild] [Tailor]: [Mooncloth Bag] 16 slots, 50g
→ GIS Alert: "Bag detected: [Mooncloth Bag] (16 slots)"
→ Button: "Request Bag"
Potion Detection
[Guild] [Alchemist]: [Major Healing Potion] x20 for raid
→ GIS Alert: "Potion detected: [Major Healing Potion] (combat)"
→ Button: "Request Potion"
Equipment Upgrade
[Guild] [Player]: [Epic Sword] BoE, anyone need?
→ GIS Alert: "+15 ilvl upgrade: [Epic Sword]"
→ Button: "Greed!"
WTB Request Tracking
[Guild] [Player1]: WTB [Copper Ore] 20x for 40s
→ [GuildItemScanner Debug] WTB logged: Player1 wants 20 Copper Ore for 40s
[Guild] [Player2]: Looking for [Heavy Leather] x30, paying 1g50s
→ [GuildItemScanner Debug] WTB logged: Player2 wants 30 Heavy Leather for 1g50s
/gis wtblist
→ [GuildItemScanner] WTB History (2 entries):
→ Time | Player | Item | Qty | Price | Message
→ 19:45:23 | Player2 | Heavy Leather | 30 | 1g50s | Looking for [Heavy Leather] x30...
→ 19:44:12 | Player1 | Copper Ore | 20 | 40s | WTB [Copper Ore] 20x for 40s
/reload
→ [GuildItemScanner Debug] WTB history loaded: 2 entries (persistent across reloads)
Social Automation
[Frontier] PlayerName earned achievement: [Level 60]
→ GIS: (30% chance) Sends random GZ message after 2-6 second delay
[Frontier] PlayerName (Level 23) has died
→ GIS: (30% chance) Sends level-appropriate RIP message after 3-8 second delay
Custom Social Messages
/gis gz add Awesome job!
→ "Added custom GZ message: 'Awesome job!'"
/gis gz chance 75
→ "GZ chance set to 75%"
/gis rip add high MEGA F LEGENDARY PLAYER
→ "Added custom RIP message for high level: 'MEGA F LEGENDARY PLAYER'"
/gis gz list
→ "=== Custom GZ Messages (2 total) ==="
→ "1. Awesome job! [CUSTOM]"
→ "2. LETSGOOO [CUSTOM]"
→ "=== Default GZ Messages (always available) ==="
→ " GZ, gz, grats!, LETSGOOO, gratz, DinkDonk, grats, nice!, congrats!, awesome!"
/gis rip list
→ "=== Custom RIP Messages ==="
→ "LOW Level (1-39): 0 custom"
→ " No custom messages"
→ "MID Level (40-59): 0 custom"
→ " No custom messages"
→ "HIGH Level (60): 1 custom"
→ " 1. MEGA F LEGENDARY PLAYER [CUSTOM]"
→ "=== Default RIP Messages (always available) ==="
→ "LOW Level (1-39):"
→ " F, RIP, oof"
→ "MID Level (40-59):"
→ " F, OMG F, BIG RIP"
→ "HIGH Level (60):"
→ " F, OMG F, GIGA F, MEGA RIP, NOOOO"
Whisper Testing
/gis whispertest -- Enable testing mode
/w YourCharacter [Thunderfury] -- Test with whispers
→ GIS Alert: Shows upgrade analysis
/gis whispertest -- Disable when done
Note: Whispers to yourself may not appear in your chat window - this is normal WoW behavior. The detection will still work and show alerts.
Manual Item Comparison
/gis compare [Thunderfury, Blessed Blade of the Windseeker]
→ Equipment slot: main hand
→ [Current Weapon]: +25 ilvl upgrade (ilvl 80)
→ Summary: UPGRADE! +25 item levels
🏭 Supported Professions
All crafting professions with material databases and recipe detection are supported:
- Alchemy - All herbs, vials, reagents + accurate recipe detection (ClassicDB validated)
- Blacksmithing - Ores, bars, stones, gems + Plans: pattern detection
- Engineering - Metals, cloth, parts, explosives + Schematic: pattern detection
- Enchanting - Dusts, essences, shards, crystals + Formula: pattern detection
- Tailoring - Cloth, threads, dyes + Pattern: detection (shared with Leatherworking)
- Leatherworking - Leather, hides, scales + Pattern: detection (shared with Tailoring)
- Cooking - Meats, fish, spices, ingredients + Recipe: pattern detection
- First Aid - Cloth, venom sacs + Manual: pattern detection (NEW in v2.7+)
Recipe Detection Accuracy: The addon now uses ordered pattern matching validated against ClassicDB to ensure Alchemy recipes are never misclassified as Cooking recipes. Longer, more specific patterns are checked before shorter generic ones.
Note: Gathering professions (Mining, Herbalism, Skinning) and Fishing are NOT supported as separate professions. Their materials are already tracked through the crafting professions that use them (e.g., herbs through Alchemy, ores through Blacksmithing/Engineering, fish through Cooking/Alchemy).
🧪 Potion Categories
Combat Potions (/gis potiontype combat)
- Health/Mana restoration potions
- Stat buff elixirs (Strength, Agility, etc.)
- Resistance potions (Fire, Frost, Nature, etc.)
- High-end flasks for raiding
- Special combat potions (Limited Invulnerability, Rage)
Profession Potions (/gis potiontype profession)
- Utility effects (Water Walking, Invisibility)
- Detection potions (Detect Undead)
- Movement effects (Swiftness, Free Action)
Misc Potions (/gis potiontype misc)
- Fun potions (Noggenfogger, Savory Deviate Delight)
- Antidotes and cures
- Holiday/event potions
🎨 Alert Priority System
The addon processes items in this priority order:
- Recipes (highest) - For your professions
- Materials - For your professions with quantity/rarity filtering
- Bags - Storage solutions with size filtering
- Potions - Consumables with type filtering
- Equipment (lowest) - BoE upgrades for your class
WTB Tracking runs in parallel with all detection systems, always logging requests regardless of alert filtering settings.
🏗️ Architecture
Modular Design
The addon uses a clean modular architecture for maintainability:
- Config.lua - Configuration management and SavedVariables
- Databases.lua - Item databases (potions, bags, materials, equipment)
- Detection.lua - Smart item detection logic
- Alerts.lua - Visual alert system and UI
- Commands.lua - Complete command system
- History.lua - Persistent history tracking
- Social.lua - Auto-GZ/RIP social features
- WTB.lua - Want-To-Buy request tracking and parsing
Extensible Databases
Each database is easily expandable with new items:
- 170+ Potions - All Classic WoW potions with effects and levels
- 100+ Bags - Including special profession bags
- 800+ Materials - Covering all 8 professions
- Complete Equipment - All slot mappings and class restrictions
🔧 Debug & Testing
Debug Mode
Enable detailed logging to troubleshoot detection issues:
/gis debug
Enhanced Debug Output:
- Clear upgrade/rejection reasoning:
|NOT AN UPGRADE| vs |UPGRADE!|
- Detection type results:
Not a needed material, |MATERIAL MATCH|
- Final processing outcome:
|FINAL RESULT: Equipment not an upgrade|
🐛 Troubleshooting
No Alerts Appearing
- Check if addon is enabled:
/gis status
- Verify professions are set:
/gis prof
- Check filter settings:
/gis rarity common and /gis quantity 1 (defaults)
- Test with:
/gis smoketest (comprehensive test suite)
Button Text Cut Off
The request button has been widened to accommodate longer text like "Request Material".
Social Features Not Working
Ensure you have the Frontier addon installed for achievement/death detection.
Missing Materials
The addon tracks 100+ materials across all professions but may not include every single item. The modular database system makes it easy to add new materials. Report missing items for inclusion in future updates.
📊 Performance
- Minimal Memory Usage - Efficient event handling and smart filtering
- No Lag - Asynchronous processing with retry queues for uncached items
- Scalable - Works well in busy guilds with spam prevention
🤝 Contributing
Found a bug or want to suggest a feature? The addon is actively maintained and welcomes feedback for:
- Missing materials/recipes/bags/potions
- New filtering options
- UI improvements
- Performance optimizations
