Skip to content

BugSplat-Git/my-unreal-crasher

Repository files navigation

bugsplat-github-banner-basic-outline

BugSplat

Crash and error reporting built for busy developers.

👋 Introduction

MyUnrealCrasher is an Unreal Engine 5 project for testing BugSplat crash reporting. This repo has been pre-configured with the BugSplat-Unreal editor plugin that allows you to configure crash reporting with only a few keystrokes.

Before diving into this sample, please complete the following tasks:

  • Sign Up as a new BugSplat user
  • Complete the Welcome workflow and make a note of your BugSplat database
  • Generate a Client ID and Client Secret for symbol uploads on the Integrations page

🥾 Steps

The following guide assumes your project is targeting Windows, but these steps are applicable to other Desktop platforms as well. On Mobile platforms the BugSplat plugin will automatically configure crash reporting and symbol uploads.

  1. Before you clone this repo make sure you have git-lfs installed.
  2. Clone this repo and the associated submodules. It's important that this repo is cloned with the --recurse-submodules flag so that the bugsplat-unreal plugin is also downloaded:
git clone https://github.com/BugSplat-Git/my-unreal-crasher --recurse-submodules
  1. Double click the MyUnrealCrasher.uproject file to open the project in the Unreal Editor. Depending on the Unreal Engine version you have installed you may need to Generate Visual Studio project files and build the plug-in from source.
  2. Once the project has been opened, click Edit > Project Settings and scroll to the BugSplat section under Plugins.
  3. Fill in the values for Database, Application, Version, Client ID, and Client Secret

Windows

  1. Click Add Symbol Uploads
  2. Package your project to upload symbols to BugSplat
  3. In the BugSplat section of Project Settings click Update Game INI
  4. Select the directory that contains the Windows or WindowsNoEditor folder

iOS & Android

  1. Ensure that Enable automatic symbol uploads and Enable crash reporting are both checked
  2. Package your project to upload symbols to BugSplat

Run your packaged game to generate a crash report. Navigate to the Crashes page and click the link in the ID column to view the details of your crash

If you did everything correctly your result should look something like this

image