Changelog

All notable changes to Goblin Toolbox will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.1.17] - 2026-07-31

Fixed

• Tracked reagents showed a count of 0 until you opened a bank: Tracked items (especially reagent-bag items like Fused Vitality) would sit at 0 after every login until a bank window was opened, which quietly fixed them until next time.

  The cause was a timing problem, not bad saved data. Reagents are tracked per quality tier, so each tracked item is stored with its tier. The bag scan runs half a second after login, and at that point the game often hasn't finished loading item information yet — so the scan can't tell what tier an item is, and files the count under "no tier". The tracker then looks for the tier you actually tracked, finds nothing, and shows 0. Opening a bank triggered a fresh scan, by which point the item data had loaded, so the count appeared correct again.

  Two changes fix it. The addon now notices which items it couldn't identify and re-counts them the moment the game finishes loading their data. And if a count still can't be found under an exact tier, it now falls back to the total for that item, which is always correct because each quality tier is a separate item. Counts are now right immediately at login, with no bank visit needed.

  Thanks to the community contributor who reported this and did the legwork to pin down when it happens — that report is what made it findable.

• Profession buttons on the Utility Bar fired only some of the time: Custom profession buttons (which sit at the right-hand end of the bar, hence the "last button doesn't work" reports) used a macro to open the profession window. That method is rejected by the game whenever another addon has "tainted" the click, which is why it worked sometimes and not others. The button now casts the profession directly, the same way the game's own UI opens a profession — no macro involved

• Session could survive a full logout with persistence turned off: The internal "this was a /reload" marker was not always cleared, so a later full logout could be mistaken for a reload and restore a session that should have reset

• Warband and player bank item counts could stop updating: If a bank scan was started but the bank turned out to be unavailable (bank closed too quickly, or no Warband bank on that character), the addon left itself flagged as "scan in progress" forever and silently skipped every later scan until you reloaded

• "Spell not known" showing on abilities you do have: The check for whether your character knows a spell was missing a required argument, which could make Class Travel, Mobile Banking, and custom spell buttons grey out incorrectly

Changed

• Migrated the last deprecated Blizzard API calls to their modern equivalents (C_SpellBook.IsSpellKnown / C_SpellBook.IsSpellInSpellBook, C_Item.GetItemCooldown, C_Spell.GetSpellTexture). These older functions currently only work because the game loads a compatibility shim, which can be switched off and is likely to disappear in a future patch — Goblin Toolbox no longer depends on it

Technical

• TOC ## Interface now lists 120007, 120100 — compatible with both the current 12.0.7 client and Patch 12.1.0 when it lands, so no out-of-date prompt on either side of the patch
• pcall-wrapped reagent quality lookups during bag scans — the API is taint-sensitive in 12.0+ and runs once per occupied bag slot, so a tainted item link must not abort the whole scan
• Registered GET_ITEM_INFO_RECEIVED, filtered to only the items a scan failed to resolve, so the item-cache flood at login doesn't cause repeated full bag scans
• addon.API.IsSpellKnown now defaults spellBank to Enum.SpellBookSpellBank.Player; added addon.API.IsSpellInSpellBook. The two legacy globals map to different modern functions (IsPlayerSpell → IsSpellKnown, IsSpellKnown → IsSpellInSpellBook), so both wrappers are needed to preserve the original availability check
• Dropped the dead legacy fallback branches from the addon.API wrapper layer — GTB is retail-only, so the C_* namespaced calls are always present

[1.1.16] - 2026-06-22

Technical

• Bumped TOC ## Interface to 120007 for Patch 12.0.7 — clears the "out of date" addon prompt

[1.1.15] - 2026-03-26

Fixed

• Currency bar not updating: Currency counts (e.g. Shard of Dundun) now reliably refresh after gaining currency while the bar was hidden due to combat, instance, or group settings. Also added a slight delay to avoid reading stale API data, and registered CHAT_MSG_CURRENCY as a backup event trigger

[1.1.14] - 2026-03-25

Fixed

