If you are experiencing any problems when running rFactor 2 on your system, it's obviously important to describe your problem as accurately as possible so we can try to reproduce it internally. A step by step explanation would be very helpful. If you have someone else that can validate those steps, that's even better. Apart from describing such steps, there are various different types of logs you can enable that help us diagnose problems in more detail. This page gives a brief overview of each, its purpose and how to enable and send them.
As a starting point, if your issue is not performance related, take a look at trace logging below. If it is performance related, a good first step is to enable a little graph with Ctrl-C that shows two horizontal bars:
The trace log contains a step by step overview of events that happen inside the code of rFactor 2. They tell us about series, cars and tracks that load, settings that get applied or saved and many other details. Typically they can help us figure out if anything out of the ordinary happened in the game code as they typically also record error conditions or other problems we can detect. They are useful in situations where the simulation does not do what you expect it to or even crashes. They are typically not useful for performance related issues.
Trace logging is enabled via a command line argument. Command line arguments are set in your Steam client before you launch. You right click on rFactor 2 in your "library" and choose the "Properties..." option from the context menu. In the "general" tab there is a button called "set launch options..." which shows you a text field where you can enter:
+trace=2
to enable logging to disk (see "what to send?" below for the location of the logs);+trace=2 +traceFlush
to enable logging, flushing any new lines to disk immediately, which is needed if you are reporting rFactor 2 crashing.Trace logs end up in the UserData\Log folder of your rFactor 2 install. The latest one is called "trace.txt" unless rFactor 2 crashed during the latest run. Older ones are typically marked with a timestamp in the name. When in doubt, sort them by modification date. Just send us that text file along with your description of the problem. If you have an in-game time, feel free to mention it. That might save us wading through many lines. If they are large, feel free to zip them.
The graphics logging keeps track of how long we typically spend in what part of the graphics code, breaking down the frame time (=time to render a single image) in different steps, such as shadow drawing, reflection calculation, etc.
Graphics logs end up in the UserData\Log folder of your rFactor 2 install. Sort the files by modification date. All these logs are start with "PerfLog" and end with ".txt". Send us that text file along with your description of the problem. If you have an in-game time, feel free to mention it. If they are large, feel free to zip them.
This logging keeps track of how long we typically spend in what part of the physics code, breaking that down into different steps, which allows us to see for example what the code was doing when physics froze, such as calculating player physics, doing collisions, talking to your wheel, inside plugins, etc. More information on this feature is available in the following forum thread: https://forum.studio-397.com/index.php?threads/logging-out-of-realtime-physics-freezes-public-test.62687/
Open your player.json file, located in UserData\player, with a text editor and search for the line that says "RealTimeLogging":0,
and change it to read "RealTimeLogging":1,
Performance logs end up in the UserData\Log folder of your rFactor 2 install. We keep the last 5 sessions. There should be two files per session, named after the session and ending with the extension .csv and you need to send us both for diagnosis. If they are large, feel free to zip them.
A mini dump file exports information that can tell us why the game crashed, and can be helpful in finding issues.
You'll find the file in steamapps\common\rFactor 2\UserData. The file will be name rFmini.dmp. Make sure it was created at the same time as the crash.