DungeonFarmer

DungeonFarmer is a small WoW Retail addon that tracks your dungeon lockout activity across a rolling hour.

It adds a color-coded n/10 count to the minimap difficulty tooltip, keeps a retained cross-character log, and can optionally mirror the same information on Titan Panel.

Hover the existing instance difficulty indicator beside the minimap while inside an instance to see the count and countdown. DungeonFarmer does not add a separate minimap button; use /df to check your count anywhere.

Features

• Tracks dungeon runs account-wide through a SavedVariables log
• Keeps one log row per run and updates that row while you move in and out of the same unreset instance
• Starts a new row when a reset is detected
• Shows a color-coded n/10 lockout count
• Shows the remaining time until the next lockout falls off
• Prints status to chat with /df or /dungeonfarmer
• Prints the retained run log with /dflog
• Prints your total time inside the current run to your own chat when you leave a dungeon
• Adds optional Titan Panel support with the same count and countdown tooltip

Commands

• /df Prints the current lockout count and next falloff timer.
• /dungeonfarmer Same as /df.
• /df log Prints the retained run log.
• /dflog Same as /df log.

Installation

Copy the DungeonFarmer folder into:

World of Warcraft\_retail_\Interface\AddOns\

How Tracking Works

• Each stored run records entry time, latest exit time, realm, character, instance name, instance ID, and reset sequence.
• Re-entering the same unreset dungeon updates the same stored run instead of creating a duplicate row.
• Time spent inside the same run adds up across visits until a reset, including time spent dead or idle inside. Time outside between visits is excluded. Leaving prints a private message such as "[DungeonFarmer] The Botanica — you've clocked 4 minutes 32 seconds this run." Durations show only nonzero hours, minutes, and seconds. The timer survives /reload and relogging inside the dungeon.
• Reloading or logging in inside a dungeon resumes an already-open row. If the latest matching row is already closed, the addon creates a new row.
• Active lockout timing uses exitTime + 60 minutes when an exit is known.
• If a run is still open and has no exit time yet, the addon falls back to entryTime + 60 minutes.
• Retained log rows stay for 90 minutes based on the most recent activity on that run so recent debugging data remains visible after the active lockout has fallen off.

Titan Panel

If Titan Panel is installed and enabled, DungeonFarmer adds a plugin that shows:

• a colored n/10 counter
• the same countdown tooltip
• live tooltip refresh while the tooltip is open
• left-click log printing through the normal addon log output

Enable DungeonFarmer from Titan Panel's plugin menu if it is not already displayed on a bar.

Configuration

The main tuning values live at the top of DungeonFarmer.lua:

• MAX_DUNGEONS_PER_HOUR
• GREEN_COLOR_COUNT_THRESHOLD
• ORANGE_COLOR_COUNT_THRESHOLD
• RED_COLOR_COUNT_THRESHOLD

Notes And Limitations

• This addon is written for WoW Retail.
• Minimap support uses the default instance difficulty indicator, including its guild-group tooltip, and does not depend on the game's language. UI replacements must preserve that control for this integration to work.
• Reset detection currently relies on the ResetInstances() API hook plus reset-related UI/system messages. Non-standard reset flows may still need additional tuning.
• Titan support is optional and only activates when Titan Panel is available.

Changelog

1.0.2

• Fixed secret-value errors caused by inspecting unrelated tooltip text. Minimap support now hooks the instance difficulty control directly.
• Fixed Titan Panel support being silently disabled by a check for an obsolete registration function.
• Fixed the Titan plugin's Hide menu entry to use Titan Panel's localized helper.

1.0.1

• Added run time tracking.

1.0.0

• Initial release.

License

MIT. See LICENSE.