• Utility bar cooldown taint error: Wrapped cooldown comparisons in pcall to handle secret/tainted values from Blizzard's C_Spell.GetSpellCooldown API after the latest mini-patch tightened taint enforcement. Cooldowns gracefully degrade (hide) instead of throwing errors

Technical

• Added ## Category: Professions to TOC metadata

[1.1.13] - 2026-03-05

Added

• Moxie currency labels: When tracking Moxie currencies on the Currency Tracker bar, the profession abbreviation (e.g. "LW", "Ench", "JC") now appears above each icon automatically — no more hovering to figure out which Moxie belongs to which profession
• Housing: Return to Previous Location: The Housing utility button now automatically switches to "Return to Previous Location" when you're visiting a housing zone, with a distinct icon and tooltip. Switches back to Teleport Home when you leave
• Hide unavailable utility buttons: New option under Utility in the /gtb menu. When enabled, utility buttons your character can't use (unlearned professions, uncollected toys, mounts you don't own) are hidden instead of greyed out. Useful if you share a profile across characters with different abilities

Fixed

• Housing teleport no longer causes "blocked action" errors: Rewrote the Housing utility button to use Blizzard's native secure teleport system, eliminating the taint error that appeared when clicking Teleport Home
• Unavailable custom buttons now hidden by default: Custom utility buttons for spells, toys, or mounts that the current character can't use no longer show as greyed-out icons — they simply don't appear on characters that can't use them

[1.1.12] - 2026-02-27

Changed

• Bag slot counting optimized: GetBagSlots() now uses C_Container.GetContainerNumFreeSlots() API instead of iterating every individual bag slot — cleaner and slightly more efficient on bag updates

Fixed

• Duplicate visibility call at login: Removed redundant UpdateVisibility() call during PLAYER_LOGIN initialization

Technical

• Updated TOC Interface version from 120000 to 120001 (game version 12.0.1)

[1.1.11] - 2026-02-24

Fixed

• Combat shard ID error: Fixed "attempt to perform string conversion on a secret string value" lua error that fired repeatedly during combat when Shard ID display was enabled
  • UnitGUID() returns tainted/secret strings during combat in Midnight 12.0+ that cannot be used in strsplit
  • Wrapped GUID extraction in pcall to match the protection already used by event handlers
  • Shard ID now falls back to its last known value during combat instead of erroring

[1.1.10] - 2026-02-15

Added

• Hearthstone bind location: Hearthstone tooltip on the utility bar now shows "Returns you to [location]", matching Blizzard's native tooltip style
• Copy Name-Realm to clipboard: Alt+Click the character name line on the HUD to copy your Name-Realm (invite-ready format) to clipboard via a quick popup — press Ctrl+C and it auto-closes

[1.1.9] - 2026-02-07

Fixed

• Custom profession spells: Profession buttons added to utility bar now work reliably for all professions
  • Leatherworking and Inscription previously failed when clicked (WoW's /cast doesn't work for these professions)
  • Now uses C_TradeSkillUI.OpenTradeSkill() API for all profession buttons
  • Tested across 7+ professions including Inscription, Blacksmithing, Archaeology, Fishing, Jewelcrafting, Enchanting, Leatherworking
• Custom utility button errors: Fixed lua error when custom spells (toys/mounts/pets) triggered cooldown updates
  • Error: "attempt to index local 'def' (a nil value)" in UpdateUtilityButtonCooldown
  • Custom slots now correctly skip hearthstone GCD filtering logic
• Toggle spell double-fire: Custom profession/racial spells no longer open and immediately close when clicked
  • Cleared stale typerelease attribute that caused action on both mouse press and release
  • Affects toggle-style spells that open windows (professions) or have press-and-hold behavior

Technical

• Rewrote IsProfessionSpell() to use spell name matching against parentProfessionName from profession API
• Added cleanup of kind-specific button properties (isProfession, professionName, mountJournalID, petSpeciesID) when buttons are reused
• Added nil guard for btn.utilDef in cooldown update logic for custom slots

[1.1.8] - 2026-01-29

Added

