Spielideen & Features

Euer nächstes Feature

Matches

Rundenbasierte Spiele mit expliziten Revisionen, undurchsichtigem Zustand und getrennten Ergebnisberichten.

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

Koordiniert mit zwei Spielersitzungen eine Lobby, abwechselnde Züge und unabhängige Abschlussberichte.

Video folgt

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

Rundenbasierte Matches

Dasselbe Projekt vorbereiten

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

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

    Verwendet zwei getrennte Spielersitzungen: Lobby erstellen, beitreten, mit expliziter Reihenfolge starten, abwechselnde Byte-Zustände senden und das gleiche Endergebnis unabhängig melden.

    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_matches() ausdrücklich über einen Button oder eine Szenenaktion auf. Allein das Öffnen der Datei sendet keine Anfrage.

GDScript
res://scripts/matches.gd
horizOn-Aufruf
1extends Node
2​
3# Explicit action after restoring the SAME existing player identity.
4func read_my_matches() -> void:
5 var user = Horizon.auth.getCurrentUser()
6 if user == null:
7 return
8 var result = await Horizon.matches.getMatches(user.userId)
9 if not result.success:
10 push_warning(result.errorCode)
11 return
12 print("Ledger revision: ", result.data.revision)
13 for row in result.data.recent:
14 print(row.id, " ", row.status) # May still be active after this player's forfeit.
15 # Respect result.data.pollAfterSeconds. No background poll.
16# Full two-player, durable-original example in the verified SDK:
17# addons/horizon_sdk/examples/features/matches_example.gd
18# read_matches()/create_reviewed(options), read_match(id), perform_reviewed(kind, body).
19# Each is an explicit player action. Original project+player intent survives host changes.
20# SDK methods: joinMatch(userId,id,originalRevision), startMatch(userId,id,originalRevision,order),
21# submitTurn(userId,id,originalRevision,PackedByteArray,finish),
22# reportResult(userId,id,originalFinalRevision,PackedByteArray,sortedWinnerIds).
23# Unknown create: recovery reads and explicit reconciliation, never a replacement create.
24# Report agreement is ordinary consensus, not validated combat or an automatic reward.
Vollständiges SDK-Beispiel öffnen ↗

Zwei Spieler, ein ursprünglicher Zug

Verwendet zwei getrennte Spielersitzungen: Lobby erstellen, beitreten, mit expliziter Reihenfolge starten, abwechselnde Byte-Zustände senden und das gleiche Endergebnis unabhängig melden.

Speichert die genaue Anfrage vor dem Senden. Lest nach einer Zeitüberschreitung den aktuellen Zustand und gleicht ihn ab. Ersetzt niemals still die Revision oder die Originalabsicht.

Berichte verwenden die unveränderliche Revision des Endzustands. Übereinstimmung ist kein vertrauenswürdiger Siegbeleg; Widersprüche oder fehlende Berichte bestimmen keinen Gewinner.

Ranglistenläufe benötigen ein bestätigtes Ranglistenmatch und die bestehende Validated-Actions-Pipeline. Gewöhnliche Matchberichte vergeben keine Belohnungen.

PHP unterstützt gewöhnliche Match-REST-Routen. Ranglistenprüfung und Echtzeit sind nicht verfügbar und liefern gegebenenfalls FEATURE_NOT_SUPPORTED.

Testet euer neues Feature.

Koordiniert mit zwei Spielersitzungen eine Lobby, abwechselnde Züge und unabhängige Abschlussberichte.

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

Endpunkte
  • GET/matches
  • GET/matches/limits
  • GET/matches/open
  • GET/matches/{matchId}
  • POST/matches
  • POST/matches/{matchId}/join
  • POST/matches/{matchId}/decline
  • POST/matches/{matchId}/start
  • POST/matches/{matchId}/turn
  • POST/matches/{matchId}/timeout
  • POST/matches/{matchId}/leave
  • POST/matches/{matchId}/cancel
  • POST/matches/{matchId}/result
  • POST/matches/{matchId}/ranked-run
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.