Help us improve BugQuest by completing a short survey

Share Your Feedback

BugQuest Installation Guide

  • Install BugQuest in your Unity project.
  • Link the project to your account in the dev console.
  • Run your game and start seeing real runtime errors.

1Use Unity's Package Manager to Install the Library

In the Unity Editor, open the Package Manager.

Opening the Package Manager in Unity

In the Package Manager, open the + menu and select Add package from git URL and enter this GitHub URL:

https://github.com/Main-Tank-Software/bugquest-unity.git

Git must be installed and available in your system's PATH.

Adding the package by name
Adding the package by name

For more details please seeInstall a UPM package from a Git URLin the Unity documentation

2Setup the Library

After the library is installed the Setup window should automatically appear. If it does not, open it by selecting BugQuest.GG under the Window menu.

Open the BugQuest window

Click the green Setup button to setup the library in your project.

This will automatically:

  • Get an API key for your project
  • Create a GameObject in your current scene
  • Create a link to our website to quickly setup an account associated with this project

Your game's first scene must be loaded in the Unity Editor when you click Setup. This allows the BugQuest GameObject to load immediately when the game launches.

Click Setup

3Visit the Web Interface

Click the link that appears or copy it to your clipboard and paste it in a browser window. This will take you to the web interface where you can quickly create an account and view your errors.

Register with the dev console

BugQuest API

Replay API

Replays let you record gameplay videos that will be available in the BugQuest dev console. Use them to capture moments around player actions or bugs.

StartReplayReplay API
bool StartReplay(string replayLabel, bool discardReplayOnMaxDurationTimeout = false, int maxReplayDurationMinutes = int.MaxValue)

Starts recording a replay.

replayLabel
RequiredReplay label shown in the dev console.
discardReplayOnMaxDurationTimeout
OptionalIf true, discards the replay when maxReplayDurationMinutes is reached. Replays will only be kept if manually stopped by calling StopReplay.
maxReplayDurationMinutes
OptionalMaximum duration in minutes before timeout handling applies. This has a server-side enforced limit of 15 minutes.
Returns
bool: true if replay recording started successfully; otherwise false.
StopReplayReplay API
bool StopReplay(bool discardReplay = false, string replaceLabel = null, int onlyKeepLastMinutes = int.MaxValue)

Stops the active replay and optionally modifies what gets kept.

discardReplay
OptionalIf true, discards the replay when stopping.
replaceLabel
OptionalThis parameter will replace the original label for the replay.
onlyKeepLastMinutes
OptionalTrims the saved replay to the last N minutes when stopping.
Returns
bool: true if replay recording stopped successfully; otherwise false.
IsReplayRecordingReplay API
IsReplayRecording()

Returns whether a replay is currently recording.

Returns
bool: true when a replay is active; otherwise false.
Example usage
public void StartBossFightReplay()
{
    if (!BugQuestAPI.IsReplayRecording())
    {
        BugQuestAPI.StartReplay("BossFight");
    }
}

public void StopBossFightReplay()
{
    BugQuestAPI.StopReplay(onlyKeepLastMinutes: 5);
}
Error Clips API

Error clips are short videos automatically captured when the game encounters an error. They are enabled when the game starts but may be disabled or re-enabled at runtime using these methods.

EnableErrorClipsError Clips API
void EnableErrorClips()

Enables automatic Error Clips creation.

Example usage
BugQuestAPI.EnableErrorClips();
DisableErrorClipsError Clips API
void DisableErrorClips()

Disables automatic Error Clips creation.

Example usage
BugQuestAPI.DisableErrorClips();
Runtime Control API
DisableRuntime API
void Disable()

Disables BugQuest error collection and upload for the rest of the current app session.

Applies only to the current app session. Error collection starts again on next application launch unless disabled again.

Example usage
BugQuestAPI.Disable();
DisableAllVideoFeaturesRuntime API
void DisableAllVideoFeatures()

Disables all video features. Error Clips and Replays will not be created after this is called for the remainder of the current app session.

Example usage
BugQuestAPI.DisableAllVideoFeatures();

Additional Documentation

Unity Notes

Unity API method documentation is listed above under BugQuest API. This includes methods to start and stop Replays, enable and disable Error Clips, disable all video features, and completely disable BugQuest at runtime.

Support and Feedback

Please give us your feedback by completing this short survey.
Please email us at support@bugquest.gg if you have any questions or need help.

Legal Documents