Ide dan fitur game

Fitur berikutnya

Pertandingan

Permainan bergiliran dengan revisi eksplisit, status buram dan laporan hasil terpisah.

SDK: developMemerlukan sesi pemain
Godot
Ilustrasi Pertandingan
Hasil yang terlihat

Koordinasikan lobi, giliran bergantian, dan laporan akhir independen dengan dua sesi pemain.

Video akan tersedia

Langkah ini belum memiliki video. Panduan dan permintaan MCP sudah dapat digunakan.

Pertandingan berbasis giliran

Siapkan proyek yang sama

  1. Pilih proyek yang sama di dasbor dan konfigurasi game.

    Pertandingan →
  2. Permintaan pertama tidak memerlukan definisi tambahan. Hasil kosong tetap sah sebelum ada data permainan yang sesuai.

    Gunakan dua sesi terpisah: buat lobi, bergabung, mulai dengan urutan eksplisit, kirim status byte bergantian lalu laporkan hasil akhir yang sama secara mandiri.

    Contoh pertama membaca data. Tidak membuat grup, pertandingan, atau objek. Daftar kosong adalah respons pertama yang sah.

Tambahkan fitur ini

Kamu dapat membaca panduan. Untuk menjalankannya, diperlukan kunci proyek aktif. Siapkan proyek

SDK terpasang, konfigurasi proyek diimpor, dan pemain sudah masuk.

Contoh SDK ini menggunakan develop. Periksa apakah API yang diperlukan tersedia di SDK yang terpasang.

Selesaikan koneksi mulai cepat dengan pemain yang dipilih. Panggil read_my_matches() dari tombol atau tindakan adegan yang eksplisit. Membuka berkas saja tidak mengirim permintaan.

GDScript
res://scripts/matches.gd
Panggilan horizOn
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.
Buka contoh SDK lengkap ↗

Dua pemain, satu giliran asli

Gunakan dua sesi terpisah: buat lobi, bergabung, mulai dengan urutan eksplisit, kirim status byte bergantian lalu laporkan hasil akhir yang sama secara mandiri.

Simpan permintaan persis sebelum dikirim. Setelah batas waktu, baca status dan rekonsiliasi. Jangan diam-diam mengganti revisi atau maksud asli.

Laporan memakai revisi akhir yang tetap. Kesepakatan bukan bukti kemenangan tepercaya; laporan berbeda atau hilang tidak menyimpulkan pemenang.

Proses berperingkat memerlukan pertandingan berperingkat yang dikonfirmasi dan alur Validated Actions yang ada. Laporan biasa tidak memberi hadiah.

PHP mendukung rute REST biasa. Validasi peringkat dan waktu nyata tidak tersedia dan mengembalikan FEATURE_NOT_SUPPORTED bila diperlukan.

Uji fitur barumu.

Koordinasikan lobi, giliran bergantian, dan laporan akhir independen dengan dua sesi pemain.

Pilih proyek yang sama di dasbor dan konfigurasi game.

Titik akhir
  • 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
Semua titik akhir di referensi API
Ilustrasi Papan Peringkat
Saran kami untuk langkah berikutnya

Berikan skor tertinggi untuk setiap ronde.

Simpan skor setelah ronde dan tampilkan siapa yang unggul. Tetap gunakan koneksi dan sesi pemainmu.