GuildItemScanner-UI
A comprehensive graphical user interface addon for configuring GuildItemScanner in World of Warcraft Classic Era.
🎯 Features
- 🎨 Complete Interface - 9-panel design covering all GuildItemScanner functionality
- 🗺️ Minimap Integration - Quick access via minimap button, drag to reposition
- ⚡ Lightweight & Fast - Optimized codebase for excellent performance
- 🔄 Live Configuration - Changes apply immediately to GuildItemScanner
- 🛡️ Safe Integration - No risk of breaking GuildItemScanner functionality
- 💬 Smart Social Interaction - Time-based contextual messaging with clickable history panels
📋 Interface Overview
🔧 General Settings
- Core Controls: Enable/disable addon, debug mode
- Alert Behavior: Sound alerts, whisper mode, greed mode
- Filtering: WTB message filtering
- Timing: Alert duration settings
- Equipment: Comparison mode options
🚨 Alert Settings
- Recipe Alerts: Notifications for recipes matching your professions
- Material Alerts: Crafting materials with rarity and quantity filters
- Bag Alerts: Storage bags with size filtering
- Potion Alerts: Potions and consumables notifications
- Equipment Alerts: Quality filter and legendary item override controls
⚒️ Professions
- Manage Professions: Add/remove professions for recipe and material detection
- Current List: View all configured professions
- Quick Clear: Clear all professions option
🎉 Social Features
- Auto-GZ: Automatically congratulate players on level ups with configurable chance (0-100%)
- Auto-RIP: Send condolences when players die with configurable chance (0-100%)
- Chance Sliders: Fine-tune probability of automatic responses with visual percentage display
- Custom GZ Messages: Add, remove, and manage personalized congratulation messages
- Custom RIP Messages: Add level-specific condolence messages (Low 1-39, Mid 40-59, High 60)
- Message Management: Full UI for managing custom messages with clear all functionality
- ⚠️ Requires: Frontier addon for functionality
📜 Alert History
- View History: Browse latest 20 alerts with timestamps and details
- Clickable Entries: Click any alert to whisper the player about item availability
- Sent Indicators: Visual [Sent] markers prevent duplicate messages
- Whisper Mode Support: Respects GIS whisper settings for messaging behavior
- Player Information: See which players linked items and when
- Alert Types: Identify what type of alert was triggered
- Clear History: Remove all history entries with confirmation
🎉 Social History
- Auto-GZ/RIP Tracking: View automatic congratulations and condolences sent
- Achievement Details: See specific achievements that triggered congratulations
- Smart Time-Based Messages: Click entries for contextual responses based on event age
- Recent (< 1 min): Quick "GZ" or "F"
- Medium (1-3 min): Personal "GZ [player]" or "RIP [player]"
- Older (> 3 min): Detailed with achievement info or "Go agane"
- Sent Indicators: [Sent] and [Auto] markers prevent duplicate messages
- Message Mode Selection: Choose between guild messages and private whispers
- Dynamic Tooltips: Preview exact message before sending
- Visual Distinction: Color-coded entries (green for GZ, red for RIP)
- Latest 20 Events: Performance-optimized display of recent social interactions
- ⚠️ Requires: Frontier addon for data
💰 WTB History
- Request Tracking: View latest 20 Want-To-Buy requests with detailed information
- Smart Display: Shows player, item, quantity, price, and original message
- Clickable Entries: Click any WTB request to whisper the player with clickable item links
- Sent Tracking: Visual [Sent] indicators prevent duplicate messages
- Price Analysis: Parse and display extracted prices and quantities from messages
- Clear History: Remove all WTB history entries with one click
- Tooltips: Hover over entries to see complete original messages
📊 Guild Logs
- Message History: View up to 200 guild messages processed by GuildItemScanner
- Chronological Display: Simple, clean timeline of all guild messages without filtering complexity
- Detailed Information: See sender, timestamp, item count, WTB status, and alert types
- Color-Coded Display: Visual indicators for different alert types and message status
- Statistics: View total entries, oldest/newest messages, and storage capacity
- Hover Details: Full message content and processing details in tooltips
- Complete History Access: Displays all 200 stored messages with smooth scrolling
- Simplified Interface: Clean design focused on message content without filter clutter
🔧 Admin Tools
- Smoke Test: Run GuildItemScanner diagnostic tests
- Status Display: Shows test results and system status
- Debug Tools: Testing and troubleshooting utilities with advanced controls
🔧 Requirements
- World of Warcraft Classic Era (Interface 11507)
- GuildItemScanner addon (Download)
- Frontier addon (optional, for social features only)
📦 Installation
- Download the latest release from GitHub Releases
- Extract the
GuildItemScanner-UI folder to your Interface/AddOns/ directory
- Install the main GuildItemScanner addon
- Enable both addons in the WoW addon list
- Restart World of Warcraft
🎮 Usage
Opening the Interface
- Minimap Button: Click the gear icon on your minimap
- Chat Command: Type
/gisui or /gis-ui in chat
Navigation
- Tab Selection: Click tabs on the left to switch between panels
- Scrolling: Use mouse wheel or scrollbar to navigate within panels
- Tooltips: Hover over controls for helpful information
- Auto-Save: All changes apply and save automatically
Minimap Button
- Left-Click: Open/close the configuration window
- Drag: Reposition the button around your minimap
- Hide: Access through settings (use
/gisui to reopen)
🛡️ Safety & Compatibility
- ✅ Non-Intrusive: No modifications to GuildItemScanner files
- ✅ API Safe: All interactions through official GIS functions
- ✅ Error Protected: UI remains functional if GIS has issues
- ✅ Graceful Degradation: Works even when GIS is disabled
🐛 Troubleshooting
"GuildItemScanner not found" Error
- Ensure GuildItemScanner addon is installed and enabled
- Check addon loading order - restart WoW if needed
- Verify both addons appear in your addon list
Settings Not Applying
- Changes save automatically when using the interface
- Try
/reload to refresh if issues persist
- Ensure GuildItemScanner is enabled and functional
Minimap Button Missing
- Use
/gisui chat command to open the interface
- Check if button was hidden in settings
- Restart WoW if the button doesn't appear
Social Features Not Working
- Install the Frontier addon
- Enable Frontier in your addon list
- Social features require Frontier to function
