Oyun fikirleri ve özellikleri

Sıradaki özelliğin

Hediye Kodları

Oyuncuların hediye kodlarını girip kullanmasını sağla.

Oyuncu oturumu gerekli
Godot
Hediye Kodları görseli
Görünür sonuç

Test kodu kullanılır. Tekrar kullanım, kurallarına göre değerlendirilir.

Bir hediye kodu oluşturun1:42

Bu eğitim İngilizce oynatılır.

Videoyu ayrı aç ↗
Video yakında

Bu adımın videosu henüz yok. Rehber ve MCP isteği kullanıma hazır.

Sunucudaki oyuncu değerleri

Aynı projeyi hazırlayın

  1. Panelde oyun yapılandırmandaki projeyle aynı projeyi seç.

    Hediye Kodları →
  2. Bu test kayıtlarını panel formunda oluşturun veya mevcut olanları kullanın. Bunlar örnek değerlerdir, güncel proje verileri değildir.

    Kod
    WELCOME
    Hediye Verisi (JSON)
    {}
    Kullanıcı Başına Maks.
    1

    Sunucu kullanım sırasında en fazla sekiz yapılandırılmış değeri verir. giftData ayrı oyun verisi olarak kalır. Dönen bakiyeyi gösterin; ödülü yerelde tekrar eklemeyin.

    Oyuncu değerleri →
  3. Örneği çalıştırmadan önce kaydedin, yeniden yükleyin ve doğrulayın. Diğer tanımları koruyun.

Bu özelliği ekle

Kılavuzu inceleyebilirsin. Çalıştırmak için etkin bir proje anahtarı gerekir. Projeyi hazırla

SDK kurulu, proje yapılandırması içe aktarılmış ve oyuncu oturum açmış olmalı.

Sunucu kullanım sırasında en fazla sekiz yapılandırılmış değeri verir. giftData ayrı oyun verisi olarak kalır. Dönen bakiyeyi gösterin; ödülü yerelde tekrar eklemeyin. Bu SDK örneği develop kullanır. Gerekli API'lerin kurulu SDK sürümünde bulunduğunu kontrol et.

GDScript dosyasını kaydedip ana sahnede bir düğüme ekleyin ve çalıştırın. Output bölümünü kontrol edin.

GDScript
res://scripts/gift_codes.gd
horizOn çağrısıHazırlık
1# Bu betiği ana sahnendeki bir düğüme ekle.
2extends Node
3​
4​
5func _ready() -> void:
6 # Hazırlık: başlat, bağlan ve bir oyuncunun oturumunu aç.
7 var connected = await Horizon.connect_to_server()
8 if not connected:
9 print("Failed to connect to horizOn server")
10 return
11 if not Horizon.auth.isSignedIn():
12 var signed_in: bool
13 if Horizon.auth.hasCachedAnonymousToken():
14 signed_in = await Horizon.auth.restoreAnonymousSession()
15 else:
16 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
17 if not signed_in:
18 return
19​
20 # horizOn: hediye kodunu doğrula ve kullan.
21 # Run from one explicit player action; serialize this handler until it completes.
22 var user_id: String = Horizon.auth.getCurrentUser().userId
23 var project: String = Horizon.getConfig().api_key
24 var scope: String = project + "|" + user_id
25 var path: String = "user://gift_pending_" + scope.sha256_text() + ".bin"
26 var pending: Dictionary
27 if FileAccess.file_exists(path):
28 var file := FileAccess.open(path, FileAccess.READ)
29 if file == null: return
30 var saved: Variant = file.get_var(false)
31 file.close()
32 if not HorizonGiftCodes.validIntent(saved, project, user_id): return
33 pending = saved # Invalid/V1 records stay untouched for reconciliation.
34 else:
35 pending = await Horizon.giftCodes.prepareRedemption("WELCOME")
36 if not HorizonGiftCodes.validIntent(pending, project, user_id) or FileAccess.file_exists(path): return
37 var file := FileAccess.open(path, FileAccess.WRITE)
38 if file == null: return
39 file.store_var(pending, false)
40 file.flush()
41 var saved_ok: bool = file.get_error() == OK
42 file.close()
43 if not saved_ok: return
44 var verify := FileAccess.open(path, FileAccess.READ)
45 if verify == null: return
46 var original: Variant = verify.get_var(false)
47 verify.close()
48 if original != pending: return
49 var result: Dictionary = await Horizon.giftCodes.redeemPrepared(pending)
50 if not result.get("success", false): return # Keep all seven original fields for retry.
51 verify = FileAccess.open(path, FileAccess.READ)
52 if verify == null: return
53 original = verify.get_var(false)
54 verify.close()
55 if original == pending: DirAccess.remove_absolute(ProjectSettings.globalize_path(path))
56 if result.get("playerValues") is Dictionary:
57 print(result.playerValues.values) # Current balances, never add grantedValues locally.
58 # Replay has alreadyApplied=true, giftData=null and empty grantedValues/grantedUnlocks.
Tam SDK örneğini aç ↗

Yeni özelliğini test et.

Test kodu kullanılır. Tekrar kullanım, kurallarına göre değerlendirilir.

Panelde oyun yapılandırmandaki projeyle aynı projeyi seç.

Uç noktalar
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
API referansındaki tüm uç noktalar
Skor Tabloları görseli
Sıradaki adım için önerimiz

Her tura bir yüksek puan ekle.

Turdan sonra puanı kaydet ve kimin önde olduğunu göster. Bağlantını ve oyuncu oturumunu kullanmaya devam et.