GoldSage

GoldSage Changelog

v1.3.0

Settings overhaul, farming improvements, and logo

Settings Panel — 3-Tab Redesign

• Rebuilt the Settings panel from a single scrolling list into a clean three-tab layout: General, Farming, and Alerts
• Each tab now has its own dedicated scroll area, preventing the panel from becoming cramped as options grew
• Farming and Alert settings are no longer buried at the bottom of a long list

Farming Tab (New Settings)

• Added Minimum Item Value slider (0–200g) — items below this threshold are silently ignored by the loot popup
• Added Popup Duration slider (2–15s) — controls how long the popup stays before auto-dismissing
• Added Jackpot Threshold slider (50–5000g) — items worth more than this trigger a gold border flash and fanfare sound
• Added Minimum Item Quality slider (All / White+ / Green+ / Blue+ / Epic+) — filter out grey trash and below
• Added Show Vendor-Only Items checkbox — opt in to see vendor sell price when an item has no AH data
• Added Play Sound on Loot checkbox — subtle coin sound on every valuable popup
• Added Flash & Sound for Jackpots checkbox — gold border pulse animation and UI_EPICLOOT_TOAST fanfare for high-value drops
• Added Sort Queue by Value checkbox — highest-value item always pops first when the queue builds up
• Added Reset Popup Position and Reset Bar Position buttons — snaps both frames back to their default screen positions

General Tab

• All existing sliders and checkboxes moved here unchanged (Minimum Profit, Minimum Sale Rate, Max Results, AH Cut, Enable Alerts, Show Trend Arrows, Auto-Refresh on AH Open)

Alerts Tab

• Alert manager (live list with enable/disable toggles and remove buttons) moved to its own dedicated tab
• Added Clear All Alerts button

FarmPopup — Smart Queue

• Popup queue now sorts by value when enabled — most expensive item always surfaces first instead of FIFO order
• Added deduplication — rapid stacks of the same item (e.g. mining three ore nodes back to back) are consolidated into a single popup entry rather than spamming three separate windows
• Added ⏳ +N more queue counter in the bottom-left of the popup — updates live as new items arrive while one is already showing
• Added jackpot flash — items exceeding the jackpot threshold get an animated gold/orange border pulse for their entire display duration
• Added stack size hint — gathering materials display a suggested AH stack size (e.g. "Post in stacks of 20") based on item name keyword matching for ore, herbs, leather, gems, cloth, and fish
• Added sale rate and vs Region delta lines to the popup meta row — same data as the main window, now visible while farming without opening GoldSage
• Added fade-in animation when a popup appears
• Popup now shows both total stack value and per-item price when you pick up multiples
• Vendor fallback now respects the new Show Vendor-Only Items setting rather than always falling back silently
• Quality filter now respects the new Minimum Item Quality setting

GoldSage.lua

• Added farmShowVendor, farmPlaySound, farmJackpotAlert, farmJackpotValue, farmMinQuality, and farmSortByValue to saved variable defaults
• Added farmPopupPos and farmBarPos to saved variables for persistent popup and session bar positions

Logo

• Designed and added an official GoldSage logo (SVG + PNG at 1360×640px / 2x retina)
• Features a stacked gold coin emblem with etched sage leaf, ornamental gold border with corner diamond flourishes, and scattered sparkle stars
• "Gold" rendered in #FFD700, "Sage" in near-white, flanked by a centered diamond divider above the subtitle

v1.2.0

Realm vs. region comparison column and version bump

New Feature — vs Region Column

• Added a vs Region column to all three main tabs (Top Sellers, Craft & Post, Gather & Post)
• Compares your realm's DBMarket price against TSM's DBRegionMarketAvg to show how your market sits relative to all other realms in the region
• Color-coded display:
  • Bright green +23% — your realm pays well above average, post aggressively
  • Soft green +8% — slightly above average, good market
  • Gray ~avg — within ±5% of regional average
  • Soft red -8% — slightly below average, margins compressed
  • Bright red -22% — well below average, consider holding stock
  • — — no TSM data (Auctionator-only installs)
• Hovering any cell in the column shows a tooltip explaining what the value means and what action to take
• Requires TSM for DBRegionMarketAvg; degrades gracefully to — when only Auctionator is installed

Data.lua

• Added GetRegionMarketAvg(itemLink) — queries TSM's DBRegionMarketAvg price source
• Added GetRealmDelta(itemLink) — returns the fractional difference between realm price and regional average

Scoring.lua

• Added realmDelta field to all three result sets (sellers, crafts, gatherables)

UI.lua

• Updated column definitions for all three tabs to accommodate the new vs Region column
• Adjusted existing column widths and x-offsets to maintain clean layout within the 700px frame
• Added RealmDeltaCol() helper function with color thresholds and hover tooltip

v1.1.0

Craft queue, price alerts, trend tracking, and settings panel

New Feature — Craft Queue (Tab 4)

• Added a fourth tab 📋 Craft Queue to the main window
• Click the green + button on any Craft & Post row to add 1 craft to the queue; Shift+Click adds 5
• Queue tab displays all queued crafts with − / + quantity controls and a red × remove button per row
• Materials Needed section below the craft list consolidates all reagents across all queued crafts into a single shopping list with total quantities, per-unit prices, and total costs
• Shopping List export button opens a popup with plain-text copy-paste output of the full materials list and craft summary
• Clear All button wipes the entire queue
• Queue item count shown live in the tab label: 📋 Queue (7)
• Tab label updates automatically as items are added or removed

