Forever Trinket Menu

# Forever Trinket Menu - v1.2.4

A lightweight, modern trinket manager built specifically for **WoW Forever (Classic+ / Interface 16001)** and **Classic Era**.

---

### 🌟 What's New in v1.2.4 (Bug Fix & Stability Update)
- **Fixed mouse hover nil error**: Resolved BugGrabber crash (`TrinketMenu.lua: attempt to call a nil value`) when hovering over equipped trinkets with certain non-cached items in your bags (e.g., Hearthstone).
- **Blizzard C_Item API Modernization**: Fully updated item querying to natively prioritize `C_Item.GetItemInfo` and `C_Item.GetItemInfoInstant` with seamless fallback for older classic clients.
- **Asynchronous Data Preloading**: Integrated `C_Item.RequestLoadItemDataByID` to safely preload uncached bag items without freezing or throwing Lua errors.
- **Timer Safety Guard**: Added null-checks to `C_Timer.After` inside the flyout auto-hide logic for guaranteed stability across all client builds.

---

### ⚡ Key Features

1. **Compact & Dynamic Frame**:
   - Displays both equipped trinkets with countdown timers and cooldown spirals.
   - Combat-safe one-click usage (`/use 13` and `/use 14`), even while stunned or incapacitated.

2. **Flyout Bag Grid**:
   - Hover or right-click any trinket slot to reveal all available trinkets in your bags.
   - Clean, customizable grid layout (2, 3, 4, or 6 columns).

3. **Combat Swap Queue**:
   - Click any trinket in your bags during combat to queue it with a glowing golden border.
   - The addon automatically equips it the exact split-second you leave combat.

4. **Priority Auto-Queue**:
   - Alt-click trinkets in the flyout menu to build a priority queue (Rank 1, 2, 3...).
   - When your active trinket goes on cooldown, the addon automatically swaps to the next available one when combat ends.
   - If a higher-priority trinket finishes its cooldown in your bags, it swaps back in automatically.

5. **Native WoW Keybindings**:
   - Bind dedicated keys for "Use Trinket 1" and "Use Trinket 2" directly in *Escape -> Options -> Keybindings -> Trinket Menu*.

6. **360° Draggable Minimap Button**:
   - Smoothly drag the minimap icon around any circular or square minimap.
   - Shift-click to quickly lock or unlock the window.

7. **Ready Alerts**:
   - Subtle pulse animation in the center of the screen (CooldownPulse style) and gentle sound alert when a trinket is ready.

8. **Customizable Frame & Menu Borders**:
   - Hide the main frame border (`/tm border`) and the flyout menu border (`/tm menuborder`) independently without unlocking window movement.
   - Shift-drag directly from the trinket icons to reposition the window anytime.

9. **Leveling BiS Advisor Integration**:
   - If you also run **Leveling BiS Advisor**, trinkets recommended for your class and spec are automatically highlighted with a golden star badge.

---

### 💻 Slash Commands

| Command | Description |
| :--- | :--- |
| `/tm` | Show or hide the main trinket frame |
| `/tm opt` | Open options panel and Auto-Queue manager |
| `/tm auto` | Toggle automatic rotation on or off |
| `/tm cols <1-8>` | Set number of columns in the flyout grid (e.g. `/tm cols 4`) |
| `/tm scale <0.7-1.5>` | Adjust frame scale (e.g. `/tm scale 1.1`) |
| `/tm lock` / `/tm unlock` | Lock or unlock frame position |
| `/tm border` | Toggle main frame border on/off |
| `/tm menuborder` | Toggle flyout menu border on/off |
| `/tm lang auto\|en\|es` | Set addon language |

---

### 📥 Installation
1. Download `ForeverTrinketMenu-v1.2.4.zip`.
2. Extract the archive into your `World of Warcraft/_classic_beta_/Interface/AddOns/` (or `_era_/Interface/AddOns/`) folder.
3. Ensure the folder is named `TrinketMenu` inside `AddOns/`.
4. Launch the game and enjoy!