Unreal Engine

BugSplat’s Unreal Engine integration supports most Unreal platforms including desktop computers, the Steam platform, and Linux servers. Support for additional platforms will be provided in the future.

  1. To send crash reports to BugSplat, change the DataRouterUrl parameter in /Engine/Programs/CrashReportClient/Config/DefaultEngine.ini so that crash reports are posted to our back end. There are multiple DefaultEngine.ini files in your tree, make sure you edit the right one.

    Here's what the crash report section of DefaultEngine.in should look like:

    [CrashReportClient]
    CrashReportClientVersion=1.0
    DataRouterUrl="https://{database}.bugsplat.com/post/ue4/{appName}/{appVersion}"

    Replace {database}, {appName}, and {appVersion} with the names of your BugSplat database, application name, and version. (You will use these exact same parameter values when uploading symbols.)

  2. Package your game, check that the Include Crash Reporter and Include Debug Files options are selected in your build configuration:

    3. Integrating Unreal with BugSplat
    UE4_PackagingSetttings
  3. To create symbolic call stacks on Windows platforms you will need to upload symbol and executable files. The easiest way to upload files is to use our SendPdbs command line utility. SendPdbs can be downloaded either by clicking here or via the SendPDBs doc. Run it from your build folder using the following commands.
    cd {your build folder}
    SendPdbs /u {username} /p {password} /b {database} /a {appName} /v {appVersion} /s /f
    "*.pdb;*.dll;*.exe"

  4. Run your game. For testing, a crash can be forced from the console using the command "debug crash". After posting the crash report, login to BugSplat to view the report.

  5. Eventually, you will want to rebuild CrashReportClient so that its user interface describes the crash reporting changes above. However, this isn't required to successfully post crash reports.

  6. Special instructions for Linux servers:
    • Package the crash reporter with your Linux server build by adding the -CrashReporter flag to PackageBuildLinuxServer.bat
    • Force a test crash by running your server executable with the option -ExecCmds="debug crash"