أفكار وميزات للعبة

ميزتك التالية

المباريات

ألعاب بالأدوار مع مراجعات صريحة وحالة غير مفسرة وتقارير نتائج منفصلة.

SDK: فرع developتتطلب جلسة لاعب
Godot
رسم توضيحي لميزة المباريات
النتيجة المرئية

نسّق الردهة والأدوار المتناوبة والتقارير النهائية المستقلة باستخدام جلستين للاعبين.

الفيديو قادم لاحقًا

لا يوجد فيديو لهذه الخطوة بعد. الدليل وطلب MCP متاحان للاستخدام.

مباريات قائمة على الأدوار

جهّزوا المشروع نفسه

  1. اختر في لوحة التحكم المشروع نفسه الموجود في إعداد لعبتك.

    المباريات →
  2. لا يحتاج الطلب الأول إلى تعريف إضافي. النتيجة الفارغة صالحة ما دامت بيانات اللعبة المطابقة غير موجودة.

    استخدم جلستين منفصلتين: أنشئ ردهة، انضم، ابدأ بترتيب صريح، أرسل حالات البايتات بالتناوب ثم أبلغ عن النتيجة النهائية نفسها بصورة مستقلة.

    يقرأ المثال الأول البيانات. لا ينشئ مجموعة أو مباراة أو كائناً. القائمة الفارغة استجابة أولى صالحة.

أضف هذه الميزة

يمكنك الاطلاع على الدليل. يتطلب التنفيذ مفتاح مشروع نشطًا. تجهيز المشروع

SDK مُثبّت وإعداد المشروع مُستورد واللاعب مسجّل الدخول.

يستخدم مثال SDK هذا فرع develop. تحقّق من وجود واجهات API المطلوبة في SDK المثبّت.

أكملوا اتصال البدء السريع باللاعب المقصود. استدعوا read_my_matches() بزر أو إجراء مشهد صريح. فتح الملف وحده لا يرسل طلباً.

GDScript
res://scripts/matches.gd
استدعاء 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.
فتح مثال SDK الكامل ↗

لاعبان ودور أصلي واحد

استخدم جلستين منفصلتين: أنشئ ردهة، انضم، ابدأ بترتيب صريح، أرسل حالات البايتات بالتناوب ثم أبلغ عن النتيجة النهائية نفسها بصورة مستقلة.

احفظ الطلب الدقيق قبل الإرسال. بعد انتهاء المهلة اقرأ الحالة وطابقها. لا تستبدل المراجعة أو النية الأصلية بصمت.

تستخدم التقارير مراجعة نهائية ثابتة. الاتفاق ليس إثباتًا موثوقًا للفوز، والتقارير المتعارضة أو الناقصة لا تحدد فائزًا.

يتطلب التشغيل المصنف مباراة مصنفة مؤكدة ومسار Validated Actions الحالي. لا تمنح التقارير العادية مكافآت.

يدعم PHP مسارات REST العادية. التحقق المصنف والوقت الفعلي غير متاحين ويعيدان FEATURE_NOT_SUPPORTED عند الحاجة.

اختبر ميزتك الجديدة.

نسّق الردهة والأدوار المتناوبة والتقارير النهائية المستقلة باستخدام جلستين للاعبين.

اختر في لوحة التحكم المشروع نفسه الموجود في إعداد لعبتك.

نقاط النهاية
  • 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
كل نقاط النهاية في مرجع API
رسم توضيحي لميزة لوحات المتصدرين
اقتراحنا لخطوتك التالية

أضف رقمًا قياسيًا لكل جولة.

احفظ النتيجة بعد الجولة وأظهر المتصدر. واصل استخدام اتصالك وجلسة اللاعب.