• Guest, RaceDepartment is now on Discord!  Join Here
ACC Results Companion

ACC Results Companion 1.6.5

Log in to download, or make sure to confirm your account via email
Introduction
Assetto Corsa Competizione originally didn't give the user the ability to either view previous fastest laps, sessions or indeed view championship status (other than at completion of a round). With this in mind, I decided to create a little tool for my own purposes, to harvest what information there is in order to provide me with a means at reviewing this sort of information. Given that there have been a number of posts by sim racers bemoaning the lack of this information, I thought perhaps others may find it useful too.

While ACC does give some nice stats now, If you want a little bit more detail on lap stats, this might be the place for you.

System requirements
If your system runs ACC, it should run ACC Results Companion, with the caveat that I don't have a Windows 7 environment to test on. As a bare minimum, you must have .NET Framework 4.5.2 (which will be there for Windows 10 if reasonably up to date)

Installation
This should only be installed on a PC that already has ACC installed. An MSI is provided for the install, that should create the program, work folders and database in your user folder.

If a previous version of ARC has been installed, the installer should allow an update without needing to uninstall first.

Using ACC Results Companion
ACC Results Companion (ARC) should be started before starting ACC (or at least before your first session) each time. It will automatically monitor ACC files to store away sessions and championships for later analysis.

First Run
On the first run, ARC attempts to find the ACC data folder. With a default ACC install, this is found at My Documents\Assetto Corsa Competizione

eg
C:\Users\MyUser\Documents\Assetto Corsa Competizione

This folder contains the .\Results and .\Config folders required by ARC. If the folder cannot be found, an error message is displayed and a dialog will be displayed allowing you to define where to find the folder.

Upgrade Run
If a previous version of ARC was installed and sessions had been recorded, the first time ARC is run, it will replay all the session files to ensure information that was not previously recorded (eg race numbers, driver names etc) is now stored. The first time may therefore take a few seconds to open.

Session History
All sessions that ARC know about are automatically updated. Click on a session to view details of each lap (player car only).

Various filters are available, if you want to zoom in on particular types of sessions. Special mention should be given to:-

  • Wet session - Only includes sessions declared as wet. This is a bit arbitrary as it won't differentiate between a bit wet, flooded and wet, but drying.
  • Special events only - Only shows the special events with their event number show you can cross reference against the PC statistic within the game (which only gives your global position, but not your session performance).


In the detail view, the following information is displayed:-

  • Car
  • Lap number
  • The amount of fuel at the end of the lap
  • The lap time and time of each sector
    • Fastest laps/sectors are highlighted along with invalid laps
  • Differences to laps times in the real Blancpain 2018/2019 seasons are given (the fastest year/session is picked)
    • Delta RR - The difference to the overall Race record
    • Delta QR - The difference to the overall qualifying record
    • Delta QS - The difference to the slowest real qualifying time for the same race
    • Delta QR - The difference to the fastest lap of the slowest team during the race (this is a bit more arbitrary. I've discounted teams that only completed a small amount of laps...maybe they were slow because of damage and finally retired). However, it aims to give a benchmark to where you sit compared to the slower teams IRL.

If you have the option to load all cars (see Settings section), you can click on All Cars button to view all cars in the session. Click Player Car to go back to just the player car. The player car is always highlighted.

Additional columns (such as initial weather conditions) can be exposed (or hidden) by right clicking on the table header.



Multi-player & Hotlaps
Multi-player/hotlap sessions are now supported by using the ACC Shared Memory API


Online multi-player sessions are tagged via the Online column with a new filter drop-down available.

Shared Memory derived sessions have there own peculiarities compared with the results files. There is no indication when a session ends, so ARC assumes this happens when a session is different to the old one (ie different session type, track, car etc) and the completed laps are less than the current session. This will mean there is a bigger delay before the session is available in ARC. If you can't wait, press the Save icon on the status bar at the bottom and this will write the session in its current state.

Circuits
For me, probably the most useful. Gives the fastest lap by car for a given circuit.



Manual Entry
If you have old laps you have noted down and want to store, there is a manual entry panel.

Also, for reasons listed later, ACC does not currently provide results for hotlaps, single player standalone practice sessions and some online races. As such, you could record the fastest laps from these sessions manually (don't worry if you haven't noted the sector times).


Currently, each manually entered lap will be displayed as a new session (this might change in the future).

Server side results (Multiplayer)

V0.6.0 now supports Server results files and can operate in a number of modes for this
  • On client PC with local ACC and local server
  • On client PC with local ACC and folder to store received server results files
  • On server PC (no ACC client install)
  • On PC with no ACC (client or server) but with only folder where server results files can be placed.
See the discussion on the update for V0.6.0 regarding details of how this works

ServerOnlyFocusPlayer1.PNG




Fixing sessions
At the moment (currently ACC 1.0.10), there appears to be an intermittent issue which resuming saved games in that not all information is written out at the end of the session (ie the track and which is the player car). As such, the session may show in ARC as UNKNOWN track or car (with a sneak preview of the next car to be added in the upcoming DLC ;) )


