Configure the Unity SDK

Last updated on March 11, 2026

Configure ADT Crash Reporter​

After installing the ADT Unity plugins, you must configure the plugin properties. This ensures that ADT correctly attributes crash data to the specific build version.

  1. Navigate to Tools > BlackBox in the Unity Menu Bar.

  2. Select Properties from the sub-menu to open the configuration window.

  3. Fill out the following fields:

    1. Namespace: Enter the unique namespace provided during your ADT registration.
    2. API Key: ADT game's namespace acquired during setup wizard through ADT. (This API Key is only shown once during creation; if it's lost, you can create another from the ADT Web's Game Settings. Check this Manage API Key document to learn more.)
    3. Game Version id: A UUID generated via the ADT CLI version add command. The CLI automatically updates your BlackBox.ini and populates this field.
    4. Game Build id: A UUID generated via the ADT CLI build register command. The CLI automatically updates your BlackBox.ini and populates this field.
    5. Base URL: Set this to https://blackbox.accelbyte.io.
    6. Is Auto Initialize: Enable this to allow the SDK to initialize automatically upon game launch.
    7. Enable Logs: Enable this to collect and display crash logs within the ADT Web Portal.
    8. Crash Config Option: Select this to synchronize SDK behavior with your ADT Web Portal game settings.
    9. Enable Basic Profiling: Enable this to capture performance metrics during an active session.
    10. Enable Crash Reporter: Toggle this to activate the Crash Reporting module within the SDK.
    11. Store Hardware Information: Enable this to collect anonymized hardware data, allowing you to isolate crashes to specific GPU or hardware configurations.
    12. Debug Platform: Specifies if the game is running in the Unity Editor or as a Packaged Build. It is recommended to keep this at Default for automatic detection.

  4. Click Save Config to apply your changes.

Configure the Issue Reporter​

The issue reporter that comes with the SDK is used to capture any moments within the game and report it to the developer. The Issue Reporter is currently supported exclusively on the Windows platform. To configure this feature, follow these steps:

  1. Enable the Enable Issue Reporter checkbox.
  2. Define the Issue Reporter Hotkey combination:
    1. Key: Click the input field and press the desired key on your keyboard to assign it.
    2. Alt: Enable the Alt to combine the Alt button with the hotkey to trigger Issue Reporter.
    3. Ctrl: Enable the Ctrl to combine the Ctrl button with the hotkey to trigger Issue Reporter.
    4. Shift: Enable the Shift to combine the Shift button with the hotkey to trigger Issue Reporter.
    5. Include Log in Issue Reporter: Enable this option to attach game logs to every submitted issue report for better debugging.
  3. Click Save Config to apply your changes.
Last updated on
On this page