Taming Tomes

Track every hunter taming tome in one beautiful interface.

🐾 What is Taming Tomes?

Taming Tomes is a comprehensive hunter taming tome tracker for World of Warcraft. It helps hunters track which special taming tomes they've collected, provides waypoints to tome sources, and offers detailed progress tracking across your entire warband.

Ever wondered if you've collected the "Tome of the Hybrid Beast" on your alt? Need to know where to farm the "Blood-Soaked Tome of Dark Whispers"? Want to track per-character tomes like "Ancient Tome of Dinomancy" across your hunter army? Taming Tomes has you covered.

✨ Features

Features

📚 Complete Tome Tracking

• Tracks all 11 hunter taming tomes from Classic through The War Within

• Color-coded status indicators (✓ Learned, ✗ Not Learned, Racial Ability)

• Progress bar with completion celebration when you collect them all

• Florafaun tome support (ready for when Blizzard adds API detection)

🗺️ Waypoint Integration

• One-click waypoints using TomTom or built-in map pins

• Smart waypoint creation for tome sources

• Zone change detection - alerts you when you enter an area with available tomes

👥 Warbard & Character Profiles

• Track progress across all your hunter characters

• Per-character tome tracking for tomes that need to be unlocked individually

• See which characters have which per-character tomes at a glance

• Color-coded status indicators for each character's progress

⏱️ Farming Tools

• Farming timer to track your farming sessions

• Estimated attempts calculator based on drop rates

• Reset timers for daily and weekly lockouts

• Farming statistics persistence

🔧 Quality of Life

• Auto-learn tomes from your bags (toggle on/off)

• Tooltip integration - see if you can tame a beast before engaging

• Inventory scanning with audible alerts

• Compact mode for more rows visible at once

• Fully movable and resizable main window

• Minimap button with progress indicator

⌨️ Slash Commands

Full slash command support with /tt:

Tracked Tomes

Racial Abilities (Auto-Detected)

Some races can tame certain families without needing the tome:

• Zandalari Troll → Direhorns (Ancient Tome of Dinomancy)

• Gnome → Mechanicals (Mecha-Bond Imprint Matrix)

• Goblin → Mechanicals (Mecha-Bond Imprint Matrix)

• Pandaren → Cloud Serpents (How to School Your Serpent)

Dependencies

• Optional: TomTom - Provides enhanced waypoint functionality (falls back to built-in map pins if not installed)

Slash Commands Quick Reference

/tt                 - Toggle main window
/tt missing         - List tomes you still need
/tt find "Tome"     - Quick waypoint
/tt mark "Tome"     - Mark per-character tome as learned
/tt unmark "Tome"   - Mark per-character tome as not learned
/tt startfarm "Tome" - Start farming timer
/tt stopfarm        - Stop farming timer
/tt estimate        - Show estimated attempts
/tt warband         - Show warband progress in chat
/tt profiles        - List all character profiles
/tt summary         - Quick progress overview
/tt debug           - Diagnostic report
/tt help            - Show all commands

FAQ

Q: Why isn't the Florafaun tome auto-detecting?
A: Blizzard hasn't added the spell to the hunter spellbook API yet. The addon is ready for when they do, and you can still manually track it in the tome list.

Q: How do per-character tomes work?
A: Some tomes (like Ancient Tome of Dinomancy) need to be learned on each character separately. Use the Profiles panel or /tt mark command to track which characters have them.

Q: Can I use this without TomTom?
A: Yes! The addon falls back to built-in map waypoints or provides /way commands you can copy to chat.

Q: How do I move the minimap button?
A: Shift + Drag the minimap button to reposition it.

📝 Changelog

Version 5.4 (Current)

• Fixed: Profiles panel buttons now update immediately when clicked

• Fixed: Button text and indicator dot colors update in real-time

• Fixed: Removed full panel refresh on button click (smoother experience)

• Added: Colored dot indicators for per-character tome status

• Improved: Better error handling for button text coloring

Version 5.3

• Fixed: Profiles panel button coloring (replaced broken SetTextColor with indicator dots)

• Improved: Profiles panel now uses colored dot indicators instead of colored button text

• Fixed: Various nil reference errors in button creation

Version 5.2

• Fixed: Button text color errors in Profiles panel

• Fixed: Proper font string access for button text coloring

• Improved: Better error handling for button color operations

Version 5.1

• Added: Redesigned Profiles panel with character progress tracking

• Added: Character list showing all hunters in your warband

• Added: Visual status indicators for per-character tomes

• Added: Clear "YOU" indicator for current character

• Added: Tooltips explaining per-character tome tracking

• Improved: Profiles panel now prevents editing other characters' progress

Version 5.0

• Fixed: Critical initialization order error causing "bad argument #1 to 'ipairs'" error

• Moved: tomes table definition to top of file for proper load order

• Improved: Complete restructuring of initialization sequence

• Fixed: Row visibility in UpdateStatuses function

• Added: Proper nil checking for all table iterations

Version 4.7

• Fixed: RowList initialization and nil table handling

• Added: Type checking before table iterations throughout the codebase

• Improved: Error protection in all UI update functions

Version 4.6

• Fixed: Persistent nil table errors during Ace3 initialization

• Added: Safe table iteration helper function

• Improved: Proper initialization of rowList and rowOriginalColors tables

Version 4.5

• Fixed: Critical nil table errors on addon load

• Added: Local reference optimization for better performance

• Improved: Status cache system to reduce redundant API calls

• Added: Debug mode for advanced troubleshooting

Version 4.4

• Fixed: Tooltip error protection with pcall wrappers

• Fixed: Timer cleanup in OnDisable (prevents memory leaks)

• Added: Cached trackable tome count for performance

• Added: Hunter class checks for event handlers

• Improved: Date parsing optimization using date("*t")

Version 4.3

• Added: Florafaun tome to database (API ready)

• Added: API pending status display for Florafaun

• Added: Excluded Florafaun from completion counts

• Improved: Tooltip handling for API-pending items

Version 4.2

• Added: Warband progress tracking

• Added: Character profile system

• Added: Per-character tome marking

• Added: Share progress to chat functionality

Version 4.1

• Added: Racial ability detection

• Added: Farm timer and statistics

• Added: Estimated attempts calculator

• Added: Reset timer displays

Version 4.0

• Initial Ace3 rewrite

• Added: AceConfig options panel

• Added: Compact mode

• Added: TomTom integration

• Added: Minimap button

v3.0

• Complete UI overhaul with WoW-style graphics

• Added 5-tab interface (Tomelist, Settings, Commands, Warband, About)

• Added warband progress sharing

• Added sort mode dropdown

• Added compact mode and description toggles

• AceConfig options panel integration

• Improved tooltips and visual feedback

v2.0

• Initial Ace3 migration

• Added all 11 tomes

• Minimap button with progress colors

• Auto-learn from bags

💬 Support

Found a bug or have a suggestion? Please leave a comment on CurseForge

Happy hunting, fellow Hunter! 🏹