FFLogs Viewer

Purpose & User Intent: The tool solves the exact problem of retrieving, filtering, and summarizing FFLogs data for raids. Users are raid analysts, guild leaders, and theory-crafters who need to inspect DPS, uptime, and ability usage across fights. When a team finishes a raid, they use it to quickly assess performance, compare fights, and identify outliers without manual log parsing.
Core Logic & Features: The tool connects to the FFLogs API, applies user-selected filters (region, server, character, fight, time range), and computes metrics. Required: region, server, fight, start_time, end_time. Optional/advanced: ability breakdown, data export, percentile normalization, and historical comparison. It enforces rate limits and caches results to minimize API calls.
Inputs & Outputs: Inputs include region (US/EU), server, character (optional), fight, start_time and end_time (ISO8601), and limit. Outputs include total_dps, average_dps, max_dps, dps_by_second, damage_by_ability, and a short, formatted_summary. Units: DPS in damage per second; times in UTC. Validation ensures required inputs, valid region, and valid fight.
Algorithms & Calculations: DPS = totalDamage / duration_seconds. Peak_dps is max over per-second windows. Ability breakdown sums damage and DPS per ability; percentile ranking compares runs against historical buckets. Data from FFLogs is parsed and cached for efficiency.
Error & Edge Cases: Missing inputs trigger precise errors; data gaps or API failures yield partial results with clear labels; rate limits raise temporary notices; invalid time ranges or unseen fights return empty results with codes.
Industry/Region & Localization: Regions US/EU supported; times UTC; numeric formatting follows locale where applicable. Assumptions & Exclusions: Assumes FFLogs API availability and stable data schema; excludes live streaming, in-application rotation coaching, or raw log editing.