I had a bunch of new players in the 0-1200 rating range and I realised everybody keeps making the same mistakes. While telling them in real-time would help them improve quite fast, reviewing replays was way less effective. I think this is because getting yelled at in real time, while making mistakes just hit differently than looking at it after the fact - for most people.

So I present the beginning of the Beta of the FA-Companion, a Tool which I envision to eventually help all new players to quickly react to their mistakes and improve, but it can also give valuable learning information to established ladder addicts. I personally still find the tool quite useful up to the 1.8k global range, which realistically the vast majority of the community.

Live-Game Companion

If you run the Mod and the Ingester as described on the Live-Game Page, this will automatically open and select the correct map, based on the Information the Mod/Client transmits, alerts will be generated, optionally as TTS and inform you of common mistakes in real time.

Post Game Analysis

The post-game analysis will show you a timeline of your alerts/mistakes as well as various stats about the game which are not normally available. There is still work to be done here, more metrics will be added and yes, reclaim & income need to be split at some point. The red line is not in the online version yet and will be a reference line either an average of your recent games or a certain rating range. If you are tracking a livegame it will automatically put you in Analysis after the game exits.

Gamelobby Tools/Connection Matrix

I implemented this mostly as a gimmick because I liked the component library, but I still like it. It will show your connections and track the amount of players in a lobby. I have already implement Webhooks/Push notifications via NTFY but it's database-edit only at the moment and has no UI. It will be generally available eventually though. The idea is that you can write !notifyme players 10 in a bad lobbysim and leave the PC to work in the house and get a notification to your Phone automatically. Yeah idk it was a gimmick.

Alert Information

Each Alert (more or less) has a explanation Page which explains the concepts and ideas related to the Alert.

Buildorders & Guides

Buildorders are displayed in the Livegame, but obviously more complicated Guides require more space, so there is a Subpage which displays all available Buildorders and guides. I have done most of these so far/transcribed them from replays of top players also zwaffel helped me :>. The Guides will be open to everybody who wants to contribute. They are currently written in Markdown. I am experimenting with structured YAML-BOs but it's experimental.

Your own configuration

You can configure which alerts you want to have pop up and also if you want to provide your game data to anybody who is interested live. Eventually there might be API-Tokens for Integrations, I already created a css-class obs-transparent to be able to overlay alerts in Streams, but this is experimental. Also I want to eventually have people create their own alerts based on data.

I really believe in this project, even though it is still rough around the edges, it also was a lot of fun and I learned a lot about databases performance (well we will see about that if 50 people use this at the same time..).

I'm starting the public beta today: https://fa-companion.services.atlantishq.de
The mod is available in the modvault under the name: "FA_Metrics_Exporter"
While this hasnt happened to me in a while I suggest setting the unload hotkey to disable the mod should it ever lag the UI.

Please have patience with the project, it was a quite massive undertaking with almost 10k lines of code with rather dense logic.

Thank you so much for all the patient people in #modding (looking at you @4z0t) and all my alpha testers: @noxie, @uney, @morax, @bekama & @iTrash and also @indexlibrorum