Spelideeën en functies

Je volgende functie

Wedstrijden

Beurtspellen met expliciete revisies, ondoorzichtige status en afzonderlijke resultaatrapporten.

SDK: developSpelerssessie vereist
Godot
Illustratie van Wedstrijden
Je zichtbare resultaat

Coördineer met twee spelerssessies een lobby, afwisselende beurten en onafhankelijke eindrapporten.

Video volgt

Voor deze stap is nog geen video. De handleiding en MCP-opdracht zijn al bruikbaar.

Beurtgebaseerde wedstrijden

Hetzelfde project voorbereiden

  1. Kies in het dashboard hetzelfde project als in de configuratie van je spel.

    Wedstrijden →
  2. Voor het eerste verzoek is geen extra definitie nodig. Een leeg resultaat is geldig zolang bijpassende spelgegevens ontbreken.

    Gebruik twee aparte spelerssessies: maak een lobby, neem deel, start in expliciete volgorde, wissel bytebeurten af en rapporteer onafhankelijk hetzelfde eindresultaat.

    Dit eerste voorbeeld leest gegevens. Het maakt geen groep, wedstrijd of object. Een lege lijst is een geldig eerste antwoord.

Bouw deze functie

Je kunt de handleiding bekijken. Voor uitvoering heb je een actieve projectsleutel nodig. Project voorbereiden

SDK geïnstalleerd, projectconfiguratie geïmporteerd en speler aangemeld.

Dit SDK-voorbeeld gebruikt develop. Controleer of de benodigde API's in je geïnstalleerde SDK bestaan.

Voltooi de Quickstart-verbinding met de bedoelde speler. Roep read_my_matches() expliciet aan via een knop of scèneactie. Alleen het bestand openen verstuurt geen verzoek.

GDScript
res://scripts/matches.gd
horizOn-aanroep
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.
Volledig SDK-voorbeeld openen ↗

Twee spelers, één oorspronkelijke beurt

Gebruik twee aparte spelerssessies: maak een lobby, neem deel, start in expliciete volgorde, wissel bytebeurten af en rapporteer onafhankelijk hetzelfde eindresultaat.

Sla het exacte verzoek vóór verzending op. Lees na een time-out de status en stem af. Vervang revisie of oorspronkelijke intentie nooit stilzwijgend.

Rapporten gebruiken de onveranderlijke eindrevisie. Overeenstemming bewijst geen betrouwbare overwinning; afwijkende of ontbrekende rapporten bepalen geen winnaar.

Ranglijstruns vereisen een bevestigde ranglijstwedstrijd en de bestaande Validated Actions-pijplijn. Gewone rapporten geven geen beloningen.

PHP ondersteunt gewone wedstrijd-REST-routes. Ranglijstvalidatie en realtime zijn niet beschikbaar en geven waar nodig FEATURE_NOT_SUPPORTED.

Test je nieuwe functie.

Coördineer met twee spelerssessies een lobby, afwisselende beurten en onafhankelijke eindrapporten.

Kies in het dashboard hetzelfde project als in de configuratie van je spel.

Eindpunten
  • 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 eindpunten in de API-referentie
Illustratie van Leaderboards
Onze suggestie voor je volgende stap

Geef elke ronde een topscore.

Sla de score na een ronde op en laat zien wie vooropstaat. Blijf je verbinding en de sessie van de speler gebruiken.