iDos Games
Create
Игровые системы

Пригласить друзей: коды, ссылки и награды

Как работает готовая система приглашений iDos Games - личный код и ссылка, подарок новичку и лестница наград за пришедших друзей - и как включить её в кабинете.

Обновлено: English

Приглашения приводят новых игроков: у каждого есть короткий код и ссылка, новичок получает подарок, а пригласивший поднимается по лестнице наград за пришедших друзей. Система есть в каждом новом проекте, но приглашения выключены, пока вы их не включите.

Что видит игрок

  • Свой короткий код с «Копировать» и «Поделиться» (системное окно отправки или буфер обмена).
  • Сколько друзей пришло по коду и лестницу наград за них, забрать одну или все.
  • Ввод кода друга: показывает подарок новичку и выдаёт его один раз.
  • «Вы пришли по коду друга» у игрока, привязанного при входе по ссылке-приглашению.
Пригласить друзей
12 450
320
Ваш код: KD7Q-PX2M
Копировать
Поделиться
1 друг · 200 кристаллов
Забрано
3 друга · сундук
Забрать
5 друзей · геройпришли 3 из 5
Ввести код друга
Свой код и ссылка-приглашение игрока.
Лестница наград за пришедших друзей; забрать одну или все.
Новичок вводит код друга и один раз получает подарок.
Пример. Экран приглашений: свой код, лестница наград и ввод кода.

Как устроено

  • Код выдаёт сервер при открытии экрана; 8 букв, разделители и регистр не важны.
  • Новичок, пришедший по ссылке, привязывается к пригласившему при входе сам.
  • Пока приглашения выключены, экран так и говорит и запросов не делает.

Шаг 01Добавьте систему в проект

Добавлять не нужно: экран приглашений есть в каждом новом проекте и всегда виден в лобби.

Шаг 02Настройте в кабинете

Откройте кабинет, выберите проект и перейдите в LiveOps → v2 → Рефералы.

  • Включите приглашения: по умолчанию они выключены.
  • Задайте подарок новичку и награды за 1, 3, 5 и больше друзей.

Кнопка ИИ на странице открывает помощника: опишите, что нужно, он предложит правки, а вы проверите их и нажмёте Сохранить.

Шаг 03Проверьте и выпустите

Проверьте систему в тестовой версии приложения. В живое приложение настройки уходят отдельным действием - см. публикация и ссылки.

Для разработчиков

Приглашения работают через client.referral из @idosgames/core.

TypeScript
// Код игрока и состояние приглашений, затем код друга от новичка
await client.referral.getUserState()
const res = await client.referral.activateReferralCode('KD7QPX2M') // подходит и вся ссылка
if (!res.ok) return showError(res.error)
await client.referral.claimInviteRewardsBatch(['friends_1', 'friends_3'])
  • activateReferralCode принимает голый код или всю ссылку, которую вставил игрок.
  • Все готовые награды забираются разом через claimInviteRewardsBatch.

Подробное описание полей - в навыке referral-system, его отдаёт MCP-сервер SDK.

Частые вопросы

Почему экран приглашений пишет, что они выключены?

По умолчанию приглашения выключены. Включите их в разделе Рефералы кабинета.

Новичок может ввести код позже?

Да, один раз: окно ввода кода выдаёт подарок новичку единожды.

Смотрите также

Сделайте свою игру

Опишите идею одним предложением - ИИ-кодер соберёт её, и она откроется по своей ссылке.

СоздатьПодключить ИИ-агента