If this is the case, right click on the session and select Fix Session.

You can then manually select the track and Race Number of your car (hopefully you remember both these).



The session should then be fully visible.

Note, there is a known issue with this in that the Sessions screen blanks out after this. Press the Filter button to refresh.

Settings
If you don't like the default colours for the lap display, here is where you can change that

  • ACC Style- Uses similiar colours to ACC when diaplying the laps
  • F1 Style (for want of a better name) - Different style showing improved/slower laps as well as records
  • Custom Style - Pick your own colours...just click on each button. This is currently just a taster at the moment and has a couple of issues that need ironing out.
  • Font Colour Contrast - The font changes from black to white depending on how dark the background colour is. You change adjust the point at which this changes.
In addition, if the ACC folder is not in the default place, it can be set here.


If you select Store laps for all cars, the times of all cars in the session will be stored. Unselecting will store only the player car, This can be changed at any point. If you decide you want to view all cars from a session you only stored the player car for, you can change this session then replay the results file (see Backup section)

Backup

Individual results files can be replayed (or deleted). The backups describe the session type, track dates and player car (this may be the winning car if there are issues with saved games)

Impact on ACC
This should be minimal. It will take up a small amount of memory while running, and uses Windows directory events to monitor files which should again have minimal performance impact while ACC is running.

The main processing of ARC occurs at the session end (to load in the results/championship file) and when using the UI, so it shouldn't take away any precious performance while a race is in progress.

With the addition of support for the Shared Memory API (for online/hotlaps), ARC will now poll the shared memory every second for updates, The overhead should be minimal though as DB writes don't happen until the end of the session.

Limitations, Restrictions and Known Bugs

Old sessions not picked up
ARC can only detect and process results if it is running while ACC is running and the session is completed. Nothing can really be done about this as ACC only keeps json files for current sessions.

Backup files named with winning, not player car
I think this is only now an issue when the season file isn't created properly after a saved game is resumed (ie we don't know the player car).

Session screen blank after Fix Session
Known issue not getting the latest results from the DB. A workaround is to press the Filter button to refresh.

Loading large number of server results files locks app until complete
Currently when a large number of server results files are loaded, this will freeze the app until complete. This will be moved out to a separate thread in a future update so the load is asynchronous.


Housekeeping & Optimisation
ARC backs up ACC results files and stores them in a database. At the moment, no housekeeping is performed to get rid of unwanted backups and I haven't really looked at optimizing the DB queries. I'll start looking at both these shortly.

There are now options to remove sessions or tidy up backup files, should you want to.

Troubleshooting
There is a log pane which should describe any errors, but the best bet at the moment is to log any issues here.

Zip up the following folders so I can try to recreate the issue:-
  • <My Documents>\Assetto Corsa Competizione\Config
  • <My Documents>\Assetto Corsa Competizione\Results
  • %HOMEDRIVE%%HOMEPATH%\Documents\ACCResults
List your Windows and .NET framework version and describe the nature of the problem.

How does it work ?
The information that ACC provides is in two parts:-
  1. Session information
    1. At the start of the session, a seasonEntity json file is created giving overview information (most importantly being the track)
    2. At the end of the session, the results session info is created (hotstint, qualifying, race etc) giving lap and sectors times and so on, but crucially, not the track
Only the latest copy of file is stored, with no history. By storing away these files as they are created, it is possible to perform some analysis on each session. Note, the json files are not documented and I'm using them in a manner not intended, so some assumptions have to be made in order to get things to work.

