Project Settings

Configure your BetaHub project to optimize game testing, feedback collection, and team collaboration. Project settings control everything from basic project information to advanced AI features and integrations.

Accessing Project Settings

To access your project settings:

1. Navigate to your project dashboard
2. Click Settings in the project sidebar
3. Choose the appropriate settings category

Permission Required: You must have Developer role or higher to access and modify project settings.

General Settings

The General settings page contains the core configuration options for your project.

Project Information

Project Name

• The display name for your project across BetaHub
• Visible to all project members and in public project listings
• Can be changed at any time without affecting functionality

Organization

• Associates your project with an organization for billing and team management
• Cannot be changed for existing projects from the settings page
• For new projects, select from available organizations or create a new one

Access Control

• Private: Project is invite-only and not listed publicly
• Public: Project appears in public listings and anyone can join
• Projects under review or rejected by moderators are automatically set to private

Content Settings

• Mature Content: Mark if your project contains mature themes
• Affects visibility and filtering in public project listings
• Required for appropriate content categorization

Banner

• Upload a banner image to represent your project
• Required for inclusion in the public projects list
• Supports standard image formats (JPG, PNG, etc.)

Description

• Detailed project description supporting Markdown formatting
• Displayed on your project’s main page and in search results
• Use this to explain your game’s concept, testing goals, and desired feedback

Social Media Links

• Add links to your social media profiles and community spaces
• Supports Twitter, Discord, YouTube, Twitch, Reddit, Steam, and more
• Helps players connect with your broader community

Platforms

• Select all platforms your game supports
• Affects device selection options when users report bugs
• Used for filtering and categorization

Bug Handling Settings

Bug Description Validation Level (0-3)

• Level 0: No validation - accepts any description length
• Level 1: Basic validation - requires minimum description length
• Level 2: Moderate validation - AI checks for basic detail requirements
• Level 3: Strict validation - AI ensures comprehensive bug descriptions
• Higher levels improve bug quality but may create barriers for some users

Bug Auto-Archive

• Automatically archives bugs that haven’t been updated for a specified number of days
• Archived bugs don’t appear in default views but remain accessible
• Helps keep your active bug list manageable
• Set archive threshold between 1-365 days

Bug Description Display

• Show AI summary, collapse original: Displays AI-generated summaries prominently
• Show both AI summary and original: Shows all content expanded
• Show original description only: Hides AI-generated content
• Particularly relevant for bugs imported from Discord or other integrations

Bug Title Generation Language

• Choose the language for AI-generated bug titles
• “Same as Description” adapts to the reporter’s language
• Consistent language options help maintain organized bug lists

Required Fields

• Require device information: Forces users to select a device when reporting bugs
• Helps with reproduction and prioritization
• Does not affect Discord bot submissions

Ticket Settings

Ticket Auto-Close

• Automatically closes tickets awaiting feedback after specified days
• Prevents tickets from staying in limbo indefinitely
• System adds explanatory comment when auto-closing
• Set threshold between 1-365 days

Tester Permissions

Bug Isolation

• When enabled, each tester can only see bugs they’ve reported themselves
• Useful for competitive testing or when privacy is important
• Overrides all other visibility settings when active

Commenting Permissions

• Allow Testers to Comment on All Bugs: Testers can comment on any accessible bug
• Restrict to Own Bugs: Testers can only comment on bugs they reported
• Affects community interaction and collaboration

Tester Media Visibility These settings control what testers can see from other testers’ bug reports:

• Screenshots: Allow viewing of screenshot attachments
• Videos: Allow viewing of video attachments
• Log Files: Allow viewing of log file attachments
• Device Information: Allow viewing of device details
• All settings are ignored when “Bug Isolation” is enabled
• Testers always see full content of their own bug reports

Features & Modules

Enable or disable core functionality for your project:

Available Modules:

• Bugs: Core issue tracking functionality
• Suggestions: Feature request collection and voting
• Sentiments: AI-powered sentiment analysis of feedback
• Tickets: Support ticket system for user assistance

Experimental Features

Cutting-edge features that may be unstable or incomplete:

Automation Tasks

• Enables Discord bot to request additional media/logs automatically
• Allows drag-and-drop media sharing in Discord without web login
• Makes bug reporting more intuitive for Discord users

Support Knowledge

