Menu

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

The Unity plugin is a package for Unity 2022.3 and later.

Installation

  1. In Unity, open Window → Package Manager, click + → Add package from git URL and enter https://github.com/betahub-io/unity-plugin.git.
  2. When Unity offers to download FFmpeg, click Download. Video in reports needs it.

Quick Start

  1. GameObject → BetaHub → Bug Report Widget adds the report form to the open scene.
  2. On its BetaHub Reporter component, enter your Project ID and Auth Token, both in Settings → Integrations → Auth Tokens.
  3. Run your game and press F12 to open the bug report form.

To see it working first, import the Demo sample from the Package Manager. The Unity Plugin guide covers controllers, themes, attachments, custom fields and upgrading from 1.x.

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.

To attach game-specific data to reports programmatically, see Custom Fields.

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

After inviting the bot, use the interactive setup wizard to connect and configure it:

  1. Type /install in any channel where the bot is active
  2. Click Connect Project and paste your project token from BetaHub → Settings → Discord Bot
  3. Click 🐛 Bugs → Set up Bug Channels to select your bug reporting channels
  4. Configure additional features (suggestions, sentiments, etc.) from the same menu

You can reconfigure at any time using /info → “Configure” to open the Configuration Panel.

Multiple projects? You can connect additional BetaHub projects to the same Discord server. Run /install again and click Connect Another Project. See Multiple Projects per Server for details.

Key Settings (via commands)

You can also configure settings with /set commands:

Bug Reporting Channel: Set where bug reports are posted

/set key bugs_channel value #your-channel

Listen Mode: Enable AI-powered bug detection in conversations

/set key listen_mode value bugs_only

Thread Mode: Create threads for each bug report

/set key thread_mode value true

Threads Channel (Optional): Specify which channel to use for threads

/set key threads_channel value #bug-discussions

External Tool Integration

BetaHub integrates with popular project management tools:

  • Jira Cloud - Send bugs to Jira Cloud issues
  • Jira Server - Send bugs to self-hosted Jira instances
  • Asana - Create tasks from bug reports
  • GitHub - Open GitHub issues
  • Notion - Add to Notion databases
  • Monday.com - Create Monday.com items
  • ClickUp - Create ClickUp tasks
  • Fibery - Add to Fibery databases
  • Redmine - Create Redmine issues
  • Trello - Create Trello cards

Setting Up Integrations

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

See Also

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

The Unity plugin is a package for Unity 2022.3 and later.

Installation

  1. In Unity, open Window → Package Manager, click + → Add package from git URL and enter https://github.com/betahub-io/unity-plugin.git.
  2. When Unity offers to download FFmpeg, click Download. Video in reports needs it.

Quick Start

  1. GameObject → BetaHub → Bug Report Widget adds the report form to the open scene.
  2. On its BetaHub Reporter component, enter your Project ID and Auth Token, both in Settings → Integrations → Auth Tokens.
  3. Run your game and press F12 to open the bug report form.

To see it working first, import the Demo sample from the Package Manager. The Unity Plugin guide covers controllers, themes, attachments, custom fields and upgrading from 1.x.

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.

To attach game-specific data to reports programmatically, see Custom Fields.

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

After inviting the bot, use the interactive setup wizard to connect and configure it:

  1. Type /install in any channel where the bot is active
  2. Click Connect Project and paste your project token from BetaHub → Settings → Discord Bot
  3. Click 🐛 Bugs → Set up Bug Channels to select your bug reporting channels
  4. Configure additional features (suggestions, sentiments, etc.) from the same menu

You can reconfigure at any time using /info → “Configure” to open the Configuration Panel.

Multiple projects? You can connect additional BetaHub projects to the same Discord server. Run /install again and click Connect Another Project. See Multiple Projects per Server for details.

Key Settings (via commands)

You can also configure settings with /set commands:

Bug Reporting Channel: Set where bug reports are posted

/set key bugs_channel value #your-channel

Listen Mode: Enable AI-powered bug detection in conversations

/set key listen_mode value bugs_only

Thread Mode: Create threads for each bug report

/set key thread_mode value true

Threads Channel (Optional): Specify which channel to use for threads

/set key threads_channel value #bug-discussions

External Tool Integration

BetaHub integrates with popular project management tools:

  • Jira Cloud - Send bugs to Jira Cloud issues
  • Jira Server - Send bugs to self-hosted Jira instances
  • Asana - Create tasks from bug reports
  • GitHub - Open GitHub issues
  • Notion - Add to Notion databases
  • Monday.com - Create Monday.com items
  • ClickUp - Create ClickUp tasks
  • Fibery - Add to Fibery databases
  • Redmine - Create Redmine issues
  • Trello - Create Trello cards

Setting Up Integrations

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

See Also

BetaHub Help
AI