When a results session file is created, it looks for the seasonEntity file, as hopefully, it relates to this session and we need this for the track information. If the seasonEntity is newer than the results file or it has already been processed, then we can't rely on it so we have to ignore the session. Otherwise, we store the results with the information from the seasonEntity.

For online/hotlaps, the ACC shared memory regions are monitored for data of laps. These are only written to DB once a new session is detected.

All information is stored in a lightweight DB for querying by the UI.
Author
Doug Duthie
File size
50.4 MB
Downloads
2,759
Views
35,850
First release
Last update
Rating
4.83 star(s) 53 ratings

Latest updates

  1. ACC Results Companion V1.6.5

    True gap calculation Corrected MP position calculations Position gained/lost for each lap and...
  2. ACC Results Companion V1.6.4

    Re-instate fuel column formatting (with decimal places) for sessions & laps Re-factor DB writes...
  3. ACC Results Companion V1.6.3

    Heatmaps - Tolerance to allow very slow times to be ignored to prevent them from skewing...
  4. ACC Results Companion V1.6.2

    Result statatcs - Added total time, invalid laps and invalid lap ratio Move away from Kunos...
  5. ACC Results Companion V1.6.1

    Session duration now time from crossing start line (hotstint lengths should therefore be...

Latest reviews

A1
Excellent app!
Hi Doug plz get in touch with me @ Andy@AKM-Racing.co.uk regarding ACC Results Companion (Sorry can't see a way to message you in here)
Great for ACC, but i have accidentally left it open whilst playing AC, and it has saved entries for cars and tracks not in ACC.
Doug Duthie
Doug Duthie
That should have been fixed sometime ago (it has been a while since I've had time to play on AC though). Which version are you running on?
Excellent work, many thx.
Excellent, practical.
Great app. Use it all the time and it got really usefull when all cars in session got implemented. Keep up the awesome work
great app
Í cant set that i see all cars from the session how can i do that?
Doug Duthie
Doug Duthie
To view all cars in a session, click on the All Cars radio button (as in the link below)

https://i.imgur.com/0EGkAJw.png
great app!!
very good tool to handle League results. thanks
Funciona perfectamente y te permite seguir tu progreso. La actualizacion es constante. Realmente muy util.
Thank you.
Always on top.
I love the app, thank you!!!
It doesn't appear to be working right now. Every session I run ends up with the "Car" section reading "Unknown Car" with no data logged. It records the date, time, track, and duration, but not any of the laps. If you could look into this, that'd be great. This app is really great when it's working.
Doug Duthie
Doug Duthie
Can you turn on "Write debug messages" to log and "log broadcast activity" on the settings page, then run another sessions. Then copy all text from the log page. Also, go to the Session page, right click in the session light and select "Export Diagnostics". This will create a zip file in an explorer window. Rename the zip file type to "txt" and then send this and the log output
FANTASTIC app
Great app! Can't play without it. :)
This is a must!
Hi, it doesn't record live info anymore.. it only shows session when they are ended. Also fuel doesn't work
Doug Duthie
Doug Duthie
This is probably down to ACC 1.4 out today. I'll have to rebuild and check if there are any material changes to the broadcast interface
Unfortunately every time or almost it does not record training sessions (unknown car) and even when I use "fix session" it does not work ...
Doug Duthie
Doug Duthie
Hi Pascal - I'll PM you to get to the bottom of this
Well done! a perfect app.
is it possible to show the type of tires of the opponents.
Thanks for the work.
Doug Duthie
Doug Duthie
At the moment, ACC only make that information available on the shared memory interface which is for player car only. If they ever make it available on the Broadcast API, then I'll inlcude it
Thank you for this awesome app, and thank you for keeping it improved/updated!
Some small glitches experienced where my session doesn't record, but outside of that, absolutely superb.
Doug Duthie
Doug Duthie
Looking at the Broadcast programmer forum over at Kunos, it looks like people are reporting possible issues with getting connection to the Broadcast API (since ACC 1.3.12). Unfortunately, I can't reproduce this as I get a connection every time. With the next release, I'm going to introduce an optional retry timeout, so if you are experiencing difficulties, you could see if the retry helps
Thank you for this great app.
Good luck to you