FFLogs Viewer

Zweck & Benutzerintent: Das Tool löst das konkrete Problem des Abrufs, der Filterung und der Zusammenfassung von FFLogs-Daten für Raids. Benutzer sind Raid-Analysten, Gildenleiter und Theorycrafters, die DPS, Uptime und Fähigkeitsnutzung über Kämpfe hinweg prüfen müssen. Wenn ein Team einen Raid beendet, nutzt es das Tool, um Leistung schnell zu bewerten, Kämpfe zu vergleichen und Ausreißer zu identifizieren, ohne manuelle Logdateien auszuwerten.
Kernlogik & Funktionen: Das Tool verbindet sich mit der FFLogs-API, wendet vom Benutzer ausgewählte Filter an (Region, Server, Charakter, Kampf, Zeitraum) und berechnet Kennzahlen. Erforderlich: Region, Server, Kampf, Startzeit, Endzeit. Optional/fortgeschritten: Fähigkeitsauflistung, Datenexport, Perzentil-Normalisierung und historischer Vergleich. Es erzwingt Ratenbegrenzungen und cached Ergebnisse, um API-Aufrufe zu minimieren.
Eingaben & Ausgaben: Eingaben umfassen Region (US/EU), Server, Charakter (optional), Kampf, Startzeit und Endzeit (ISO8601) sowie Limit. Ausgaben umfassen Total-DPS, Durchschnitts-DPS, Max-DPS, DPS-pro-Sekunde, Schaden pro Fähigkeit und eine kurze, formatierte Zusammenfassung. Einheiten: DPS in Schaden pro Sekunde; Zeiten in UTC. Validierung stellt erforderliche Eingaben, gültige Region und gültigen Kampf sicher.
Algorithmen & Berechnungen: DPS = GesamtSchaden / DauerSekunden. Peak-DPS ist der Höchstwert über Per-Second-Fenster. Fähigkeitsauflistung summiert Schaden und DPS pro Fähigkeit; Perzentil-Ranking vergleicht Läufe mit historischen Buckets. Daten aus FFLogs werden geparst und effizient gecached.
Fehler & Randfälle: Fehlende Eingaben lösen präzise Fehler aus; Datenlücken oder API-Fehler führen zu Teilergebnissen mit Kennzeichnungen; Ratenbeschränkungen erzeugen vorübergehende Hinweise; ungültige Zeiträume oder unbekannte Kämpfe liefern leere Ergebnisse mit Codes.
Branchen-/Region & Lokalisierung: Unterstützte Regionen US/EU; Zeiten UTC; numerische Formate locale-abhängig. Annahmen & Ausschlüsse: Annahme der Verfügbarkeit der FFLogs-API und stabiler Datenstruktur; Ausschluss von Live-Streaming, In-Game-Rotations-Coaching oder Rohlog-Bearbeitung.