tinkerline / addons / voidraidtoolsreader

VoidRaidToolsReader

A WoW raid encounter logger addon — the silent companion to VoidRaidTools. Records boss cast events and party aura traces during raid encounters so the alert engine has real fight data instead of timer-only guesses.

Required for VoidRaidTools Opt-in upload Local-only mode Transparent storage MIT license

01What it does

VoidRaidToolsReader is the data-collection backend that makes VoidRaidTools work. While you raid, it quietly logs the things the alert engine needs to react accurately to a given fight — boss cast events, friendly aura traces on your party, encounter outcomes, your own position over time.

None of it shows on your screen. The Reader has no UI during combat. It does have a small panel for inspecting what was recorded, and a consent dialog the first time you log in.

02What it records

Encounter data only

  • Boss cast events

    The Reader captures ENCOUNTER_TIMELINE_EVENT_ADDED payloads with clean spell ID resolution. This is how the alert engine learns the actual cast timing patterns for new bosses without me hand-coding them all.

  • Friendly aura traces

    Buffs and debuffs that land on your party during the encounter — so role-based alerts (interrupt rotation, dispel prioritization) have ground truth instead of guesses.

  • Encounter metadata

    Encounter ID, difficulty, group composition, kill/wipe outcome, timestamps. Standard log fields.

  • Your own position

    Periodic snapshots of where you stood during the fight — yourself only, never other players.

What it never records

  • Chat

    Nothing said in any chat channel is logged or uploaded. Ever.

  • Gear, inventory, currency

    Your character sheet is none of the Reader's business.

  • Other addon data

    The Reader doesn't peek at WeakAuras strings, DBM profiles, or any other addon's SavedVariables.

  • Anything outside active encounters

    Recording starts on encounter pull and stops on wipe/kill. World content, dailies, AH browsing — invisible to the Reader.

03How consent works

First-login dialog

  • Two choices, both work

    On the first login after install, the Reader pops a dialog asking whether you'd like to (A) record locally and upload anonymous encounter data, or (B) record locally and never upload anything. Both modes let VoidRaidTools function — the upload mode just helps the mechanic-detection engine improve across the player base.

  • Change anytime

    Toggle between modes whenever you want via the Reader's control panel.

  • Inspect before send

    Use /vrtsr queue to see the pending upload queue before anything goes out. Nothing is sent that you haven't been able to read first.

Slash commands

  • /vrtsr

    Open the Reader control panel — toggle upload, inspect stored sessions, set retention.

  • /vrtsr queue

    Inspect the pending upload queue before anything is sent.

04Install

The Reader is required by VoidRaidTools — install both. Once enabled, you should never see the Reader again unless you open it on purpose.

05More from the workshop