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
- In the Unity editor, open your project.
- Go to the
Window
menu and selectPackage Manager
. - Click the
+
button in the top-left corner and selectAdd package from git URL
. - Enter the following URL:
https://github.com/betahub-io/unity-plugin.git
- 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
- In Packages/BetaHub Bug Reporter/Runtime/Prefabs folder, drag the BugReportingFormCanvas prefab to your scene.
- Click on the BugReportingFormCanvas object in the hierarchy.
- 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
- In the Unreal Editor, open your project.
- Go to your project’s root directory and create a new folder named
Plugins
. - Go to the BetaHub Unreal Plugin GitHub page and download the latest release.
- Extract the contents to the
Plugins
directory:YourProject/Plugins/BetaHubBugReporter/
- Restart the Unreal Editor to load the plugin.
Make sure the plugin is enabled in Edit -> Plugins after the rebuild.
Quick Start
- Open your Project Settings.
- Find BetaHub Bug Reporter and enter your Project ID.
- 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
- Go to BetaHub.
- Choose your project.
- Select ‘Settings / Discord Bot’ from the left-hand menu.
- 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
- Navigate to your project page
- Go to Settings → Integrations
- Choose your desired integration
- Follow the connection wizard
- Configure field mappings
Next Steps
With your integrations set up, you’re ready to:
- Learn about managing feedback - Handle incoming bug reports
- Explore advanced features - Discover AI-powered capabilities