• Hide in groups option: New visibility toggle to automatically hide HUD when in a party or raid
  • Added checkbox in General settings alongside existing combat/instance hide options
  • Applies to all frames (HUD, tracker bars, currency bar, utility bar)
  • Useful for players who prefer minimal UI during group content

Changed

• Session timer precision: Timer now displays seconds when session duration is under 10 minutes
  • Format: "9m 45s" when under 10 minutes, "42m" when 10+ minutes, "2h 15m" when 1+ hours
  • Helps track short farming sessions more precisely (e.g., timing corpse despawns)
• Config menu layout: Reorganized General section for better readability
  • Row 1: Enable HUD (alone)
  • Row 2: Hide in combat, Hide in instances/raids, Hide in groups
  • Row 3: Lock frames, Show load message, Minimap button

Fixed

• Gold tracking accuracy: Removed 100k gold transaction cap that was causing tracking discrepancies
  • Previously, any single transaction over 100k gold was silently excluded from Earned/Spent tracking
  • This caused Net to diverge from Earned-Spent for high-value AH sales (common for gold-makers)
  • All transaction sizes now tracked correctly, regardless of amount
• Bank transfer matching: Made transfer intent matching symmetric
  • Now allows delta to be slightly less OR more than intent amount (within 5% tolerance)
  • Fixes edge cases where API timing caused actual gold change to differ slightly from deposit/withdrawal

Technical

• Registered GROUP_ROSTER_UPDATE event to handle visibility updates when joining/leaving groups
• Improved transfer offset tolerance calculation for large warband/guild bank transactions

[1.1.7] - 2026-01-22

Fixed

• Item tracker rank display: Reagent quality stars now display correctly on tracked items
  • C_Texture.GetCraftingReagentQualityChatIcon() does not exist in-game despite wiki documentation
  • Switched to atlas markup format: |A:Professions-ChatIcon-Quality-Tier{rank}:16:16|a
  • Rank 1/2/3 quality icons now visible on tiered crafting reagents at all scale settings

[1.1.6] - 2026-01-22

Fixed

• Button removal: Standard utility buttons now correctly remove themselves instead of custom buttons
  • When buttons were reused from the pool, custom button properties were not cleared
  • Shift+right-clicking standard buttons (e.g., Hearthstone) could incorrectly remove custom buttons
  • Added cleanup of isCustomSlot, customIndex, customKind, customID properties when configuring standard buttons

[1.1.5] - 2026-01-22

Fixed

• Custom pet buttons: Pet availability check now filter-independent
  • Previously, custom pet buttons would grey out if the pet journal had an active search filter
  • Changed from GetNumPets()/GetPetInfoByIndex() (filter-affected) to GetOwnedBattlePetString() (filter-independent)
  • Pet buttons now correctly show as available regardless of pet journal search state
  • Fix persists across /reload (previously required logout/login to clear)

[1.1.4] - 2026-01-22

Added

• Custom Utility Slots: Add your own spells, toys, mounts, and battle pets to the Utility Bar
  • Use /gtb add [link] after shift-clicking items from spellbook/toy box/mount journal/pet journal
  • Supports class spells, profession panels, toys, mounts, and battle pets
  • Automatically displays cooldowns for toys and spells
  • Greys out unavailable items with helpful tooltips (e.g., "Mount not collected", "Spell not learned")
  • Remove custom buttons with shift+right-click
  • No limit on number of custom slots (limited only by bar layout space)
  • Config option to hide all custom buttons with a single toggle

Changed

• Memory optimization: Reduced memory usage during combat
  • Throttled cooldown event updates to 3x per second (from ~10x per second)
  • Cached element table references in LayoutHUD to reduce garbage collection
  • Optimized speed ticker to skip unnecessary table creation
  • Combined: ~15-20% reduction in combat memory footprint

Fixed

• Secret value handling: Improved Midnight (12.0+) compatibility
  • Added pcall wrappers to Gold.lua loot message handler
  • Added pcall wrapper to UtilityBar.lua cooldown info access
  • Prevents "attempt to perform operation on secret value" errors in dungeons/instances

Removed

