Docs
Docs

Integration Setup

Connect BetaHub with your game engine and Discord server for seamless bug reporting.

Overview

BetaHub integrates with your development workflow through:

  • Game Engine Plugins - Unity and Unreal plugins for in-game bug reporting
  • Discord Bot - Collect bugs from your community server
  • External Tools - Connect with project management platforms

Game Engine Integration

Unity Plugin

You can find our Unity plugin on GitHub. It’s a Unity package that you can import into your project. The plugin is compatible with Unity 2021.1 and later versions.

Installation

  1. In the Unity editor, open your project.
  2. Go to the Window menu and select Package Manager.
  3. Click the + button in the top-left corner and select Add package from git URL.
  4. Enter the following URL: https://github.com/betahub-io/unity-plugin.git
  5. Click Add to import the package.

It’s recommended to import sample scene to see how the plugin works. To do so, unfold the Samples list in the Package Manager and click Import.

FFmpeg Installation

The plugin uses FFmpeg to record videos. You need to install it inside your project to enable video recording. To do so, click on the Tools / BetaHub/ Install FFmpeg menu item in the Unity editor.

The plugin currently supports Windows, macOS and Linux. If you are using a different platform, you may need to install FFmpeg manually.

Quick Start

  1. In Packages/BetaHub Bug Reporter/Runtime/Prefabs folder, drag the BugReportingFormCanvas prefab to your scene.
  2. Click on the BugReportingFormCanvas object in the hierarchy.
  3. In the inspector, find the Project ID field and enter your project ID.

You can find your project ID in the project settings on the BetaHub website. It’s the last part of the URL that starts with pr-.

Press F12 in your game to open the bug report form.

Unreal Plugin

Installation

  1. In the Unreal Editor, open your project.
  2. Go to your project’s root directory and create a new folder named Plugins.
  3. Go to the BetaHub Unreal Plugin GitHub page and download the latest release.
  4. Extract the contents to the Plugins directory: YourProject/Plugins/BetaHubBugReporter/
  5. Restart the Unreal Editor to load the plugin.

Make sure the plugin is enabled in Edit -> Plugins after the rebuild.

Quick Start

  1. Open your Project Settings.
  2. Find BetaHub Bug Reporter and enter your Project ID.
  3. Run your game and press F12 to open the bug report form.

Discord Bot Setup

If you have a community on your Discord server, you’ll want to integrate our bot. The bot allows Discord users to report bugs without logging in anywhere and manages communication with users.

Step-by-Step Setup

  1. Go to BetaHub.
  2. Choose your project.
  3. Select ‘Settings / Discord Bot’ from the left-hand menu.
  4. Follow the three-step configuration process.

Required Permissions

The bot requires these permissions to function correctly:

Basic Requirements (Always Needed)

  • View Channels - To see and operate in channels
  • Send Messages - Required for basic communication
  • Embed Links - Required for all bot functionality

Optional Features

  • Send Messages in Threads - For thread-based bug reporting
  • Create Public/Private Threads - For organizing discussions
  • Attach Files - For release announcements with images
  • Mention Everyone - For release notifications

Use the /info command to verify the bot’s permissions after setup.

Basic Configuration

The bot responds to /report commands from any channel by default. Test it by typing / and checking if the bot responds with commands.

Key Settings

Bug Reporting Channel: Set where bug reports are posted

/set bugs_channel #your-channel

Listen Mode: Enable AI-powered bug detection in conversations

/set listen_mode bugs_only

Thread Mode: Create threads for each bug report

/set thread_mode true

External Tool Integration

BetaHub integrates with popular project management tools:

  • Jira - Send bugs to Jira issues
  • Asana - Create tasks from bug reports
  • GitHub - Open GitHub issues
  • Notion - Add to Notion databases
  • Monday - Create Monday.com items

Setting Up Integrations

  1. Navigate to your project page
  2. Go to SettingsIntegrations
  3. Choose your desired integration
  4. Follow the connection wizard
  5. Configure field mappings

Next Steps

With your integrations set up, you’re ready to:

  1. Learn about managing feedback - Handle incoming bug reports
  2. Explore advanced features - Discover AI-powered capabilities

