Log files: Difference between revisions

From Resonite Wiki
Add Bootstrapper log section
Marked this version for translation
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>


<!--T:1-->
<translate><!--T:1--> There are multiple log file types which Resonite Produces:</translate>
<translate><!--T:1--> There are multiple log file types which Resonite Produces:</translate>
# <translate><!--T:2--> Regular log files</translate>
# <translate><!--T:2--> Regular log files</translate>
# <translate><!--T:3--> Player.log files</translate>  
# <translate><!--T:3--> Player.log files</translate>  
# <translate><!--T:4--> Unity crash dumps</translate>
# <translate><!--T:4--> Renderer crash dumps</translate>  
# <translate>Bootstrapper log files</translate>
# <translate><!--T:29--> Resonite crash log files</translate>
# <translate><!--T:25--> Bootstrapper log files</translate>


<!--T:2-->
<translate><!--T:5--> When asking for logs to diagnose issues, we ''usually'' need just the regular log files, so start by providing these.</translate>
<translate><!--T:5--> When asking for logs to diagnose issues, we ''usually'' need just the regular log files, so start by providing these.</translate>


== <translate><!--T:6--> Regular Log Files</translate> == <!--T:3-->
== <translate><!--T:6--> Regular Log Files</translate> == <!--T:3-->
<translate><!--T:7--> Resonite logs can be found in the Resonite installation directory.</translate>
<translate><!--T:7--> Resonite logs can be found in the Resonite installation directory.</translate>


<!--T:4-->
<translate><!--T:8--> '''For the Steam build of Resonite, these are most easily accessed by''':</translate>
<translate><!--T:8--> '''For the Steam build of Resonite, these are most easily accessed by''':</translate>
# <translate><!--T:9--> Right click on Resonite in your Steam library</translate>
# <translate><!--T:9--> Right click on Resonite in your Steam library</translate>
Line 26: Line 25:
<translate><!--T:14--> Then open the "Logs" folder</translate>
<translate><!--T:14--> Then open the "Logs" folder</translate>


<!--T:6-->
<translate><!--T:15--> Once in the log folder, you'll find logs named by build number, the date, and time of the log’s creation. When submitting them for help, select the most recent logs which correspond to the session the issue occurred in.</translate>
<translate><!--T:15--> Once in the log folder, you'll find logs named by build number, the date, and time of the log’s creation. When submitting them for help, select the most recent logs which correspond to the session the issue occurred in.</translate>


== <translate><!--T:16--> Player.log Files</translate> == <!--T:8-->
== <translate><!--T:16--> Player.log Files</translate> == <!--T:8-->
{{Note|<translate><!--T:17--> Please start with the regular log files as listed above, these files are usually only needed if requested.</translate>|danger}}
{{Note|<translate><!--T:17--> Please start with the regular log files as listed above, these files are usually only needed if requested.</translate>|danger}}


<!--T:9-->
<translate><!--T:18--> Unity Player.log files can be found by pressing Windows Key + R and entering <code>%userprofile%\AppData\LocalLow\Yellow Dog Man Studios\Renderite.Renderer</code> then OK. The Player.log is overwritten each time you launch Resonite, so make sure to collect it right away after you encounter a crash, or bug. If you have launched Resonite once since the issue occurred, the contents will be in the Player-prev.log file. If you’ve launched Resonite twice or more since the issue occurred, the Player.log file will be gone as it will have been overwritten.</translate>
<translate><!--T:18--> Unity Player.log files can be found by pressing Windows Key + R and entering <code>%userprofile%\AppData\LocalLow\Yellow Dog Man Studios\Resonite</code> then OK. The Player.log is overwritten each time you launch Resonite, so make sure to collect it right away after you encounter a crash, or bug. If you have launched Resonite once since the issue occurred, the contents will be in the Player-prev.log file. If you’ve launched Resonite twice or more since the issue occurred, the Player.log file will be gone as it will have been overwritten.</translate>


<translate><!--T:23--> On Linux, via Proton, the Unity Player.log files can be found in</translate> <code>~/.local/share/Steam/steamapps/compatdata/2519830/pfx/drive_c/users/steamuser/AppData/LocalLow/Yellow Dog Man Studios/Resonite/</code>.
<translate><!--T:26--> On Linux, via Proton, the Unity Player.log files can be found in<tvar name=logdirectory><code>~/.local/share/Steam/steamapps/compatdata/2519830/pfx/drive_c/users/steamuser/AppData/LocalLow/Yellow Dog Man Studios/Renderite.Renderer/</code></tvar></translate>.


== <translate><!--T:19--> Crash log and memory dump</translate> == <!--T:10-->
== <translate><!--T:19--> Crash logs</translate> ==


<!--T:11-->
=== <translate><!--T:30--> Renderer crash log and memory dump</translate> ===
<translate><!--T:20--> In the event that you crash, Resonite will attempt to create crash logs, and memory dumps that are located in a Crashes folder found at <code>%USERPROFILE%\AppData\Local\Temp\Yellow Dog Man Studios\Resonite\Crashes</code>. Inside of the Crashes folder are folders for each crash logged, and inside of each is an error.log file, a Player.log file, and a memory dump.</translate>
<translate><!--T:20--> In the event that the Unity renderer crashes, Resonite will attempt to create crash logs, and memory dumps that are located in a Crashes folder found at <code>%USERPROFILE%\AppData\Local\Temp\Yellow Dog Man Studios\Renderite.Renderer\Crashes</code>. Inside of the Crashes folder are folders for each crash logged, and inside of each is an error.log file, a Player.log file, and a memory dump.</translate>