• Enables bot responses to known bugs and common questions
• Reduces repetitive support workload
• Requires setup of knowledge base content

Keys Distribution

• Enables game key distribution to testers
• Supports automated key delivery and tracking
• Useful for closed beta testing

Playtesting

• Enables gameplay video upload and review system
• Allows developers to review tester gameplay sessions
• Supports structured playtesting workflows

Suggestion Settings

Split Behavior

• Automatic: AI automatically splits complex suggestions into separate items
• Manual Review: AI identifies splittable suggestions but waits for developer approval
• Manual review provides more control but requires additional developer time

Notification Settings

Configure how you receive notifications for this specific project:

• Instant Notifications: Immediate alerts for all activity
• Daily Digest: Summary email once per day
• Weekly Digest: Summary email once per week
• Disabled: No notifications for this project

Default Table Columns

Configure which columns appear by default in your project’s issues table:

• Users can still customize their individual view
• Affects the initial view for new users and guests
• Common columns include status, priority, tags, device, and assignment

Game Facts

Game Facts provide detailed information about your game to improve AI-powered features like bug categorization and duplicate detection.

Core Information

Description: Comprehensive overview of your game’s concept, mechanics, and goals Genre: Primary and secondary genres that best describe your game Target Audience: Age ranges and player types you’re targeting Platforms: Detailed platform support including version requirements

Core Mechanics

Key Features: List the most important gameplay elements Game Modes: Single-player, multiplayer, cooperative, etc. Controls: Platform-specific control schemes and input methods

Technical Specifications

Supported Platforms: Detailed platform compatibility Minimum System Requirements: Hardware and software requirements Performance Considerations: Known performance characteristics or limitations

Game Progression

Level Design: How levels or areas are structured Progression System: Character advancement, unlocks, achievements

Bug Reporting Guidelines

Critical Components: Game systems that are most important to test Non-Critical Components: Systems that are less critical for core experience Known Bugs: Currently known issues to help identify duplicates

Glossary

Define game-specific terms in categories:

• Items: In-game objects, tools, weapons, etc.
• Characters: NPCs, player characters, enemies
• Events: Quests, missions, special occurrences
• Locations: Areas, levels, maps
• Other Terms: Any other game-specific vocabulary

Discord Bot Integration

The Discord bot integration allows automatic bug collection and community engagement directly from your Discord server.

Setup Process

Step 1: Invite the Bot

• Click the “Invite the Bot” link to add BetaHub bot to your Discord server
• Ensure you have “Manage Server” permissions in Discord
• If bot is already installed elsewhere, the previous installation will be disconnected

Step 2: Associate with Project

• In the channel where you want the bot active, type /set
• Use the provided key-value pair exactly as shown:
  • Key: project
  • Value: Your project’s discord secret (displayed on the settings page)

Step 3: Configure Permissions

• Ensure your @everyone role or tester role has “Use Application Commands” permission
• This allows community members to use slash commands

Bot Features

Bug Reporting

• Users can report bugs with /report command
• Bot guides users through description process
• Automatically creates issues in your BetaHub project
• Provides links back to the web interface

Release Notifications

• Automatically posts release notes when you publish new versions
• Includes download links for easy access
• Mentions bug reporters who contributed to the release
• Configure with /set releases_channel true

Welcome Messages

• Greets new server members with project information
• Provides instructions for bug reporting and community participation
• Configure with /set welcome_channel true

Automatic Bug Collection

• Monitors #bugs channel (or similar) for messages
• Converts messages to bug reports automatically
• Works with channels named #bug-reports, #issues, etc.
• Configure specific channel with /set bugs_channel #channel-name

Configuration Commands

• /info: Check bot status and configuration
• /set project [secret]: Associate bot with your project
• /set releases_channel true/false: Enable/disable release notifications
• /set welcome_channel true/false: Enable/disable welcome messages
• /set bugs_channel #channel-name: Set specific bugs collection channel
• /set bugs_channel false: Disable automatic bug collection

Tags Management

Tags help categorize and organize bugs and suggestions for better tracking and filtering.

Bug Tags vs Suggestion Tags

• Bug Tags: Used for categorizing issues, crashes, and problems
• Suggestion Tags: Used for categorizing feature requests and improvements
• Each type has its own management interface but similar functionality

Creating and Managing Tags

Adding Tags

