Game Management Troubleshooting

Common issues with game management and their solutions.

Game Import Issues

Game Not Importing

Symptoms:

• Import button not working
• Error during import
• Game data not loading

Solutions:

• Verify Riot Game ID is correct
• Check region selection matches game region
• Ensure game has completed (not in progress)
• Verify Riot API is accessible
• Check tournament code matches
• Try importing again
• Check for API rate limits

"Game Not Found" Error

Symptoms:

• Error: "Game not found"
• Import fails with not found error

Solutions:

• Double-check Riot Game ID
• Verify game exists in Riot system
• Check region is correct
• Ensure game has finished
• Verify API access to match data
• Check game age (very old games may not be available)

"Game Already Exists" Error

Symptoms:

• Error: "Game already imported"
• Cannot import game again

Solutions:

• Check game status - should show "Completed"
• Verify game was already imported
• Check for duplicate imports
• Re-import to update data if needed
• Review game list for duplicates

Import Fails Silently

Symptoms:

• Import appears to work but game not imported
• No error message but game still pending

Solutions:

• Check server logs for errors
• Verify Riot API response
• Check network connectivity
• Review import process
• Try importing again
• Check for API errors

Game State Issues

Game Stuck in Pending

Symptoms:

• Game won't transition from Pending
• Import not working
• Game remains pending

Solutions:

• Try importing the game
• Check if game has finished
• Verify Riot Game ID is correct
• Check for import errors
• Review game state logic
• Manually update state if needed

Game Not Completing

Symptoms:

• Game imported but not marked Complete
• Status not updating

Solutions:

• Verify import completed successfully
• Check game data was stored
• Refresh the page
• Review state transition logic
• Check for state update errors

Games Not Skipping

Symptoms:

• Games not auto-skipping when match completes
• Unused games still showing Pending

Solutions:

• Verify match is marked as Completed
• Check match score is correct
• Ensure system processed match completion
• Review auto-skip logic
• Manually skip if needed (rare)

Wrong State Displayed

Symptoms:

• Game shows incorrect state
• State doesn't match actual status

Solutions:

• Refresh the page
• Re-import game if needed
• Check game data in database
• Verify state transitions occurred
• Clear browser cache

Tournament Code Issues

Codes Not Generating

Symptoms:

• Games don't have tournament codes
• Code generation fails

Solutions:

• Verify tournament is linked to Riot
• Check Riot integration is configured
• Ensure Riot API access is valid
• Verify provider and tournament IDs
• Generate codes manually if needed
• Check for generation errors

Codes Missing

Symptoms:

• Games created but no codes
• Codes not appearing in UI

Solutions:

• Check Riot integration status
• Verify codes were generated
• Generate codes manually
• Check for generation errors
• Review code generation process
• Ensure tournament has Riot ID

Codes Not Working

Symptoms:

• Teams can't use codes in-game
• Codes rejected by League client

Solutions:

• Verify code is correct
• Check code hasn't expired
• Ensure region matches
• Verify Riot service status
• Try regenerating code
• Check code format

Wrong Codes

Symptoms:

• Codes don't match games
• Code points to wrong game

Solutions:

• Regenerate codes
• Verify game-to-code mapping
• Check code metadata
• Review code generation process
• Ensure codes linked correctly

Riot Callback Issues

Callbacks Not Received

Symptoms:

• Games not importing automatically
• No callbacks arriving

Solutions:

• Verify callback URL is correct
• Check URL is publicly accessible
• Ensure HTTPS is used (production)
• Verify Riot configuration
• Check server logs for errors
• Test callback endpoint manually
• Verify webhook is registered with Riot

Callbacks Received But Not Processing

Symptoms:

• Callbacks arrive but games not importing
• Callback errors in logs

Solutions:

• Check server logs for errors
• Verify callback data format
• Check tournament code matching
• Verify Riot API access
• Check game identification logic
• Review import process
• Validate callback data

Games Not Found from Callback

Symptoms:

• Callback can't find matching game
• Game not identified from code

Solutions:

• Verify tournament code matches
• Check game exists in system
• Ensure codes were generated correctly
• Verify code format is correct
• Check game state (should be Pending)
• Review code-to-game mapping

Match Score Issues

Score Not Updating

Symptoms:

• Games imported but match score unchanged
• Score incorrect after import

Solutions:

• Verify game result was imported
• Check winning team identified correctly
• Refresh the page
• Review score calculation logic
• Check for score update errors
• Manually update score if needed

Wrong Score Displayed

Symptoms:

• Match score shows incorrect values
• Score doesn't match games

Solutions:

• Verify all games imported correctly
• Check game results are correct
• Review score calculation
• Verify game-to-score mapping
• Recalculate score if needed

Match Not Completing

Symptoms:

• Match should be complete but isn't
• Games finished but match still active

Solutions:

• Verify required wins reached
• Check match completion logic
• Ensure all games imported
• Review best_of setting
• Manually complete if needed

Data Issues

Missing Game Data

Symptoms:

• Game imported but data incomplete
• Statistics missing

Solutions:

• Re-import game to refresh data
• Check Riot API data availability
• Verify data import process
• Check for partial imports
• Review data mapping

Incorrect Statistics

Symptoms:

• Game statistics are wrong
• Player data incorrect

Solutions:

• Verify Riot Game ID is correct
• Re-import game to refresh data
• Check data mapping logic
• Verify source data from Riot
• Review statistics calculation

Duplicate Games

Symptoms:

• Same game imported multiple times
• Duplicate game entries

Solutions:

• Check for duplicate imports
• Remove duplicate entries
• Verify import validation
• Review import process
• Prevent future duplicates

Performance Issues

Slow Imports

Symptoms:

• Game imports take too long
• Timeout errors

Solutions:

• Check network connectivity
• Verify Riot API response time
• Check for API rate limits
• Review import process efficiency
• Optimize import logic
• Check server performance

Import Timeouts

Symptoms:

• Imports timing out
• Requests failing

Solutions:

• Increase timeout settings
• Check Riot API status
• Verify network stability
• Review import process
• Optimize API calls
• Check server resources

General Troubleshooting Steps

Basic Steps

1. Refresh Page: Often fixes display issues
2. Check Status: Verify game/match status
3. Verify Data: Ensure data is correct
4. Review Logs: Check for error messages
5. Try Again: Retry the operation

Advanced Steps

1. Check API Access: Verify Riot API working
2. Review Configuration: Check Riot integration
3. Test Manually: Test import process manually
4. Check Database: Verify data in database
5. Contact Support: Reach out if issue persists

Getting Help

When to Contact Support

Contact support if:

• Issue persists after troubleshooting
• Error messages are unclear
• Data appears corrupted
• System behavior is unexpected
• Integration issues occur

Information to Provide

When contacting support:

• Description: Clear description of issue
• Steps to Reproduce: How to recreate
• Expected Behavior: What should happen
• Actual Behavior: What actually happens
• Screenshots: Visual evidence
• Error Messages: Any error messages
• Logs: Relevant log entries

Related Articles

• Importing Games
• Game States
• Riot Callback Integration
• Tournament Codes
• Common Issues