Ide dan fitur game

Fitur berikutnya

Item

Perlengkapan unik dengan properti, aturan katalog, dan inventaris pemain untuk proyek terpilih.

SDK: developMemerlukan sesi pemain
Godot
Ilustrasi Item
Hasil yang terlihat

Setelah disimpan, katalog memuat starter_sword. Setelah pembelian contoh yang ditinjau, inventaris saat ini memuat instanceId uniknya.

Video akan tersedia

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

Item

Siapkan proyek yang sama

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

    Item →
  2. Buat atau gunakan kembali entri uji ini pada formulir dasbor. Nilai ini adalah contoh, bukan data proyek saat ini.

    Kunci
    starter_sword
    Nama
    Quickstart Sword
    Jenis
    equipment
    Kelangkaan
    common
    Aktif
    true
    Properti dasar
    {"damage":5}
    Aturan properti
    []

    Item memiliki identitas dan properti sendiri. Sumber daya yang dihitung tetap berada di Nilai Pemain; kosmetik visual tetap di Profil Pemain.

    Siapkan coins melalui panduan nilai pemain. Simpan penawaran aktif starter-sword: biaya 10 coins, hadiah item 1 starter_sword.

    Nilai pemain →
  3. Simpan, muat ulang, dan periksa entri sebelum menjalankan contoh. Pertahankan definisi lain.

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_catalog_page(), read_inventory() dari tombol atau tindakan adegan yang eksplisit. Membuka berkas saja tidak mengirim permintaan.

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

Gunakan item tersimpan

Impor contoh resmi beserta berkas bantunya. Tinjau penawaran lalu jalankan urutan berikut dengan pemain saat ini. Tunggu setiap langkah dan konfirmasikan pembelian sekali. Pertahankan permintaan asli jika respons tidak pasti.

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

Uji fitur barumu.

Setelah disimpan, katalog memuat starter_sword. Setelah pembelian contoh yang ditinjau, inventaris saat ini memuat instanceId uniknya.

Pilih proyek yang sama di dasbor dan konfigurasi game.

Titik akhir
  • GET/items
  • GET/items/catalog
  • POST/items/adjust
  • POST/items/equip
  • POST/items/discard
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.