Troubleshooting Connection Issues

This guide helps you diagnose and fix common problems when connecting to GameGlue.

Quick Checklist

Before diving into specific issues, verify these basics:

• [ ] GameGlue Desktop Client is running
• [ ] Desktop Client shows "Connected" status
• [ ] The game is running with an active session (not in menus)
• [ ] Your browser isn't blocking popups (for login)
• [ ] You're using the correct Client ID

Common Issues

Login Keeps Redirecting

Symptoms: You log in successfully but keep getting redirected to login again.

Causes and fixes:

1. Redirect URL mismatch

   • Your redirect URL in the Developer Hub must match exactly
   • Check protocol: http vs https
   • Check port: localhost:3000 vs localhost:5173
   • Check trailing slashes: http://localhost:3000 vs http://localhost:3000/

2. Cookies blocked

   • GameGlue uses cookies to maintain the session
   • Check that third-party cookies aren't blocked
   • Try in a private/incognito window to rule out extensions

3. OAuth callback not handled

   • Make sure isAuthenticated() is called on page load
   • This handles the OAuth callback when returning from login

// This must run on every page load
const isAuthed = await ggClient.isAuthenticated();

No Data Received

Symptoms: Connected successfully but dashboard shows no data or stays at initial values.

Causes and fixes:

1. Game not running or paused

   • Start a flight in MSFS (not just the main menu)
   • Make sure the simulation isn't paused

2. Desktop Client not connected

   • Open the GameGlue Desktop Client
   • It should show "Connected" and the game name

3. Wrong game ID

   • Verify you're using the correct game ID (e.g., msfs for Microsoft Flight Simulator)

4. Field names incorrect

   • Check that requested field names match exactly
   • See MSFS Readable Data for valid field names

Connection Failed Error

Symptoms: Error message about connection failure.

Causes and fixes:

1. Network issues

   • Check your internet connection
   • Try refreshing the page

2. Client ID invalid

   • Verify your Client ID in the Developer Hub
   • Make sure you copied the full ID

3. Service temporarily unavailable

   • GameGlue services may be undergoing maintenance
   • Try again in a few minutes

Commands Not Working

Symptoms: Commands send but nothing happens in-game.

Causes and fixes:

1. Missing write scope
   • You need msfs:write scope to send commands
   • Add it to your scopes array and log in again

scopes: ['msfs:read', 'msfs:write']

2. Command not applicable

   • Some commands only work in certain states
   • Gear won't retract when on the ground
   • Autopilot may not engage at low speeds

3. Game doesn't have focus

   • Some commands require MSFS to be the active window

"Unauthorized" Errors

Symptoms: API returns 401 or "unauthorized" messages.

Causes and fixes:

1. Session expired

   • Sessions can expire after inactivity
   • Call isAuthenticated() and handle re-login if needed

2. Wrong scopes

   • If you need different permissions, log out and back in with updated scopes

3. Application not registered

   • Verify your app exists in the Developer Hub
   • Check that the Client ID matches

Debug Mode

Add console logging to help diagnose issues:

const listener = await ggClient.createListener({
  userId: userId,
  gameId: 'msfs',
  fields: ['indicated_altitude']
});

listener.on('update', (evt) => {
  console.log('Data received:', evt.data);
});

listener.on('error', (err) => {
  console.error('Listener error:', err);
});

listener.on('disconnect', () => {
  console.warn('Disconnected from GameGlue');
});

Getting Help

If you're still stuck:

1. Check the GameGlue Discord for community help
2. Email support@gameglue.gg with:
   • What you're trying to do
   • The error message (if any)
   • Your browser and OS
   • Whether the Desktop Client shows "Connected"