---
# System prepended metadata

title: Reporting a Bug

---

# Reporting a Bug

*Hey player! Welcome to BetaHub's quick guide to squashing those bugs.*

## Quick Dive

Need the speedy version? Press Ctrl + Shift + S while gaming to pop up the bug reporting form. 🐞

## First Time Here? Let’s Sign You In

Looks like your game's got BetaHub running in the background (cool, right?). Before diving into the game, there's a tiny thing you need to do.

![image.png](https://hackmd.io/_uploads/B1XVTtI7a.png)


See the BetaHub launcher? It's gonna ask you to sign in. No BetaHub account? No worries! You can use your trusty Discord or Google account right here: https://app.betahub.io/users/sign_in

Once you’re signed in, make sure you're part of the game project. If you've already snatched the game build from BetaHub, you're probably good to go. If not:

- For public projects, just hit the project link in the launcher.
- Private project? If you get a "404 not found" when clicking the link, ping the game developer for an invite.

And... Boom! You should see your username, and that shiny “Start Game” button should be clickable.

![image.png](https://hackmd.io/_uploads/HyqUaF8Xp.png)

## Found a Bug? Let's Squash It!

To report that pesky bug, press Ctrl + Shift + S in-game. You'll see a big ol' message that we're setting up your bug submission.

![image.png](https://hackmd.io/_uploads/rJ4MCY8Qp.png)


:::info
Quick tip! If you want to pause your game, now's the time. Once you're in bug-reporting mode, the game takes a back seat.
:::

Your internet speed determines your wait time, but your bug form should pop up in a jiffy.

![image.png](https://hackmd.io/_uploads/SJ_Fb9U7T.png)


### The Nitty-Gritty Details

Here’s what you can add:

1. Screenshot (plus, doodle on it if you like!)
2. A 60-second video replay of your gameplay.
3. Engine log files (for the tech-savvy).

But, you gotta give us:

- A clear-as-day description of the issue.
- Steps to recreate the mischief.

Just a heads up: BetaHub has a smarty-pants AI (shoutout to GPT) that checks your input. So, make it good!

## Peek at Your Past Reports

Want to see the bugs you’ve reported or edit them? Head to https://app.betahub.io/bugs. Click on a bug title, then the edit button to jazz it up or fix any oopsies.

## Oh No, Something Went Wrong?

:::info
If you hit a snag with the overlay, let the game developer or the [BetaHub crew](https://app.betahub.io/feedback) know. We've got your back!
:::

### Game Goes “Poof” on Startup

Might be a hiccup with our bug-reporting overlay (yep, it's still in beta). Try this workaround:

1. Go to `launcher/app` (it's hanging out next to your main game file).
2. Double-click the game's name to start it.

### Game's Dragging Its Feet?

Check out the "Game Goes “Poof” on Startup" section above. Same fix might do the trick!