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
- In Unity, open Window → Package Manager, click + → Add package from git URL and enter
https://github.com/betahub-io/unity-plugin.git. - When Unity offers to download FFmpeg, click Download. Video in reports needs it.
Quick Start
- GameObject → BetaHub → Bug Report Widget adds the report form to the open scene.
- On its BetaHub Reporter component, enter your Project ID and Auth Token, both in Settings → Integrations → Auth Tokens.
- Run your game and press
F12to 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
- 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
Pluginsdirectory: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
F12to 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
- 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
After inviting the bot, use the interactive setup wizard to connect and configure it:
- Type
/installin any channel where the bot is active - Click Connect Project and paste your project token from BetaHub → Settings → Discord Bot
- Click 🐛 Bugs → Set up Bug Channels to select your bug reporting channels
- 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
Listen Mode: Enable AI-powered bug detection in conversations
Thread Mode: Create threads for each bug report
Threads Channel (Optional): Specify which channel to use for threads
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
- Navigate to your project page
- Go to Settings → Integrations
- Choose your desired integration
- Follow the connection wizard
- Configure field mappings
See Also
- Project Setup – Create and configure projects
- Game Engines – Unity and Unreal integration
- Roblox Integration – In-game feedback for Roblox
- HTML Widget – Web and HTML5 game integration
- Discord Bot – Community feedback via Discord
- Project Settings – Configure project options
- Getting Started – Quick start guide