Trinket Tracker Swapper

TrinketTracker: Smart Trinket Management for World of Warcraft

TrinketTracker is a user-friendly addon designed to help players efficiently manage their trinkets (accessories) in World of Warcraft. It provides a customizable display frame for tracked trinkets, showing icons, cooldowns, and equipped status, while offering advanced features like automatic swapping and re-equipping based on user-defined priorities. Perfect for raiders, PvPers, and anyone who frequently switches trinkets during gameplay.

Key Features:

• Trinket Tracking and Display:
  • Add trinkets by Item ID or by scanning your bags/inventory.
  • Customizable frame: Adjust icon size, spacing, direction (horizontal or vertical), and position. Lock/unlock the frame for easy dragging.
  • Visual indicators: Borders (green for slot 13/left, gold for slot 14/right) and letters (G/D for Gauche/Droite) to show equipped slots. Tooltips on hover (optional).
  • Cooldown overlays: Real-time cooldown timers on icons.
  • Colors for status: Red if not found, yellow if not tracked, dimmed if in combat and unequipped.
• Auto-Swap System:
  • When a trinket is used (detected via cooldown or buff), automatically swap it with the highest-priority available trinket from your custom list (must be in bags, off cooldown, and not equipped).
  • Define priority lists per trinket: Set which trinkets to swap to, and reorder them (up/down arrows).
  • Combat handling: Delay swaps until out of combat (default) or swap immediately if enabled. Buff-aware: Waits for active buffs to expire before swapping.
  • Global toggle: Enable/disable auto-swap globally.
• Auto-Reequip System:
  • Automatically re-equip tracked trinkets when out of combat, if their cooldown is ≤30 seconds.
  • Priority-based: Higher-priority trinkets replace lower ones. Absolute priority option to always equip specific trinkets.
  • Monitors slots: Fills empty slots or replaces non-tracked/cooldown-locked trinkets.
• Configuration and Commands:
  • Slash commands: /tt or /trinkettracker to open config, reset position, show/hide frame, or debug.
  • Full UI panel: Tabs for Trinkets (add/remove/scan), Auto-Swap (set priorities), and Settings (frame options, toggles for borders/letters/tooltips, debug mode).
  • Per-character tracking: Saves trinkets and settings per character.
• Compatibility and Performance:
  • Works with all WoW versions (Classic, TBC, Wrath, Retail) using compatible APIs (e.g., C_Container for modern versions).
  • Lightweight: No heavy dependencies; uses built-in WoW functions.
  • Debug mode: Optional logging for troubleshooting.
  • Handles edge cases: Death/resurrection delays, combat lockdowns, and shared cooldowns.

How to Use:

1. Install via your addon manager (e.g., CurseForge app) or manually extract to Interface/AddOns/TrinketTracker.
2. In-game, type /tt to open the config panel.
3. Add trinkets via ID or bag scan in the "Trinkets" tab.
4. Set up auto-swap priorities in the "Auto-Swap" tab (select a source trinket and add targets).
5. Customize display in the "Settings" tab.
6. The frame appears near your character; drag it when unlocked.

Notes:

• Requires no external libraries.
• Feedback welcome! Report issues on the addon's page.
• Version: 1.0.0 (as per code).

Enhance your gameplay by never missing a trinket swap again!