Skip to content

docs: document 180s game invite join window after cold launch - #8669

Merged
markmandel merged 1 commit into
mainfrom
docs/game-invite-join-ttl
Oct 19, 2026
Merged

markmandel merged 1 commit into
mainfrom
docs/game-invite-join-ttl

Conversation

@markmandel

Copy link
Copy Markdown
Contributor

When a player accepts a game invite and the game isn't running, Discord launches it and holds the pending join until the Social SDK connects. That window was raised from 60 to 180 seconds, and it wasn't documented anywhere.

Added a warning to the "Accepting Game Invites" section of the Managing Game Invites guide that:

  • Explains the 180 second window, measured from when the player clicks "Join", and that the join is lost if the SDK doesn't connect in time.
  • Recommends registering Client::SetActivityJoinCallback before calling Client::Connect, since a join that arrives before the callback is registered is dropped.
  • Recommends initializing and connecting the SDK early in startup, holding on to the join secret, and acting on it once the player is ready.

Also added a change log entry and a Client::Connect reference link.

@markmandel
markmandel requested a review from a team as a code owner October 15, 2026 23:05
@markmandel
markmandel requested review from anthonydiscord and removed request for a team October 15, 2026 23:05
@mintlify

mintlify Bot commented Oct 15, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Discord 🟢 Ready View Preview Oct 15, 2026, 11:07 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

When a player accepts a game invite and the game isn't running, Discord
launches it and holds the pending join until the Social SDK connects.
That window was raised from 60 to 180 seconds, and it wasn't documented
anywhere.

Added a warning to the "Accepting Game Invites" section of the Managing
Game Invites guide that:

- Explains the 180 second window, measured from when the player clicks
  "Join", and that the join is lost if the SDK doesn't connect in time.
- Recommends registering `Client::SetActivityJoinCallback` before
  calling `Client::Connect`, since a join that arrives before the
  callback is registered is dropped.
- Recommends initializing and connecting the SDK early in startup,
  holding on to the join secret, and acting on it once the player is
  ready.

Also added a change log entry and a `Client::Connect` reference link.

@colinloretz colinloretz left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👾

@markmandel
markmandel merged commit fd75e22 into main Oct 19, 2026
5 checks passed
@markmandel
markmandel deleted the docs/game-invite-join-ttl branch October 19, 2026 21:47

This branch was successfully deployed

1 active deployment
staging — 2c31cb1d Deployed Oct 15, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants