AdaptiveRotationTrainer Damagemeter plugin

# AdaptiveRotationTrainer_DamageMeter

**AdaptiveRotationTrainer_DamageMeter** is an optional plugin for **Adaptive Rotation Trainer** that provides spell-performance and damage observation tools for ART.

This plugin is designed to help players and testers understand how much damage each spell contributed during combat, where supported by the current World of Warcraft client.

It works as a separate ART-dependent module and does not replace ART’s rotation analysis. Instead, it adds extra observed performance data that ART can use as additional low-weight evidence.

## Requirements

This plugin requires:

- Adaptive Rotation Trainer

Adaptive Rotation Trainer must be installed and enabled.

## What It Does

AdaptiveRotationTrainer_DamageMeter provides damage and spell-performance summaries for combat sessions.

Depending on what the game client safely exposes, it can show:

- damage done per spell;
- estimated DPS contribution per spell;
- total observed damage;
- session-level spell performance;
- estimated damage-per-cast when ART cast counts are available;
- plugin write-back status;
- accepted and rejected observation counts.

The plugin can report observed spell-performance data back to ART through ART’s controlled external observation API.

## ART Write-Back Support

The Damage Meter can write observed post-combat data back to Adaptive Rotation Trainer.

This data is stored separately as external observation data.

It does not directly overwrite:

- ART learned priority;
- Builder rotations;
- recommended rotations;
- macro exports;
- GSE exports.

ART validates the submitted data before accepting it.

This allows damage observations to improve ART’s analysis without allowing unsafe plugin data to corrupt the core learning model.

## Retail / Midnight Safety

This plugin does not register or use:

COMBAT_LOG_EVENT_UNFILTERED