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

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

قيم اللاعب

عملات وعدّادات وطاقة يديرها الخادم. حدّد الأرصدة والعروض والتغييرات المتحقّق منها لكل مشروع.

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

تعرض اللعبة الأرصدة والعروض المضبوطة. تعيد عمليات الشراء حالة اللاعب الحالية.

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

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

قيم اللاعب

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

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

    قيم اللاعب →
  2. أنشئوا إدخالات الاختبار هذه أو أعيدوا استخدام الموجود منها في نموذج لوحة التحكم. القيم أمثلة وليست بيانات المشروع الحالية.

    القيم
    coins: initialBalance=100, maxBalance=1000000; energy: initialBalance=10, maxBalance=100
    السماح بالتغييرات المباشرة
    false
    العروض
    energy-pack: costs=[{"key":"coins","amount":20}], rewards=[{"key":"energy","amount":5}]

    يُمنح الرصيد الابتدائي مرة واحدة لكل مفتاح قيمة. التغييرات المباشرة معطّلة افتراضيًا. تحتفظ Validated Actions بحدودها لكل جولة؛ وتأتي الحدود اليومية وحدود الرصيد من هذه التعريفات. ترك الحد الاختياري فارغًا يعني عدم وجود حد.

  3. احفظوا الإدخالات وأعيدوا تحميلها وتحققوا منها قبل المثال. احتفظوا بالتعريفات الأخرى.

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

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

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

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

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

GDScript
res://scripts/player_values.gd
استدعاء horizOn
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5func run_reviewed_action() -> void:
6 if not Horizon.auth.isSignedIn():
7 return
8 var user_id: String = Horizon.auth.getCurrentUser().userId
9 var current: Dictionary = await Horizon.playerValues.getState(user_id)
10 if not current.success:
11 push_error(current.errorCode)
12 return
13 print(current.state.values)
14 # Authoritative balances only; never add a copied historical reward locally.
15 # Purchases and exact original retry use the official player_values_example.gd
16 # and pending_purchase.gd. Persist the original user/offer/operationId before send.
17 # Keep an uncertain or expired original; do not silently create another ID.
فتح مثال SDK الكامل ↗

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

تعرض اللعبة الأرصدة والعروض المضبوطة. تعيد عمليات الشراء حالة اللاعب الحالية.

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

نقاط النهاية
  • GET/player-values
  • GET/player-values/offers
  • POST/player-values/purchase
  • POST/player-values/adjust
كل نقاط النهاية في مرجع API
رسم توضيحي لميزة لوحات المتصدرين
اقتراحنا لخطوتك التالية

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

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