# 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!