• v1.1.0 update notice: Removed one-time popup notification for v1.1.0 bar layout changes
  • Cleanup of temporary user communication code
  • Prevents StaticPopup frame pollution that could affect other addon dialogs

[1.1.3] - 2026-01-21

Fixed

• Comprehensive secret value handling: Replaced InCombatLockdown() guards with pcall() wrappers
  • Secret values can appear outside of combat lockdown, making the lockdown check insufficient
  • All tooltip data processor callbacks now wrapped in pcall
  • Shard ID extraction from UnitGUID now wrapped in pcall
  • Tooltip duplicate ID checks now wrapped in pcall
  • Features gracefully degrade (skip updates) when secret values are encountered

[1.1.2] - 2026-01-21

Fixed

• Tooltip ID duplicate check: Added InCombatLockdown() guard to tooltip text reading
  • type() function returns the expected type even for secret values, so type checks don't help
  • Duplicate ID detection now skipped during combat (worst case: duplicate lines, which is harmless)

[1.1.1] - 2026-01-21

Fixed

• Midnight (12.0) compatibility: Fixed combat errors caused by "secret values" in spell cooldown API
  • C_Spell.GetSpellCooldown() returns protected values during combat that cannot be used in boolean tests or comparisons
  • Utility bar cooldown updates now skip reading spell cooldowns during combat to prevent errors
  • Affects: UtilityBar.lua, Core.lua

Technical

• Added InCombatLockdown() guards to GetSpellCooldown() API wrappers
  • Returns safe defaults (0, 0, 1) during combat instead of reading secret values
  • Cooldown displays update normally when out of combat

[1.1.0] - 2026-01-20

Added

• Minimap button: Quick access to GTB configuration via minimap icon
  • Uses LibDBIcon-1.0 for maximum compatibility with minimap managers
  • Left-click to open/close menu
  • Right-drag to reposition around minimap rim
  • Toggle visibility via Options panel → General → "Minimap button" checkbox (account-wide setting)
  • Position persists across sessions
• Per-bar scaling: Each bar (Item Tracker, Currency Tracker, Utility Bar) now has independent scale control (0.5x to 2.0x)
  • Configurable in Options panel under each bar's section
  • Scale adjustments no longer cause position drift (see Technical section)
• Buttons per row configuration: All three bars now support wrapping to multiple rows
  • Item Tracker: 1-20 buttons per row
  • Currency Tracker: 1-20 buttons per row
  • Utility Bar: 1-12 buttons per row
• Growth direction controls: Choose how bars expand when adding items
  • Horizontal growth: LEFT or RIGHT
  • Vertical growth: UP or DOWN
  • Four corner anchoring options (e.g., grow right+down from top-left corner)
• One-time update notice: Account-wide popup on first login explaining v1.1.0 bar layout changes
  • Includes "Reset Bar Positions" button for easy recovery if bars shifted
  • "Don't show this again" checkbox to permanently dismiss
  • Will be removed in v1.1.1 (temporary notification only)

Changed

• Reset All Settings now properly resets all UI/display settings to defaults
  • Preserves user behavioral preferences: session persistence, AFK auto-pause, TSM source, load message setting, account label
  • Uses deep copy from DEFAULTS table to ensure complete reset
• Reset Bar Positions: New dedicated function to reset only bar positions (not HUD)
  • Accessed via Options panel or v1.1.0 update notice popup
  • HUD position remains unchanged when resetting bars

Fixed

• Session pause state restoration: Fixed "Manually Paused" flag appearing incorrectly after logout/reload
  • AFK-paused sessions now auto-resume on login (no longer incorrectly show "Manually Paused")
  • Manually-paused sessions correctly remain paused across logout/reload
  • Root cause: pausedByAFK flag now properly saved/restored in session state
• Bar position persistence: Scaling a bar no longer causes position drift on reload/logout
  • Bars now remember exact positions regardless of scale changes
  • Growth direction changes no longer shift bar position
• Empty bar appearance: Add button (+) on empty bars now properly square (not rectangular)
• Empty bar dragging: Fixed drag functionality on empty bars after visual fix

