GearGuardian

GearGuardian - Your Ultimate TBC Classic Gear Management Companion

Version 2.8 - Socket Bonus + Temp Enchant + Bug Fixes!

=== WHAT'S NEW IN 2.8 ===

Socket Bonus Indicator
New yellow warning icon (⚠️) appears on items where the socket bonus is inactive. Tooltip shows the exact socket bonus text (e.g., "Socket Bonus: +4 Agility") and whether it's active or which gem color is missing. Hybrid gems (orange/purple/green) and prismatic gems correctly count toward multiple color requirements. Toggle on/off in config panel — disabled by default.

Temporary Enchant Detection
Weapons now get checked for temporary buffs: sharpening stones, wizard oil, mana oil, and rogue poisons via GetWeaponEnchantInfo() API. Yellow warning icon on weapons without temp enchant. Tooltip shows remaining charges and time left (e.g., "Temp: Superior Sharpening Stone [5 charges] (4:32)"). Toggle on/off in config panel — disabled by default.

=== BUG FIXES IN 2.8 ===

Critical Lua errors fixed:
- Fixed GetItemInfoFromHyperlink() not existing (was causing errors in enchants.lua)
- Fixed config panel referencing non-existent frame names (avgILevelFrame → gsFrame/iLevelFrame)
- Fixed gem parsing reading wrong indices (was 6-9, now 4-7 — correct TBC format)
- Fixed division by zero crash in tooltip comparison when equipped item score = 0
- Fixed meta gem warning overwriting slot tooltip behavior (now preserves original OnEnter/OnLeave)
- Removed reference to non-existent GG.UpdateAllBagSlots() function
- Standardized item link parsing across all modules (consistent |Hitem:([^|]+)|h pattern)

=== CORE FEATURES ===

Universal GearScore & Item Level
Hover over ANY player to see their GearScore and average item level instantly — no need to open the inspect frame. Perfect for raid leaders checking recruits or evaluating your team.
Color-coded tiers: gray / white / green / blue / purple / orange
Shift+Click to drag the GS and iLevel displays anywhere you want. Positions are saved between sessions. Use /gg reset to snap back to defaults.

Enchant & Gem Warnings
Yellow warning icons (⚠️) appear on items missing enchants or with empty gem sockets. Works on your character AND inspected players.
Detects all TBC enchants: Head (Arcanum), Shoulders (Inscriptions), Legs (Leg Armor), Cloak, Chest, Boots, Bracers, Gloves, Weapons (Mongoose, Executioner, etc.), and Scopes.
✓ Gem socket detection fully functional and tested in TBC!

Socket Bonus Indicator (NEW!)
Warning icon when socket bonus is inactive on items with gem sockets. Shows the bonus stat and which colors are missing. Supports all TBC socket types: red, yellow, blue, meta, and prismatic.

Temporary Enchant Detection (NEW!)
Detects sharpening stones, wizard oil, mana oil on weapons. Shows remaining charges and expiration time. Essential for raiders who want max DPS but keep forgetting consumables.

Enchant Suggestions
Hover over any enchantable item to see spec-appropriate enchant recommendations. Resto Shaman gets healing enchants, Warrior tank gets defense enchants — smart, not generic.

Export Gear String
Use /gg export to copy a formatted text summary with your GearScore, iLevel, and any issues (missing enchants, empty sockets). Perfect for recruitment applications, Discord sharing, or guild requirement checks.

Minimap Button
Quick access button on your minimap. Left-click opens the config panel, right-click shows a quick menu with feature toggles. Drag it anywhere around the minimap edge. Use /gg minimap to hide/show it.

Item Usability Validation
No more false upgrades! The addon validates armor types (Plate/Mail/Leather/Cloth) and class restrictions. If you can't use it, the tooltip shows "Not usable by your class."

Quality Borders
Colored glowing borders around equipped items based on quality (green/blue/purple/orange). Works on both character frame and inspect frame.

Smart Gear Comparison
Automatically detects your spec and compares items based on stat weights for your class. Green tooltips = upgrade, red = downgrade.

Full Inspect Frame Integration
When you inspect someone, you see:
- Their GearScore and average item level (draggable!)
- Missing enchants (yellow ⚠️ icons)
- Empty gem sockets (yellow ⚠️ icons)
- Socket bonus inactive warnings (yellow ⚠️ icons)
- Item quality borders
- Item levels on each piece

=== CONFIGURATION ===

Type /gg to open the config panel, or click the minimap button!

Toggle features on/off:
- Quality Borders
- Item Level Display
- Gear Comparison
- GearScore Display
- Enchant Check
- Gem Check
- Socket Bonus Indicator (NEW!)
- Temporary Enchant Check (NEW!)

Commands:
- /gg or /gg config - Open configuration panel
- /gg toggle - Enable/disable addon
- /gg reset - Reset frame positions to defaults
- /gg export - Export your gear to text (for sharing)
- /gg minimap - Toggle minimap button on/off
- /gg version - Check for addon updates
- /gg showconfig - Show current feature settings

=== WHY USE THIS ADDON? ===

- Works on you AND other players (hover to see GearScore without inspecting)
- Instant visual feedback for missing enchants/gems/inactive socket bonuses
- Spec-aware enchant suggestions directly in tooltips
- Essential for raid leaders checking team readiness
- Export gear status for recruitment applications
- Quick access via minimap button
- Compares gear based on YOUR spec, not generic stats
- Lightweight and fast
- Built specifically for TBC Classic

=== PERFECT FOR ===

- Raid leaders checking if raiders are enchanted/gemmed/socket-bonused
- Guild officers enforcing minimum gear standards
- Recruiters evaluating applicants
- Anyone who wants to quickly assess gear quality
- Players who want to optimize their own gear

=== TECHNICAL DETAILS ===

- Uses LibClassicInspector for reliable player inspection
- Smart caching system for instant performance (60-70% faster)
- GUID-based lookups
- Direct API access for accurate data
- Works with all TBC content

Download GearGuardian and never wonder if your gear is raid-ready again. 🛡️