Check-in Streaks

Check-in streaks reward players for consistent daily engagement with games. When a player earns points on consecutive days, they build up a streak that can unlock bonuses and recognition.

How Streaks Work

• A streak counts the number of consecutive days a player has earned points in a game

• The streak resets if a player misses a day

• Streaks are tracked per game - each game has its own streak counter

• The system looks back up to 30 days to calculate the current streak

For Players

Players can see their streak status on the game page, showing:

• Current streak - Number of consecutive days played

• Today's status - Whether they've checked in today

For Game Developers

No integration work required! Streaks are automatically tracked when players earn points through the SDK.

If you want to display streak information in your game UI, you can fetch the player's streak data:

Get Player Streak (via SDK session)

// From within a game using the SDK
const response = await fetch(
  'https://api.opengameprotocol.com/play/streak',
  {
    headers: {
      'Authorization': `Bearer ${sessionToken}`
    }
  }
);

const { today, streak } = await response.json();
// today: boolean - has the player earned points today?
// streak: number - consecutive days count

Get Player Streak (via Game Controller)

// From game page using user auth
const response = await fetch(
  `https://api.opengameprotocol.com/games/streak?gameId=${gameId}`,
  {
    headers: {
      'Authorization': `HMAC-SHA256 apiKey=... signature=... timestamp=...`
    }
  }
);

const { today, streak } = await response.json();

Response Format

{
  "today": true,
  "streak": 7
}

Field	Type	Description
today	boolean	Whether the player has earned points today
streak	number	Number of consecutive days with points (0-30)

UI Recommendations

Consider showing streak information to encourage daily play:

• Display a flame or streak icon with the current count

• Show a "checked in" badge when today is true

• Celebrate milestone streaks (7 days, 30 days, etc.)

• Show what they'll lose if they don't play today

Technical Details

• Streaks are calculated based on the PointsDaily records in the database

• A day counts toward the streak if the player has any points for that date

• The calculation uses UTC dates

• Maximum trackable streak is 30 days (rolling window)