• Create tags with descriptive names that match your project’s needs
• Add descriptions to help team members understand when to use each tag
• Consider using consistent naming conventions

Tag Hierarchy

• Some tags can have parent-child relationships
• Useful for creating categories like “UI” with subtags “UI - Menu”, “UI - HUD”
• Helps with organization and filtering

Best Practices

• Start with broad categories, add specific tags as needed
• Use clear, consistent naming conventions
• Regularly review and consolidate similar tags
• Train team members on proper tag usage

Custom Fields

Custom fields allow you to collect additional structured information beyond the standard bug report fields.

Field Types and Uses

Custom fields can capture:

• Additional technical details specific to your game
• User experience metrics
• Reproduction environment details
• Business impact assessments
• Development priority factors

Configuration

• Define field names and types based on your needs
• Consider making fields optional to reduce reporter burden
• Use clear, descriptive field labels
• Provide examples or help text when appropriate

Team Invitations

Manage who has access to your project and at what permission level.

Invitation Process

• Generate invitation links for specific roles
• Share links with team members or testers
• Track invitation usage and acceptance
• Revoke unused invitations as needed

Role-Based Access

Different roles have different capabilities:

• Developer: Full project access and settings management
• Tester: Can report bugs and view permitted content based on project settings
• Viewer: Read-only access to permitted content

External Integrations

Connect your BetaHub project with external tools for streamlined workflow management.

Available Integrations

All integrations require an organization with the integrations feature enabled:

Jira

• Sync bugs to Jira issues for development tracking
• Bidirectional updates between platforms
• Customizable field mapping

Asana

• Create Asana tasks from bug reports
• Track development progress
• Team collaboration features

GitHub

• Link bugs to GitHub issues
• Connect to repository management workflow
• Support for GitHub issue templates

Monday.com

• Project management integration
• Custom workflow support
• Team collaboration features

Notion

• Documentation and knowledge base integration
• Custom database support
• Team wiki features

Redmine

• Open-source project management integration
• Issue tracking and time management
• Custom field support

Integration Setup

1. Ensure your organization has the integrations feature enabled
2. Navigate to the Integrations settings page
3. Select the integration you want to configure
4. Follow the authentication and setup process
5. Configure field mapping and sync preferences
6. Test the integration with a sample bug report

Best Practices

Getting Started

1. Start Simple: Configure basic project information first
2. Test Discord Bot: Set up bot integration early if using Discord
3. Define Tags: Create initial tag structure before collecting many reports
4. Set Permissions: Configure tester permissions based on your privacy needs
5. Enable Notifications: Set up appropriate notification levels for your team

Ongoing Management

1. Regular Review: Periodically review and update settings as your project evolves
2. Monitor Usage: Check which features are being used and adjust accordingly
3. Team Training: Ensure team members understand the settings and their impact
4. Feedback Loop: Ask testers about their experience and adjust settings to improve it

Advanced Configuration

1. AI Features: Use Game Facts to improve AI accuracy
2. Integrations: Set up external tool integrations for streamlined workflow
3. Custom Fields: Add project-specific data collection
4. Automation: Use experimental features to reduce manual work

Common Pitfalls to Avoid

1. Over-restricting Testers: Too many restrictions can discourage participation
2. Ignoring Notifications: Missing important updates due to poor notification settings
3. Inconsistent Tags: Poor tag management leads to disorganized reports
4. Skipping Game Facts: Missing opportunities for better AI assistance
5. Not Testing Settings: Failing to verify settings work as expected

Troubleshooting

Discord Bot Issues

• Verify bot has proper permissions in Discord
• Check that project association command was run correctly
• Ensure channel permissions allow bot to read messages
• Use /info command to verify bot status

Integration Problems

• Confirm organization has integrations feature enabled
• Verify authentication tokens are current
• Check field mapping configuration
• Test with simple bug reports first

Notification Issues

• Check both personal and project notification settings
• Verify email address is confirmed
• Look for notifications in spam/promotions folders
• Test with low-volume settings first

Permission Confusion

• Review role assignments for team members
• Understand difference between project and organization permissions
• Check tester visibility settings if users can’t see expected content
• Verify invitation links are for correct roles

Next Steps

After configuring your project settings:

• Team Management - Invite and manage your team members
• Release Management - Set up release tracking and notifications
• Integrations - Connect your project with external tools