Tamuko's TWW Helper

A lightweight World of Warcraft addon that collects weekly/seasonal chores and progress into a clean, compact set of progress bars. Built for The War Within, adaptable to other expansions.

Disclaimer: This addon (and its documentation) is vibe coded. It’s pragmatic, iterated quickly, and may evolve without ceremony. Expect sharp edges. Use at your own risk and enjoy the vibes.

Features

• Unified progress UI with module headers and compact bars
• Modules (enable/disable individually):
  • Timers: Beledar's Shadow, Theater Troupe  
  • Bountiful Delves: 15 delves across TWW zones, waypoints 
  • Factions: 8 TWW major/minor factions with renown progress  
  • Great Vault: M+, Raid, Delves tiers   
  • Currency: Crests, PvP sets, individual items/currencies   
  • Weekly Quests: 10+ weekly activities   
  • Professions: 11 professions × 6 activity types (chest, treatise, etc.)   
  • Mythic+: Party/Raid/Guild keystones via libraries, own key fallback   
  • Rares: 60+ rares with tooltips and waypoints   
  • Character Stats: 30+ stats grouped by category
• Auto-Visibility: Show/hide the frame based on zone, instances, or resting
• Minimal dependencies (LibSharedMedia optional)

Installation

1. Download
2. Place the TamukosTwwHelper folder into your WoW Interface/AddOns/ directory.
3. Launch WoW and enable the addon.

Usage

• Toggle and utilities (defaults):   - /twwh toggle — Show/Hide the frame  
• /twwh reset — Reset frame to center  
• /twwh debug — Show module status  
• /twwh test — Force timer update   
• /twwh delves — Delves debug output   
• /twwh keys — Mythic+ library status   
• /twwh waypoint — Clear delve waypoints   
• /twwh config — Open the settings UI
• Open Settings via Interface → AddOns → Tamuko's TWW Helper.

Note: Slash commands are configurable. See Configuration → Data-Driven below.

Auto-Visibility

Settings: Interface → AddOns → Tamuko's TWW Helper → Auto Visibility

• Enable Auto Visibility
• Show in (zones/continent)
• Show Outside (bypass zone restriction)
• Show in Dungeons/Raids/Delves
• Show While Resting

Behavior: All enabled toggles act as requirements. Example: If "Show in Dungeons/Raids/Delves" is enabled, the UI shows only inside instances, even if you also allow showing outside tracked zones.

Troubleshooting

• Help text: Running /twwh with no parameters prints available commands.
• Nothing prints in chat? Enable debug in settings, or note that user-facing help is printed regardless of debug.
• Auto-visibility doesn’t show in Dornogal? Zone detection uses IDs and a parent-chain; Dornogal (2339) is included by default.
• Mythic+ guild keys not showing? Requires LibKeystone (DBM/BigWigs) or LibOpenRaid (Details) with guildmates broadcasting.
• SavedVariables: WTF/Account/<Account>/SavedVariables/TamukosTwwHelper.lua

Credits & Inspiration

• Inspired by Haldu's WeakAura. This addon began as a native-addon reimplementation of the ideas in the original aura

Contributing

PRs and issues welcome. Keep changes minimal, focused, and aligned with the module architecture.

License & Disclaimer

License: GNU General Public License v3.0. See LICENSE.

Disclaimer: This project and documentation are vibe coded — crafted quickly, iterated often, and occasionally spicy. It may contain imperfections, unconventional choices, or undocumented quirks. Use at your own risk; contributions to improve clarity are encouraged.