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
✨ Features
🖥️ Graphical User Interface
🚀 Installation
⚙️ Quick Setup
📋 Command Reference
🎯 Usage Examples
🏭 Supported Professions
🧪 Potion Categories
🎨 Alert Priority System
🏗️ Architecture
🔧 Debug & Testing
🐛 Troubleshooting
📊 Performance
🤝 Contributing
📜 Version History
📄 License

⚠️ 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.toc
- GuildItemScanner.lua
- modules/Config.lua
- modules/Databases.lua
- modules/Detection.lua
- modules/Alerts.lua
- modules/Commands.lua
- modules/History.lua
- modules/Social.lua
- modules/WTB.lua
- modules/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