Integration Setup

Connect BetaHub with your game engine and Discord server for seamless bug reporting.

Overview

BetaHub integrates with your development workflow through:

  • Game Engine Plugins - Unity and Unreal plugins for in-game bug reporting
  • Discord Bot - Collect bugs from your community server
  • External Tools - Connect with project management platforms

Game Engine Integration

Unity Plugin

You can find our Unity plugin on GitHub. It’s a Unity package that you can import into your project. The plugin is compatible with Unity 2021.1 and later versions.

Installation

  1. In the Unity editor, open your project.
  2. Go to the Window menu and select Package Manager.
  3. Click the + button in the top-left corner and select Add package from git URL.
  4. Enter the following URL: https://github.com/betahub-io/unity-plugin.git
  5. Click Add to import the package.

It’s recommended to import sample scene to see how the plugin works. To do so, unfold the Samples list in the Package Manager and click Import.

FFmpeg Installation

The plugin uses FFmpeg to record videos. You need to install it inside your project to enable video recording. To do so, click on the Tools / BetaHub/ Install FFmpeg menu item in the Unity editor.

The plugin currently supports Windows, macOS and Linux. If you are using a different platform, you may need to install FFmpeg manually.

Quick Start

  1. In Packages/BetaHub Bug Reporter/Runtime/Prefabs folder, drag the BugReportingFormCanvas prefab to your scene.
  2. Click on the BugReportingFormCanvas object in the hierarchy.
  3. In the inspector, find the Project ID field and enter your project ID.

You can find your project ID in the project settings on the BetaHub website. It’s the last part of the URL that starts with pr-.

Press F12 in your game to open the bug report form.

Unreal Plugin

Installation

  1. In the Unreal Editor, open your project.
  2. Go to your project’s root directory and create a new folder named Plugins.
  3. Go to the BetaHub Unreal Plugin GitHub page and download the latest release.
  4. Extract the contents to the Plugins directory: YourProject/Plugins/BetaHubBugReporter/
  5. Restart the Unreal Editor to load the plugin.

Make sure the plugin is enabled in Edit -> Plugins after the rebuild.

Quick Start

  1. Open your Project Settings.
  2. Find BetaHub Bug Reporter and enter your Project ID.
  3. Run your game and press F12 to open the bug report form.

Discord Bot Setup

If you have a community on your Discord server, you’ll want to integrate our bot. The bot allows Discord users to report bugs without logging in anywhere and manages communication with users.

Step-by-Step Setup

  1. Go to BetaHub.
  2. Choose your project.
  3. Select ‘Settings / Discord Bot’ from the left-hand menu.
  4. Follow the three-step configuration process.

Required Permissions

The bot requires these permissions to function correctly:

Basic Requirements (Always Needed)

  • View Channels - To see and operate in channels
  • Send Messages - Required for basic communication
  • Embed Links - Required for all bot functionality

Optional Features

  • Send Messages in Threads - For thread-based bug reporting
  • Create Public/Private Threads - For organizing discussions
  • Attach Files - For release announcements with images
  • Mention Everyone - For release notifications

Use the /info command to verify the bot’s permissions after setup.

Basic Configuration

The bot responds to /report commands from any channel by default. Test it by typing / and checking if the bot responds with commands.

Key Settings

Bug Reporting Channel: Set where bug reports are posted

/set bugs_channel #your-channel

Listen Mode: Enable AI-powered bug detection in conversations

/set listen_mode bugs_only

Thread Mode: Create threads for each bug report

/set thread_mode true

External Tool Integration

BetaHub integrates with popular project management tools:

  • Jira - Send bugs to Jira issues
  • Asana - Create tasks from bug reports
  • GitHub - Open GitHub issues
  • Notion - Add to Notion databases
  • Monday - Create Monday.com items

Setting Up Integrations

  1. Navigate to your project page
  2. Go to SettingsIntegrations
  3. Choose your desired integration
  4. Follow the connection wizard
  5. Configure field mappings

Next Steps

With your integrations set up, you’re ready to:

  1. Learn about managing feedback - Handle incoming bug reports
  2. Explore advanced features - Discover AI-powered capabilities