New Feature — Price Alerts

• Right-click any item row in any tab to open the Set Price Alert context menu
• Set a gold threshold and choose "price falls below" (buy signal) or "price rises above" (sell signal)
• Alerts fire a chat message, a sound (IG_CREATURE_AGGRO_SELECT), and an animated toast notification in the top-right corner of the screen
• Toast fades in and auto-dismisses after 8 seconds; click to dismiss early
• Multiple simultaneous alerts queue and display sequentially
• Active alerts shown with a 🔔 bell indicator on their item row in all tabs
• Alert manager accessible in Settings — live list with enable/disable toggles and individual remove buttons
• Alerts persist across sessions in GoldSageDB.alerts

New Feature — Price Trend Arrows

• GoldSage now records a price snapshot on every Refresh, building a 14-day rolling history per item stored in GoldSageDB.priceHistory
• Trend arrows (↑ ↓ →) appear in a dedicated column in the Top Sellers and Gather & Post tabs
• Arrows compare the current price against the 3-day average: >5% above = ↑ (green), >5% below = ↓ (red), within ±5% = → (gray)
• Insufficient history (fewer than 2 days) shows no arrow rather than a misleading one
• Toggle off in Settings if not needed

New Feature — Settings Panel

• New Settings button in the main window bottom bar, also accessible via /gs settings
• Sliders for Minimum Profit, Minimum Sale Rate, Max Results per Tab, and AH Cut percentage
• Checkboxes for Enable Price Alerts, Show Trend Arrows, and Auto-Refresh on AH Open
• Integrated alert manager (later moved to its own tab in v1.3.0)
• Panel anchors to the right edge of the main window when open; independently draggable

New Feature — Farming Mode

• /gs farm toggles farming mode on/off
• While active, listens to BAG_UPDATE_DELAYED and diffs bag contents every 0.15s to detect new items
• Popup appears bottom-right within seconds of any valuable item landing in your bags; shows item name (quality colored), AH value, sale rate, and auto-dismiss countdown bar
• Session Bar displays above the popup with live total value and gold/hour estimate; pulses gently to show it's active; hover for full breakdown; right-click to end session
• Session summary prints to chat when farming mode is turned off
• Popup and session bar positions are independently draggable and saved between sessions

New Feature — Context Menu (Right-Click)

• Right-clicking any item row in any tab opens a small context menu with two options: Set / Edit Price Alert and Link in Chat
• Context menu repositions automatically based on row location
• Alert label updates to show "Edit Alert (active)" with green text when an alert already exists for that item

UI Changes

• Tab bar expanded from 3 tabs to 4 to accommodate the Craft Queue
• Settings button added to the bottom bar (previously only /gs settings text command existed)
• Column layouts for all three data tabs adjusted for the additional Trend column

GoldSage.lua

• Version bumped to 1.1.0
• AUCTION_HOUSE_SHOW event registered for auto-refresh feature
• Added priceHistory, alerts, and craftQueue to saved variable defaults
• Added enableAlerts, showTrendArrows, and autoRefreshOnAH to settings defaults
• Added /gs queue, /gs settings, /gs resetall slash commands

v1.0.0

Initial release

Core Addon

• Three-tab main window: 🔥 Top Sellers, ⚒ Craft & Post, 🌿 Gather & Post
• Standalone draggable window with saved position, gold ornamental border, and dark WoW-style theme
• Minimap button (draggable around the minimap edge, saved position) to toggle the main window
• Refresh button re-runs all scoring on demand; status bar shows recipe count, price source, and last update time

Data Layer

• Dual price source support: TSM (DBMarket, DBMinBuyout, DBRegionSaleRate) preferred; Auctionator (GetAuctionPriceByItemID) as fallback
• GetPlayerInventory() — scans all bags (and bank if open) for current item counts
• ScanPlayerProfessions() — reads all character professions via GetProfessions() and GetProfessionInfo()
• CacheProfessionRecipes() — fires automatically on TRADE_SKILL_SHOW; uses C_TradeSkillUI.GetRecipeSchematic() for Midnight-era quality reagent handling with legacy API fallback; caches all learned recipes into GoldSageDB.recipeCache
• GetGatheringItemsFromRecipes() — identifies gathering-type reagents from cached recipes using keyword matching across ore, herb, leather, fish, cloth, and gem categories

Scoring Engine

• Top Sellers: scores by postPrice × count × saleRate (daily gold potential); requires TSM sale rate above minimum threshold
• Craft & Post: calculates (sellPrice × craftedQty × (1 − ahCut)) − materialCost; skips recipes where any reagent has no price data; minimum profit threshold configurable
• Gather & Post: scores by marketPrice × saleRate (value velocity); cross-references demand count (how many cached recipes need each material)

Settings Defaults

• minProfit = 50g, minSaleRate = 10%, maxResults = 25, ahCut = 5%

Slash Commands

• /gs — toggle main window
• /gs reset — clear recipe and profession cache
• /gs status — print price source, recipe count, and current settings to chat
• /gs set minprofit / minsalerate / maxresults / ahcut — adjust settings in-game
• /gs help — print command reference

Saved Variables

• GoldSageDB — global: recipe cache, profession list, settings, window position, minimap angle
• GoldSageCharDB — per-character: last refresh timestamp