Taming Tomes

📚 Core Features

Tome Database

• 11 tracked tomes covering all hunter tamable families across expansions:

  • MoP: Direhorns, Cloud Serpents

  • Legion: Mechanicals, Feathermanes

  • BfA: Blood Beasts

  • Shadowlands: Gargons, Undead Beasts

  • Dragonflight: Ottuks, Dragonkin, Nah'qi (Fireowl)

  • The War Within: Florafaun

Status Tracking

• Spell-based tracking - checks if your character has learned spell tomes

• Quest-based tracking - checks if quest completion tomes are completed

• Three status indicators:

  • ✓ Learned (Green) - you have this tome

  • ✗ Not Learned (Red) - you're missing this tome

  • ? Unknown (Yellow) - Quest ID not yet discovered (Florafaun)

Visual Interface

• Dark theme UI with purple/cyan accent colors

• Expandable scroll frame - fits all tomes in a compact window

• Per-tome display includes:

  • Tome name (large text)

  • Family badge (top-right)

  • Expansion badge

  • Per-character warning indicator (⚠)

  • Status dot with glow effect

  • Full description text

  • Source/location information

  • Waypoint button (when available)

---

🗺️ Waypoint System (Hybrid)

Smart Waypoint Detection

The addon automatically detects and uses the best available waypoint system:

1. TomTom priority - If TomTom is installed, uses TomTom's advanced waypoint system

2. Built-in fallback - Uses WoW's native map waypoints (Shadowlands+)

3. Text fallback - Prints /way command to chat if no system is available

Waypoint Tooltips

• Hovering over waypoint buttons shows which system will be used

• Displays any special notes about the waypoint location

Waypoint Data Included

• Map ID, coordinates (X/Y), and descriptive labels for each tome

• Special notes for complex locations (e.g., "Map ID approximate" for Florafaun)

---

🔍 Florafaun Discovery Tools

Special tools for the unknown Florafaun tome (Quest ID not yet public):

Commands

• /tt scanid <start> <end> - Scan a range of quest IDs for completed quests

• /tt setid <questid> - Manually set the Florafaun quest ID once discovered

• /tt idcheck - Legacy quick scan (80000-85000 range)

Features

• Saves discovered Quest ID to your saved variables

• Updates status from "Unknown" to "Learned/Missing" once ID is set

• Scans up to 10,000 IDs at a time (safety limit)

---

🖱️ Interface Features

Main Window

• Movable frame - Drag by title bar

• Close button - Standard UI close button

• Refresh button - Manually update all statuses

• Summary display - Shows "Learned: X / 11" at bottom

• Resizable content - Scroll frame adapts to content height

Minimap Button

• Book icon on minimap (top-right by default)

• Click to toggle main window

• Shift-drag to move - Position saves between sessions

• Hover tooltip shows instructions

---

⌨️ Slash Commands

---

🎨 Visual Design

Color Scheme

• Primary: Purple (0.78, 0.53, 0.99)

• Accent: Cyan (0.20, 0.80, 1.00)

• Text: Light gray-white (0.90, 0.90, 0.95)

• Background: Dark themed (0.05, 0.05, 0.08)

• Alternate row: Slightly lighter dark (0.08, 0.08, 0.12)

Status Colors

• Known (Learned): Bright Green (0.30, 0.95, 0.40)

• Missing: Bright Red (0.95, 0.30, 0.35)

• Unknown: Bright Yellow (0.95, 0.85, 0.20)

Row Backgrounds

• Known: Dark green tint

• Missing: Dark red tint

• Unknown: Dark yellow/gold tint

---

💾 Saved Variables

• TamingTomesDB.florafaunQuestID - Stores discovered Florafaun quest ID

• TamingTomesDB.minimapButtonPosition - Saves minimap button position

• TamingTomesDB.minimapButtonHidden - (Reserved for future hide feature)

---

⚙️ Technical Features

• Account-wide tracking - Supports both account-wide and per-character tomes

• Spell ID detection - Uses IsPlayerSpell() for spell-based tomes

• Quest completion detection - Uses C_QuestLog.IsQuestFlaggedCompleted()

• Error handling - Graceful fallbacks for missing dependencies

• No external dependencies required - Works standalone, enhances with TomTom

• Memory efficient - Reuses frames, minimal saved variables

---

📦 Included Tomes

---

🔧 Compatibility

• WoW Version: Shadowlands and later (requires C_Map.SetUserWaypoint for built-in waypoints)

• TomTom: Optional - enhances waypoint functionality

• No conflicts - Uses unique frame names and global variables

---

📝 Notes

• Per-character tomes show an orange "⚠ Per-Character" warning

• Zandalari Trolls, Gnomes, and Goblins have racial bonuses noted in descriptions

• The Florafaun tome requires manual Quest ID discovery using the scan tools

---

Version 1.6 - Fixed waypoint button errors, added hybrid waypoint system, improved error handling