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

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

العناصر

معدات فريدة بخصائص وقواعد كتالوج ومخزون لاعبين للمشروع المحدد.

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

بعد الحفظ يحتوي الكتالوج على starter_sword. وبعد الشراء التجريبي المراجع يحتوي المخزون الحالي على instanceId الفريد.

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

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

العناصر

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

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

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

    المفتاح
    starter_sword
    الاسم
    Quickstart Sword
    النوع
    equipment
    الندرة
    common
    نشط
    true
    الخصائص الأساسية
    {"damage":5}
    قواعد الخصائص
    []

    لكل عنصر هوية وخصائص مستقلة. تبقى الموارد القابلة للعد في قيم اللاعب، والزينة المرئية فقط في ملف اللاعب.

    جهّزوا coins وفق دليل قيم اللاعبين. احفظوا عرض starter-sword نشطاً: التكلفة 10 coins ومكافأة عنصر واحد starter_sword.

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

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

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

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

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

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

GDScript
res://scripts/items.gd
استدعاء horizOn
1extends Node
2​
3# Connect and restore the existing player first. Each function is an explicit action.
4func read_inventory() -> void:
5 var user = Horizon.auth.getCurrentUser()
6 if user == null:
7 return
8 var result = await Horizon.items.getInventory(user.userId)
9 if not result.success:
10 push_warning(result.errorCode)
11 return
12 for item in result.data.instances:
13 print(item.instanceId, ": ", item.itemKey)
14 # Keep result.data.revision for a separately reviewed mutation.
15​
16func read_catalog_page() -> void:
17 var user = Horizon.auth.getCurrentUser()
18 if user == null:
19 return
20 var result = await Horizon.items.getCatalog(user.userId, "", 1)
21 if not result.success:
22 push_warning(result.errorCode)
23 return
24 print("Catalog revision: ", result.data.revision)
25 # Explicit Next retains revision and nextAfterKey; no automatic page loop.
26# Durable mutations: addons/horizon_sdk/examples/features/items_example.gd.
27# Preserve original instance/body/revision and the original PV purchase operationId.
28# Initial success may include item references; retained replay may return empty applied/items.
29# Read the current inventory separately; never reconstruct earlier item references.
30# A failed refresh never authorizes another purchase or a local item grant.
فتح مثال SDK الكامل ↗

استخدام العنصر المحفوظ

استوردوا المثال الرسمي وملفاته المساعدة. راجعوا العرض ثم نفذوا التسلسل أدناه باللاعب الحالي. انتظروا كل خطوة وأكدوا الشراء مرة واحدة. احتفظوا بالطلب الأصلي عند غموض الاستجابة.

items_example.gd: load_catalog_page() → review_offer("starter-sword") → purchase_reviewed_offer() → refresh_inventory()

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

بعد الحفظ يحتوي الكتالوج على starter_sword. وبعد الشراء التجريبي المراجع يحتوي المخزون الحالي على instanceId الفريد.

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

نقاط النهاية
  • GET/items
  • GET/items/catalog
  • POST/items/adjust
  • POST/items/equip
  • POST/items/discard
كل نقاط النهاية في مرجع API
رسم توضيحي لميزة لوحات المتصدرين
اقتراحنا لخطوتك التالية

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

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