<!--T:12-->
<translate><!--T:21--> If they exist, submit the error.log, and Player.log file from the crash folder alongside the Resonite log from your installation folder. Otherwise, just submit the Resonite log, and the Player.log.</translate>
<translate><!--T:21--> If they exist, submit the error.log, and Player.log file from the crash folder alongside the Resonite log from your installation folder. Otherwise, just submit the Resonite log, and the Player.log.</translate>


<translate><!--T:22--> On Linux, via Proton, the crash logs can be found in</translate> <code>~/.local/share/Steam/steamapps/compatdata/2519830/pfx/drive_c/users/steamuser/AppData/Local/Temp/Yellow Dog Man Studios/Resonite/Crashes</code>.
<translate><!--T:22--> On Linux, via Proton, the crash logs can be found in</translate> <code>~/.local/share/Steam/steamapps/compatdata/2519830/pfx/drive_c/users/steamuser/AppData/Local/Temp/Yellow Dog Man Studios/Renderite.Renderer/Crashes</code>.
 
=== <translate><!--T:31--> Resonite crash log</translate> ===
<translate><!--T:32--> In the event that the main Resonite process crashes, it will attempt to create a crash log. This crash log will be created directly in the Resonite install folder, under the name <code>Renderite.Host.Crash.<timestamp>.log</code> . You can refer to the [[Log Files#Regular Log Files|Regular Log Files]] section for instructions on how to access this folder.</translate>


== <translate>Bootstrapper log</translate> ==
== <translate><!--T:27--> Bootstrapper log</translate> ==
<translate>There is only one bootstrapper log file created, <code>Bootstrapper.log</code>, located directly in the Resonite installation directory. Refer to the [[Log Files#Regular Log Files|Regular Log Files]] section above for details on locating the Resonite installation directory.</translate>
<translate><!--T:28--> There is only one bootstrapper log file created, <code>Bootstrapper.log</code>, located directly in the Resonite installation directory. Refer to the [[Log Files#Regular Log Files|Regular Log Files]] section above for details on locating the Resonite installation directory.</translate>


[[Category:Troubleshooting]]
[[Category:Troubleshooting{{#translation:}}]]

Latest revision as of 13:27, 25 August 2025

There are multiple log file types which Resonite Produces:

  1. Regular log files
  2. Player.log files
  3. Renderer crash dumps
  4. Resonite crash log files
  5. Bootstrapper log files

When asking for logs to diagnose issues, we usually need just the regular log files, so start by providing these.

Regular Log Files

Resonite logs can be found in the Resonite installation directory.

For the Steam build of Resonite, these are most easily accessed by:

  1. Right click on Resonite in your Steam library
  2. Select Manage > Browse Local Files

OR

  1. Right click on Resonite in your Steam library
  2. Select Properties
  3. Then selecting Installed Files > Browse

This will open a file browser to the Resonite Installation Folder Then open the "Logs" folder

Once in the log folder, you'll find logs named by build number, the date, and time of the log’s creation. When submitting them for help, select the most recent logs which correspond to the session the issue occurred in.

Player.log Files

Please start with the regular log files as listed above, these files are usually only needed if requested.

Unity Player.log files can be found by pressing Windows Key + R and entering %userprofile%\AppData\LocalLow\Yellow Dog Man Studios\Renderite.Renderer then OK. The Player.log is overwritten each time you launch Resonite, so make sure to collect it right away after you encounter a crash, or bug. If you have launched Resonite once since the issue occurred, the contents will be in the Player-prev.log file. If you’ve launched Resonite twice or more since the issue occurred, the Player.log file will be gone as it will have been overwritten.

On Linux, via Proton, the Unity Player.log files can be found in~/.local/share/Steam/steamapps/compatdata/2519830/pfx/drive_c/users/steamuser/AppData/LocalLow/Yellow Dog Man Studios/Renderite.Renderer/.

Crash logs

Renderer crash log and memory dump

In the event that the Unity renderer crashes, Resonite will attempt to create crash logs, and memory dumps that are located in a Crashes folder found at %USERPROFILE%\AppData\Local\Temp\Yellow Dog Man Studios\Renderite.Renderer\Crashes. Inside of the Crashes folder are folders for each crash logged, and inside of each is an error.log file, a Player.log file, and a memory dump.

If they exist, submit the error.log, and Player.log file from the crash folder alongside the Resonite log from your installation folder. Otherwise, just submit the Resonite log, and the Player.log.

On Linux, via Proton, the crash logs can be found in ~/.local/share/Steam/steamapps/compatdata/2519830/pfx/drive_c/users/steamuser/AppData/Local/Temp/Yellow Dog Man Studios/Renderite.Renderer/Crashes.

Resonite crash log

In the event that the main Resonite process crashes, it will attempt to create a crash log. This crash log will be created directly in the Resonite install folder, under the name Renderite.Host.Crash.<timestamp>.log . You can refer to the Regular Log Files section for instructions on how to access this folder.

Bootstrapper log

There is only one bootstrapper log file created, Bootstrapper.log, located directly in the Resonite installation directory. Refer to the Regular Log Files section above for details on locating the Resonite installation directory.