Ігри з друзями

Використовуйте вкладки Founder / Developer на бічній панелі документації, щоб фільтрувати цю сторінку. Видимість у бічній панелі налаштовується в lib/docs/audience-curated-docs.ts.

Ring постачає мініігри для друзів, які повторно використовують fan-out Tunnel, набір інтерактивних повідомлень і IA публічного профілю — без GameConductor, паралельного стека повідомлень чи ставок.

Поверхня	Шлях
Маркетплейс	`/games`
Мініапка	`/games/[slug]?session=`
Публічна доступність	`/{username}/games`
Керування власника	`/profile/games` (Member)
Віджет чату	тип повідомлення / `metadata.kind` = `game_request`
Вхідний банер	MessagesShell і layout `/games`

Доступні назви: хрестики-нулики · шахи · шашки. Тексти каталогу локалізуються через locales/*/modules/games.json (modules.games); англійські рядки в catalog.ts залишаються резервним варіантом для FCM/історії.

Чому це важливо для вашого клону

Учасники швидше зближуються, коли можуть грати, не залишаючи ваш Ring. Виклики надходять як віджети чату та як глобальний IncomingGameBanner у Messages і /games — тож запрошення не губляться за межами гілки месенджера.

Безплатна перевага Member — без ставок Stars / кредитів / PaymentConductor
Лише прямі розмови (той самий gate, що й для дзвінків 1:1)
М’ютекс дзвінка ↔ гри (між вкладками через BroadcastChannel): не можна прийняти гру під час активного дзвінка і навпаки
Публічна дія Грати зі мною пропонує лише slug-и, які гравець увімкнув на /{username}/games
Неприйняті запрошення спливають через 15 хвилин; активні ігри бездіяльні та очищуються через 2 години

Чекліст оператора

Підтвердьте членство, щоб власники могли відкрити /profile/games і опублікувати доступність (шахи / шашки / хрестики-нулики).
Перевірте /games у кожній локалі — назви каталогу мають локалізуватися (EN/UK/RU/ES/DE).
У прямому чаті створіть ігровий виклик → співрозмовник бачить банер і віджет.
Прийміть → зробіть ходи → здайтеся; обидві сторони оновлюються без перезавантаження.
Переконайтеся, що телефонний/відеодзвінок блокує прийняття гри, поки накладка дзвінка активна (також спробуйте другу вкладку браузера).
Необов’язково: залиште неприйняте запрошення приблизно на 15 хвилин (або запустіть cron завершення сесій) → банер і мініапка очищуються.

Повідомлення

Архітектура

Ключові модулі

Шлях	Роль
`features/peer-games/service.ts`	Сесії + доступність + SSOT createInvite
`features/peer-games/session-expiry.ts`	Повернення сиріт + завершення неприйнятих/неактивних сесій
`features/peer-games/plugins/*-logic.ts`	Безпечні для сервера validate/apply (ttt, chess, checkers)
`features/peer-games/catalog.ts`	Реєстр slug-ів (резервний EN)
`locales/*/modules/games.json`	i18n каталогу + маркетплейсу (`modGames`)
`features/peer-games/lib/peer-game-mutex.ts`	Зайнятість дзвінка/гри + BroadcastChannel / Web Locks
`features/peer-games/lib/catalog-i18n.ts`	Хелпери локалізованих назв/описів

Пов’язана документація

Ігри з друзями

Поверхня	Шлях
Маркетплейс	`/games`
Мініапка	`/games/[slug]?session=`
Публічна доступність	`/{username}/games`
Керування власника	`/profile/games` (Member)
Віджет чату	тип повідомлення / `metadata.kind` = `game_request`
Вхідний банер	MessagesShell і layout `/games`

Чому це важливо для вашого клону

Безплатна перевага Member — без ставок Stars / кредитів / PaymentConductor
Лише прямі розмови (той самий gate, що й для дзвінків 1:1)
М’ютекс дзвінка ↔ гри (між вкладками через BroadcastChannel): не можна прийняти гру під час активного дзвінка і навпаки
Публічна дія Грати зі мною пропонує лише slug-и, які гравець увімкнув на /{username}/games
Неприйняті запрошення спливають через 15 хвилин; активні ігри бездіяльні та очищуються через 2 години

Чекліст оператора

Підтвердьте членство, щоб власники могли відкрити /profile/games і опублікувати доступність (шахи / шашки / хрестики-нулики).
Перевірте /games у кожній локалі — назви каталогу мають локалізуватися (EN/UK/RU/ES/DE).
У прямому чаті створіть ігровий виклик → співрозмовник бачить банер і віджет.
Прийміть → зробіть ходи → здайтеся; обидві сторони оновлюються без перезавантаження.
Переконайтеся, що телефонний/відеодзвінок блокує прийняття гри, поки накладка дзвінка активна (також спробуйте другу вкладку браузера).
Необов’язково: залиште неприйняте запрошення приблизно на 15 хвилин (або запустіть cron завершення сесій) → банер і мініапка очищуються.

Повідомлення

Архітектура

Ключові модулі

Шлях	Роль
`features/peer-games/service.ts`	Сесії + доступність + SSOT createInvite
`features/peer-games/session-expiry.ts`	Повернення сиріт + завершення неприйнятих/неактивних сесій
`features/peer-games/plugins/*-logic.ts`	Безпечні для сервера validate/apply (ttt, chess, checkers)
`features/peer-games/catalog.ts`	Реєстр slug-ів (резервний EN)
`locales/*/modules/games.json`	i18n каталогу + маркетплейсу (`modGames`)
`features/peer-games/lib/peer-game-mutex.ts`	Зайнятість дзвінка/гри + BroadcastChannel / Web Locks
`features/peer-games/lib/catalog-i18n.ts`	Хелпери локалізованих назв/описів

Пов’язана документація

Ігри з друзями

Поверхня	Шлях
Маркетплейс	`/games`
Мініапка	`/games/[slug]?session=`
Публічна доступність	`/{username}/games`
Керування власника	`/profile/games` (Member)
Віджет чату	тип повідомлення / `metadata.kind` = `game_request`
Вхідний банер	MessagesShell і layout `/games`

Чому це важливо для вашого клону

Безплатна перевага Member — без ставок Stars / кредитів / PaymentConductor
Лише прямі розмови (той самий gate, що й для дзвінків 1:1)
М’ютекс дзвінка ↔ гри (між вкладками через BroadcastChannel): не можна прийняти гру під час активного дзвінка і навпаки
Публічна дія Грати зі мною пропонує лише slug-и, які гравець увімкнув на /{username}/games
Неприйняті запрошення спливають через 15 хвилин; активні ігри бездіяльні та очищуються через 2 години

Чекліст оператора

Підтвердьте членство, щоб власники могли відкрити /profile/games і опублікувати доступність (шахи / шашки / хрестики-нулики).
Перевірте /games у кожній локалі — назви каталогу мають локалізуватися (EN/UK/RU/ES/DE).
У прямому чаті створіть ігровий виклик → співрозмовник бачить банер і віджет.
Прийміть → зробіть ходи → здайтеся; обидві сторони оновлюються без перезавантаження.
Переконайтеся, що телефонний/відеодзвінок блокує прийняття гри, поки накладка дзвінка активна (також спробуйте другу вкладку браузера).
Необов’язково: залиште неприйняте запрошення приблизно на 15 хвилин (або запустіть cron завершення сесій) → банер і мініапка очищуються.

Повідомлення

Архітектура

Ключові модулі

Шлях	Роль
`features/peer-games/service.ts`	Сесії + доступність + SSOT createInvite
`features/peer-games/session-expiry.ts`	Повернення сиріт + завершення неприйнятих/неактивних сесій
`features/peer-games/plugins/*-logic.ts`	Безпечні для сервера validate/apply (ttt, chess, checkers)
`features/peer-games/catalog.ts`	Реєстр slug-ів (резервний EN)
`locales/*/modules/games.json`	i18n каталогу + маркетплейсу (`modGames`)
`features/peer-games/lib/peer-game-mutex.ts`	Зайнятість дзвінка/гри + BroadcastChannel / Web Locks
`features/peer-games/lib/catalog-i18n.ts`	Хелпери локалізованих назв/описів

Пов’язана документація

Related documentation

Real-Time Messaging

Залежить від: game_request живе в наборі інтерактивних повідомлень і прямих розмовах.

WebRTC Calls & STUNner TURN

Tunnel Protocol

Залежить від: ACL conversation:*, game:{sessionId} і fan-out games:incoming.

SubscriptionConductor

Передумова: привілеї Member керують /profile/games і створенням викликів.

Канал	Події
`conversation:{id}`	`game:invite`, `game:accept`, `game:decline`, `game:resign`, `game:move`, `game:expire`
`game:{sessionId}`	`game:accept`, `game:decline`, `game:resign`, `game:move`, `game:expire`, `game:dc-signal`
інбокс користувача	`games:incoming` (invite, `accepted`, `terminal`)

Випадок	TTL	Результат
Осиротіла неприйнята сесія (без `messageId`)	~2m	Повернення
Неприйняте запрошення	15m	Відхилено + `updateMessageLocked`
Активна бездіяльність	2h	Здано/завершено + сповіщення Tunnel

text


createGameRequest / POST …/game-invite / challengeUserToGameAction
  → PeerGameService.createInvite (SSOT)
  → Redis SET NX claim peer-game:invite:{from}:{to}:{slug} (Map fallback)
  → create session (peer_game_sessions) FIRST
  → send game_request message → link messageId
  → on failure: delete session + releaseNx
  → publishToChannel(conversation:…, game:invite)
  → publishToUserTunnel(peer, games:incoming)
  → if !deliveredLive: sleep ~500ms; FCM GAME_REQUEST only if still !isUserConnected
accept / decline / resign / submitMove
  → participant ACL + plugin validateMove/applyMove
  → updateMessageLocked on linked widget metadata
  → game:* on game:{sessionId} AND conversation:{id}
  → decline/expire also publish terminal on games:incoming (banner clear)
client mini-app
  → hydrate DB SSOT → useTunnelChannel(game:{id})
  → optional RTCDataChannel optimistic hints (fetchIceServers); server remains SSOT

Канал	Події
`conversation:{id}`	`game:invite`, `game:accept`, `game:decline`, `game:resign`, `game:move`, `game:expire`
`game:{sessionId}`	`game:accept`, `game:decline`, `game:resign`, `game:move`, `game:expire`, `game:dc-signal`
інбокс користувача	`games:incoming` (invite, `accepted`, `terminal`)

Випадок	TTL	Результат
Осиротіла неприйнята сесія (без `messageId`)	~2m	Повернення
Неприйняте запрошення	15m	Відхилено + `updateMessageLocked`
Активна бездіяльність	2h	Здано/завершено + сповіщення Tunnel

text


createGameRequest / POST …/game-invite / challengeUserToGameAction
  → PeerGameService.createInvite (SSOT)
  → Redis SET NX claim peer-game:invite:{from}:{to}:{slug} (Map fallback)
  → create session (peer_game_sessions) FIRST
  → send game_request message → link messageId
  → on failure: delete session + releaseNx
  → publishToChannel(conversation:…, game:invite)
  → publishToUserTunnel(peer, games:incoming)
  → if !deliveredLive: sleep ~500ms; FCM GAME_REQUEST only if still !isUserConnected
accept / decline / resign / submitMove
  → participant ACL + plugin validateMove/applyMove
  → updateMessageLocked on linked widget metadata
  → game:* on game:{sessionId} AND conversation:{id}
  → decline/expire also publish terminal on games:incoming (banner clear)
client mini-app
  → hydrate DB SSOT → useTunnelChannel(game:{id})
  → optional RTCDataChannel optimistic hints (fetchIceServers); server remains SSOT

Канал	Події
`conversation:{id}`	`game:invite`, `game:accept`, `game:decline`, `game:resign`, `game:move`, `game:expire`
`game:{sessionId}`	`game:accept`, `game:decline`, `game:resign`, `game:move`, `game:expire`, `game:dc-signal`
інбокс користувача	`games:incoming` (invite, `accepted`, `terminal`)

Випадок	TTL	Результат
Осиротіла неприйнята сесія (без `messageId`)	~2m	Повернення
Неприйняте запрошення	15m	Відхилено + `updateMessageLocked`
Активна бездіяльність	2h	Здано/завершено + сповіщення Tunnel

text


createGameRequest / POST …/game-invite / challengeUserToGameAction
  → PeerGameService.createInvite (SSOT)
  → Redis SET NX claim peer-game:invite:{from}:{to}:{slug} (Map fallback)
  → create session (peer_game_sessions) FIRST
  → send game_request message → link messageId
  → on failure: delete session + releaseNx
  → publishToChannel(conversation:…, game:invite)
  → publishToUserTunnel(peer, games:incoming)
  → if !deliveredLive: sleep ~500ms; FCM GAME_REQUEST only if still !isUserConnected
accept / decline / resign / submitMove
  → participant ACL + plugin validateMove/applyMove
  → updateMessageLocked on linked widget metadata
  → game:* on game:{sessionId} AND conversation:{id}
  → decline/expire also publish terminal on games:incoming (banner clear)
client mini-app
  → hydrate DB SSOT → useTunnelChannel(game:{id})
  → optional RTCDataChannel optimistic hints (fetchIceServers); server remains SSOT

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Loading documentation...

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Loading documentation...

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Loading documentation...

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Loading documentation...

Loading documentation...

Loading documentation...

Ігри з друзями

Чому це важливо для вашого клону

Чекліст оператора

Повідомлення

Пов’язана документація

Related documentation

Real-Time Messaging

WebRTC Calls & STUNner TURN

Tunnel Protocol

SubscriptionConductor

Ігри з друзями

Чому це важливо для вашого клону

Чекліст оператора

Повідомлення

Пов’язана документація

Related documentation

Real-Time Messaging

WebRTC Calls & STUNner TURN

Tunnel Protocol

SubscriptionConductor

Ігри з друзями

Чому це важливо для вашого клону

Чекліст оператора

Повідомлення

Пов’язана документація

Related documentation

Real-Time Messaging

WebRTC Calls & STUNner TURN

Tunnel Protocol

SubscriptionConductor

Дзвінки WebRTC

Членство

Публічний профіль

Збереження даних

Канали Tunnel (перевірено)

Сповіщення та FCM

М’ютекс, дедуплікація, дошки

Завершення сесій

DataChannel (лише оптимістичний режим)

Серверні дії

Smoke / soak

Public Profile Pages

Push Notifications with FCM (Ring-Powered)

Notifications

Дзвінки WebRTC

Членство

Публічний профіль

Збереження даних

Канали Tunnel (перевірено)

Сповіщення та FCM

М’ютекс, дедуплікація, дошки

Завершення сесій

DataChannel (лише оптимістичний режим)

Серверні дії

Smoke / soak

Public Profile Pages

Push Notifications with FCM (Ring-Powered)

Notifications

Дзвінки WebRTC

Членство

Публічний профіль

Збереження даних