Technical

• Midnight (12.0.0) compatibility: Full support for WoW Midnight launch
  • Migrated to modern C_Item and C_SpellBook namespaced APIs (19 deprecated API call sites replaced)
  • Replaced COMBAT_LOG_EVENT_UNFILTERED shard detection with PLAYER_TARGET_CHANGED and UPDATE_MOUSEOVER_UNIT events (combat log restrictions workaround)
  • Fixed SaveUtilityBarPositionOnLogout nil method error (session persistence now reliable on logout/reload)
  • Graceful degradation for combat log restrictions with pcall wrapper and version gating
  • All deprecated API usage eliminated (addresses community feedback from Larsj_02)
• Modern API wrappers: Added centralized addon.API compatibility layer for future-proofing
  • GetItemInfo, GetItemInfoInstant, GetItemCount, GetItemSpell → C_Item namespace
  • IsSpellKnown → C_SpellBook.IsSpellKnown (corrected from non-existent C_Spell.IsSpellKnown)
  • Added GetVendorSellPrice helper to replace select(11, GetItemInfo) patterns
  • No legacy fallbacks (12.0+ only), cleaner codebase
• Config global leak fix: Fixed trackersSection undefined variable in Config.lua sections table
• Library dependencies: GTB now vendors LibStub, CallbackHandler-1.0, LibDataBroker-1.1, and LibDBIcon-1.0 for minimap button functionality
  • First external dependencies for GTB (chosen for minimap manager compatibility)
  • Packaged via .pkgmeta externals (automatically pulled during CurseForge builds)
  • SavedVariables schema updated: db.global.minimap = { hide = false, minimapPos = 220 }
• Anchor-container architecture: Implemented separation of position (unscaled anchor frame) from visual rendering (scaled content frame)
  • Anchor frame handles position/movement, never scales
  • Visual content frame handles layout/scaling, always positioned relative to anchor
  • Eliminates coordinate conversion errors that caused position drift
• Schema version: Fresh installs now default to schemaVersion 5 (no unnecessary migrations)
• SavedVariables cleanup: Improved handling of bar position data with anchor-based storage

[1.0.7] - 2026-01-18

Added

• Menu Lock/Unlock option: New "Lock frames" checkbox in General settings (mirrors HUD title bar lock icon for better discoverability)
• Load message toggle: "Show load message" checkbox to suppress/enable addon loaded chat print (account-wide setting)
• Utility action confirmations: Single "Add confirmation step for sensitive actions" toggle for Logout, Reload, and Mailbox buttons
  • Shows StaticPopup-style confirmation dialogs (respects out-of-combat restrictions)
  • Works only when respective buttons are enabled
  • Default OFF to preserve current behavior
• Currency count centering: Currency tracker count overlay now centered for consistency with item tracker styling
• Gold per hour toggle: New "Show gold per hour values" option to hide /h values without changing other displays
• Draggable tracker/currency bars: Click and drag the green + icon on item tracker and currency tracker bars to reposition them
  • Preserves existing click-to-chat and item-drop functionality

Fixed

• Warband bank integer overflow: Removed unsafe %d formatting for copper values in bank transfer debug logs (prevents overflow with large values)
• Session persistence icon visibility: Icon now correctly hides when Gold & Economy module is disabled, collapsed, or minimized
• Child option parent enabling: Enabling a child option now auto-enables the parent module before applying (fixes "I enabled something but nothing shows" confusion)

Technical

• Debug logging for bank transfers now uses safe string formatting for all copper values
• Confirmation popups use Blizzard SecureActionButtonTemplate for Logout/Reload (respects combat lockdown)
• Mailbox confirmation uses custom handler for compatibility with secure action buttons

[1.0.6] - 2026-01-16

Added

• Reset Instances button: New utility bar button for resetting dungeon instances (disabled by default)
  • Requires party leader when grouped
  • Grey overlay when unavailable with tooltip explanation
  • Configurable via Options > Utility Bar

Fixed

• Character Note editbox: Improved text visibility by fixing frame level ordering to ensure editbox renders above background

Documentation

• Comprehensive release workflow instructions added to CLAUDE.md and AGENTS.md
• README.md features section updated to reflect all v1.0+ capabilities
• CHANGELOG.md backfilled with missing v1.0.0-1.0.3 release history

[1.0.5] - 2026-01-15

Added

• Session Persistence Indicator: Added a new visual status icon to the HUD's Gold & Economy section
  • Uses a "Swirl" icon (ability_evoker_innatemagic4) to represent session continuity
  • Bright Green: Persistence enabled (session survives logout)
  • Faded Grey: Persistence disabled (session resets on logout)
  • Features a dedicated tooltip explaining the current persistence state and how to change it

Fixed

• HUD Tooltip Rendering: Replaced unsupported Unicode arrow characters (→) with standard signs (>) to fix "box" artifact rendering in some locales
• Session Timer Tooltip: Expanded the pause button's interactive area to cover the timer text, ensuring the session controls tooltip appears reliably when hovering over the duration
• Shard ID Tooltip: Implemented "Smart Tooltip" logic that hides the Shard ID help text when the element is disabled in settings, preventing it from appearing over the movement speed text
• Tooltip Consistency: Standardized colors and formatting across all HUD and Bar tooltips using GTB's gold/grey/silver palette

Technical

• Updated .pkgmeta and .gitignore to strictly exclude internal AI configuration (.cursor/, AGENTS.md) and technical design documentation (DesignDoc.txt) from CurseForge distribution and public repository history

[1.0.4] - 2026-01-13

Changed

• Header button sizes: Increased lock and minimize button sizes by 30% for better visibility
  • Lock button: 20px → 26px
  • Minimize button: 16px → 26px (now matches lock button size)
  • Addresses user feedback about buttons being too small and easy to miss
• Guild bank clarity: Changed "Visit" to "Visit GBank" to match the "GBank:" label added in v1.0.2

[1.0.3] - 2026-01-12

Added

• Shift+Right-click removal: Utility bar buttons can now be removed by Shift+Right-clicking them
• Housing Teleport button: New utility bar button for quick housing teleport (disabled by default)
• Logout/Reload buttons: Optional utility bar buttons for quick logout and UI reload (disabled by default)

Fixed

• Item tracker bar visibility: Fixed issue where tracker bar wouldn't hide when HUD was disabled
• Combat UI updates: Improved combat safety checks to prevent taint issues
• Hearthstone detection: Fixed hearthstone button not working when physical hearthstone is in bags

[1.0.2] - 2026-01-11

Changed

• Guild bank label: Updated guild bank display from "Guild:" to "GBank:" for consistency
• Unavailable button overlay: Added grey desaturation overlay to utility buttons when not usable
• Tooltip improvements: Added explanatory tooltips to unavailable utility buttons

[1.0.1] - 2026-01-10

Fixed

• Session tracking: Fixed session reset on logout when persistence was enabled
• Posted auctions: Corrected commodity item value calculation (now properly multiplies by quantity)
• Minor UI adjustments: Improved spacing and alignment in HUD sections

[1.0.0] - 2026-01-09

Added

• Initial public release
• Profile system: Create, copy, and switch between named profiles per character
• Character notes: Per-character note field for labeling alts (up to 500 characters)
• Session persistence: Optional session data persistence across logouts with visual indicator
• AFK auto-pause: Automatic session pause when player goes AFK
• Bank transfer neutralization: Deposits/withdrawals to guild/warband banks don't affect session net
• Multi-source item tracking: Track items across inventory, player bank, and warband bank
• Rank-aware tracking: Separate tracking for tiered reagent ranks
• Grey overlay system: Visual feedback for unavailable utility buttons
• Interactive tooltips: Comprehensive tooltip system across all HUD elements
• Account label: Custom account-wide identifier display
• Token trend detection: Visual indicator for WoW Token price trends

Technical

• Schema version 5 with migration system for saved variables
• Event-driven architecture with debounced UI updates
• Combat-safe frame management with taint prevention
• Modular codebase with clear separation of concerns