Spielsysteme

Freunde einladen: Codes, Links und Belohnungen

Wie das fertige Einladungssystem von iDos Games funktioniert: ein persönlicher Einladungscode und Link, ein Geschenk für Neulinge und eine Belohnungsleiter für gekommene Freunde, und wie du es im Dashboard einschaltest.

Einladungen bringen neue Spieler: Jeder Spieler hat einen kurzen Code und einen Link zum Teilen, der Neuling bekommt ein Geschenk, und der Einladende steigt für gekommene Freunde eine Belohnungsleiter hinauf. Das System gehört zu jedem neuen Projekt, aber Einladungen sind aus, bis du sie einschaltest.

Was der Spieler sieht

  • Den eigenen kurzen Code des Spielers mit „Kopieren“ und „Link teilen“ (das Teilen-Menü des Systems oder die Zwischenablage).
  • Wie viele Freunde über den Code gekommen sind, und die Belohnungsleiter dafür, eine oder alle abholen.
  • Die Eingabe des Codes eines Freundes: zeigt das Geschenk des Neulings und zahlt es einmal aus.
  • „Du bist über den Code eines Freundes gekommen“ für einen Spieler, der bei der Anmeldung über einen Einladungslink verknüpft wurde.
Freunde einladen
12 450
320
Dein Code: KD7Q-PX2M
Kopieren
Link teilen
1 Freund · 200 Edelsteine
Abgeholt
3 Freunde · Truhe
Abholen
5 Freunde · Held3 von 5 sind gekommen
Code eines Freundes eingeben
Der eigene Code und Einladungslink des Spielers.
Die Belohnungsleiter für gekommene Freunde; eine oder alle abholen.
Ein Neuling gibt den Code eines Freundes ein und bekommt einmal ein Geschenk.
Beispiel. Der Einladungs-Bildschirm: eigener Code, die Belohnungsleiter und Code-Eingabe.

So funktioniert es

  • Der Server erzeugt den Code, wenn sich der Bildschirm öffnet; 8 Buchstaben, Trennzeichen und Groß- und Kleinschreibung werden ignoriert.
  • Ein Neuling, der über einen Einladungslink kam, wird bei der Anmeldung von selbst mit dem Einladenden verknüpft.
  • Solange Einladungen aus sind, sagt der Bildschirm das und sendet keine Anfrage.

Schritt 01Das System zum Projekt hinzufügen

Es gibt nichts hinzuzufügen: Der Einladungsbildschirm gehört zu jedem neuen Projekt und ist in der Lobby immer sichtbar.

Schritt 02Im Dashboard einrichten

Öffne das Dashboard, wähle dein Projekt und geh zu Live-Betrieb → v2 → Empfehlung.

  • Schalte Einladungen ein: Sie sind standardmäßig aus.
  • Lege das Geschenk des Neulings und die Belohnungen für 1, 3, 5 oder mehr Freunde fest.

Der Knopf KI auf der Seite öffnet einen Assistenten: Beschreibe, was du brauchst, er schlägt Änderungen vor, du prüfst sie und drückst Speichern.

Schritt 03Testen und veröffentlichen

Prüfe das System in der Testversion deiner App. Einstellungen gehen mit einer eigenen Aktion an die Live-App, siehe Veröffentlichen und Links.

Für Entwickler

Einladungen arbeiten über client.referral in @idosgames/core.

TypeScript
// Code und Einladungsstand des Spielers, dann der Code eines Freundes von einem Neuling
await client.referral.getUserState()
const res = await client.referral.activateReferralCode('KD7QPX2M') // ein ganzer Link funktioniert auch
if (!res.ok) return showError(res.error)
await client.referral.claimInviteRewardsBatch(['friends_1', 'friends_3'])
  • activateReferralCode nimmt einen reinen Code oder den ganzen Link, den ein Spieler eingefügt hat.
  • Hol alle fertigen Belohnungen auf einmal mit claimInviteRewardsBatch ab.

Jedes Feld ist im Skill referral-system beschrieben, den der MCP-Server des SDK bereitstellt.

Häufige Fragen

Warum sagt der Einladungsbildschirm, dass Einladungen aus sind?

Einladungen sind standardmäßig aus. Schalte sie im Bereich Empfehlung des Dashboards ein.

Kann ein Neuling den Code später eingeben?

Ja, einmal: Das Code-Fenster zahlt das Geschenk des Neulings ein einziges Mal aus.

Siehe auch

Erstelle dein eigenes Spiel

Beschreibe die Idee in einem Satz: Der KI-Coder baut das Spiel, und es geht unter eigenem Link online.