$ account awgil
This repository is a Dalamud plugin for Final Fantasy XIV that provides real-time boss encounter assistance. It includes a modular system for defining boss mechanics (AOEs, stacks, spreads, knockbacks, etc.) using a component-based architecture with state machines. The plugin covers all expansions from A Realm Reborn through Dawntrail, including dungeons, trials, savage raids, ultimates, alliance raids, hunts, deep dungeons, and quests. It also features an autorotation system for cooldown planning and AI movement hints, as well as replay recording and analysis tools for post-fight review and reverse-engineering of game mechanics. The architecture is centered around `BossModule` subclasses that define encounter logic via `StateMachineBuilder` and reusable `BossComponent` classes. Components observe game events (casts, statuses, icons, tethers) and produce arena overlays, text hints, and AI suggestions. The codebase is large and community-driven, with contributions from many developers. While the core framework is well-structured, there is significant per-encounter code that is tightly coupled to specific game data (action IDs, status IDs, positions), leading to maintenance overhead and occasional incomplete or placeholder implementations. The plugin is actively developed, with support for the latest expansion (Dawntrail) and ongoing updates. However, the reliance on reverse-engineered game data and hardcoded values means that patches can break functionality. The codebase includes many TODO comments and some modules marked as incomplete, indicating areas of ongoing research or unfinished work.