Spielideen & Features

Euer nächstes Feature

Gruppen

Gilden, Clans und Teams mit Rollen für das ausgewählte Projekt.

SDK: developSpielersession erforderlich
Godot
Illustration für Gruppen
Euer sichtbares Ergebnis

Nach Timeout oder Konflikt die ursprüngliche Aktion behalten und den aktuellen Stand lesen. Niemals automatisch mit neuer Revision wiederholen.

Video folgt

Für diesen Schritt fehlt noch das Video. Die Anleitung und der MCP-Auftrag sind bereits nutzbar.

Gruppen

Dasselbe Projekt vorbereiten

  1. Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.

    Gruppen →
  2. Für die erste Anfrage ist keine weitere Definition nötig. Ein leeres Ergebnis ist gültig, solange passende Spieldaten fehlen.

    Gruppen werden im Spiel erstellt und verwaltet.

    Dieses erste Beispiel liest Daten. Es erstellt keine Gruppe, keinen Match und kein Objekt. Eine leere Liste ist eine gültige erste Antwort.

Feature einbauen

Ihr könnt die Anleitung vorab ansehen. Zum Ausführen braucht ihr einen aktiven Projekt-Key. Projekt vorbereiten

SDK installiert, Projekt-Konfiguration importiert und Spieler angemeldet.

Dieses SDK-Beispiel nutzt develop. Prüft, ob die nötigen APIs in eurem installierten SDK verfügbar sind.

Verbindet zuerst den vorgesehenen Spieler über den Schnellstart. Ruft read_my_groups() ausdrücklich über einen Button oder eine Szenenaktion auf. Allein das Öffnen der Datei sendet keine Anfrage.

GDScript
res://scripts/groups.gd
horizOn-Aufruf
1extends Node
2​
3# Restore the existing matching player and connect in the Quickstart first.
4# Invoke explicitly from a player action, not from a poll or page loop.
5func read_my_groups() -> void:
6 var user = Horizon.auth.getCurrentUser()
7 if user == null:
8 return
9 var result = await Horizon.groups.getGroups(user.userId)
10 if not result.success:
11 push_warning(result.errorCode)
12 return
13 print("Player revision: ", result.data.revision)
14 for group in result.data.groups:
15 print(group.id, " ", group.myRole, " revision=", group.revision)
16 # result.data.limits contains all current limits; retained groups are not truncated.
17 # getMembers(userId, groupId, "", 1) reads one page. Keep its revision/cursor.
18 # Restart explicitly on a changed revision; optional createdAt is not epoch zero.
19# Full durable mutations: addons/horizon_sdk/examples/features/groups_example.gd.
20# Keep the original revision/requestId; unknown create requires explicit reconciliation.
Vollständiges SDK-Beispiel öffnen ↗

Testet euer neues Feature.

Nach Timeout oder Konflikt die ursprüngliche Aktion behalten und den aktuellen Stand lesen. Niemals automatisch mit neuer Revision wiederholen.

Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.

Endpunkte
  • GET/groups
  • GET/groups/{groupId}
  • GET/groups/{groupId}/members
  • GET/groups/{groupId}/pending
  • POST/groups
  • PUT/groups/{groupId}
  • POST/groups/{groupId}/join
  • POST/groups/{groupId}/request
  • POST/groups/{groupId}/invite
  • POST/groups/{groupId}/accept-invite
  • POST/groups/{groupId}/decline-invite
  • POST/groups/{groupId}/cancel-invite
  • POST/groups/{groupId}/accept-request
  • POST/groups/{groupId}/decline-request
  • POST/groups/{groupId}/cancel-request
  • POST/groups/{groupId}/leave
  • POST/groups/{groupId}/remove
  • POST/groups/{groupId}/role
  • POST/groups/{groupId}/transfer
  • POST/groups/{groupId}/delete
Alle Endpunkte in der API-Referenz
Illustration für Bestenlisten
Unser Vorschlag für den nächsten Schritt

Gebt jeder Runde einen Highscore.

Speichert den Score nach dem Spiel und zeigt, wer vorne liegt. Eure Verbindung und Spielersession nutzt ihr weiter.