Game States and Status

Understanding the different states games can be in and what each state means.

Game States Overview

Games can be in one of four states:

• Pending: Game hasn't been played yet
• Completed: Game has been imported and completed
• Skipped: Game wasn't needed (match ended early)
• In Progress: Game is currently being played

Pending State

Characteristics

Visual Indicator: Yellow color, "Pending" label

What It Means:

• Game slot exists but hasn't been played
• Ready to be imported when game finishes
• Shows "Import Game" button in admin UI

When Games Are Pending:

• Immediately after match creation
• Before game is played
• After game finishes but before import

Actions Available

• Import Game: Can import game data
• View Details: Can see game slot information
• Generate Code: Can generate tournament code (if not already generated)

Transitioning from Pending

Games move from Pending to:

• Completed: When game is imported successfully
• Skipped: When match completes early and game isn't needed
• In Progress: When manually marked as in progress (rare)

Completed State

Characteristics

Visual Indicator: Green color, "Completed" label

What It Means:

• Game has been imported from Riot's API
• Contains full statistics and participant data
• Match score has been updated based on result

When Games Are Completed:

• After successful game import
• When Riot callback automatically imports game
• When game data is fetched and stored

Data Available

Completed games include:

• Match Result: Which team won
• Player Statistics: KDA, CS, damage, etc.
• Game Duration: How long the game lasted
• Participant Data: All player information
• Match Timeline: Game events and timeline data

Actions Available

• View Statistics: See detailed game statistics
• View Participants: See player data
• Re-import: Can re-import to update data
• Export Data: Export game data if needed

Match Score Update

When a game is completed:

• Match score is automatically updated
• Winning team gets +1 to their score
• Match completion is checked
• Unused games may be skipped if match completes

Skipped State

Characteristics

Visual Indicator: Gray color, "Skipped" label, strikethrough text

What It Means:

• Game was not needed because match ended early
• Automatically marked when match completes
• Cannot be imported or played

When Games Are Skipped:

• Match completes before all games are played
• Example: Best of 3 match ends 2-0, Game 3 is skipped
• System automatically skips unused games

Auto-Skip Logic

Games are automatically skipped when:

1. Match reaches completion (team has required wins)
2. Remaining games are not needed
3. System marks them as "Skipped"
4. Games become read-only

Example:

• Best of 3 match
• Team A wins Game 1 and Game 2
• Match completes (Team A has 2 wins)
• Game 3 is automatically skipped

Actions Available

• View Information: Can see game slot (read-only)
• Cannot Import: Skipped games cannot be imported
• Cannot Play: Game slot cannot be used

In Progress State

Characteristics

Visual Indicator: Blue color, "In Progress" label

What It Means:

• Game is currently being played
• Rarely used, mostly for manual tracking
• Can be set manually if needed

When Games Are In Progress:

• Manually marked by admin/staff
• During live game tracking
• When monitoring active games

Use Cases

In Progress state is useful for:

• Live Tracking: Marking games as they start
• Manual Monitoring: Tracking games manually
• Status Updates: Updating game status during play

Transitioning from In Progress

Games move from In Progress to:

• Completed: When game finishes and is imported
• Pending: If manually reset (rare)

State Transitions

Normal Flow

Typical Game Lifecycle:

1. Pending → Game slot created
2. In Progress → Game starts (optional, manual)
3. Completed → Game finishes and is imported

Early Match Completion

When Match Ends Early:

1. Pending → Game slot created
2. Completed → Required games finish
3. Skipped → Remaining games auto-skipped

Automatic Transitions

System-Controlled:

• Pending → Completed: When game is imported
• Pending → Skipped: When match completes early
• Completed: Triggers match score update

Manual Transitions:

• Pending → In Progress: Manual marking (optional)
• In Progress → Completed: After import

Understanding State Colors

Color Coding

• Yellow (Pending): Waiting to be played/imported
• Green (Completed): Successfully imported
• Gray (Skipped): Not needed, match ended early
• Blue (In Progress): Currently being played

Visual Indicators

States are displayed with:

• Color Background: Colored badge or indicator
• Text Label: State name displayed
• Icons: Visual icons (if applicable)
• Strikethrough: Skipped games show strikethrough

Common Scenarios

All Games Pending

Scenario: Match created, no games imported yet

What You See:

• All games show "Pending" (yellow)
• "Import Game" buttons available
• Tournament codes visible (if generated)

Action: Import games as they finish

Some Games Completed

Scenario: Match in progress, some games finished

What You See:

• Completed games show "Completed" (green)
• Pending games show "Pending" (yellow)
• Match score updated based on completed games

Action: Continue importing remaining games

Match Completed Early

Scenario: Best of 3 match ends 2-0

What You See:

• Game 1: Completed (green)
• Game 2: Completed (green)
• Game 3: Skipped (gray, strikethrough)
• Match: Completed

Action: No action needed, system handled it

All Games Completed

Scenario: Full match played (e.g., Best of 3 goes to Game 3)

What You See:

• All games show "Completed" (green)
• Match shows "Completed"
• Full statistics available

Action: Review statistics, export data if needed

Best Practices

State Management

• Monitor States: Regularly check game states
• Import Promptly: Import games soon after completion
• Trust Auto-Skip: Let system handle skipped games
• Use In Progress Sparingly: Only when needed for tracking

State Verification

• Check Before Import: Verify game is Pending before importing
• Confirm Completion: Verify games show Completed after import
• Review Skipped: Understand why games were skipped
• Monitor Transitions: Watch for automatic state changes

Troubleshooting

Game Stuck in Pending

Problem: Game won't transition from Pending

Solutions:

• Try importing the game
• Check if game has finished
• Verify Riot Game ID is correct
• Check for import errors

Game Not Skipping

Problem: Games not auto-skipping when match completes

Solutions:

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

Wrong State Displayed

Problem: Game shows incorrect state

Solutions:

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

Related Articles

• Game System Overview
• Importing Games
• Riot Callback Integration
• Match Management