Felerous Arcade SDK v4.3.8 Rehberi

<!-- 1. HTML5 Arcade Köprüsünü Dahil Edin (Ultra Hafif ~13KB, Sıfır Bağımlılık) -->
<script src="https://store.felerous.com/js/felerous-bridge_html5.js"></script>
<!-- İsteğe Bağlı: Oyununuzda Küp Avatar / Canlı Drivatar kullanacaksanız ekleyin -->
<script src="https://store.felerous.com/js/felerous-cuberig-sdk.js"></script>

<script>
  // 2. Konsoldan aldığınız kimliklerle el sıkışmayı başlatın:
  felerousBridge.init({
    gameSlug: 'dusen-sicimler',                        // Oyununuzun benzersiz slug kodu
    appId: 1000002,                                    // Geliştirici Konsolundaki App ID
    bridgeToken: 'fel_sec_ORNEK_UYGULAMA_ANAHTARI',    // Konsoldan alınan oyun kanal anahtarınız
    mountBadge: true,                                  // Köşeye canlı [🏆 Liderlik | 👤 Oyuncu] rozeti ekler
    onReady: (player) => {
      console.log('✓ Oyuncu oturumu doğrulandı:', player.name, player.felerousId);
    },
    onAchievementConfirmed: (achId) => {
      console.log('🏆 Başarım Supabase bulutuna mühürlendi:', achId);
    }
  });

  // 3. Başarım açma:
  felerousBridge.unlockAchievement('first_clear');

  // 4. Skor bildirimi (Tek sayı veya detaylı obje kabul eder):
  felerousBridge.submitScore({
    score: 18450,
    difficultyTier: 'lvl2',
    difficultyLabel: 'Klasik',
    durationSeconds: 120,
    achievements: ['first_clear'],
    stats: { lines_cleared: 15, apm: 90 }
  });
</script>

<!-- 1. Phaser 3 & Phaser Köprüsünü Dahil Edin -->
<script src="https://cdn.jsdelivr.net/npm/phaser@3.80.1/dist/phaser.min.js"></script>
<script src="https://store.felerous.com/js/felerous-bridge_phaser.js"></script>
<!-- İsteğe Bağlı Küp Avatar SDK -->
<script src="https://store.felerous.com/js/felerous-cuberig-sdk.js"></script>

<script>
class ArcadeScene extends Phaser.Scene {
    constructor() { super('ArcadeScene'); }

    create() {
        // Sahneyi ve Oyunu Köprüye Bağla (Otomatik pause/resume, mute ve delta süre sayacı aktif olur)
        felerousBridge.attachScene(this);

        felerousBridge.init({
            gameSlug: 'dusen-sicimler',
            appId: 1000002,
            bridgeToken: 'fel_sec_ORNEK_UYGULAMA_ANAHTARI',
            onReady: async (player) => {
                console.log('✓ Phaser Sahnesinde Oyuncu Eşleşti:', player.name);

                // Küp Avatar yüklüyse oyuncunun renk paletini WebGL sprite'a giydir
                if (window.FelerousCubeRig) {
                    const avatar = await FelerousCubeRig.getAvatar(player.felerousId);
                    if (avatar && avatar.palette && this.playerSprite) {
                        felerousBridge.applyTint(this.playerSprite, avatar.palette.primary);
                    }
                }
            }
        });
    }

    gameOver(finalScore) {
        // Otomatik hesaplanan net süre ve engine_type: 'Phaser3_WebGL' telemetrisiyle skoru gönder
        felerousBridge.submitScore({
            score: finalScore,
            difficultyTier: 'lvl2',
            difficultyLabel: 'Klasik'
        });
        felerousBridge.showLeaderboard();
    }
}

const config = { type: Phaser.AUTO, width: 1600, height: 900, scene: ArcadeScene };
const game = new Phaser.Game(config);
</script>

[oyun-slug-kodu]/                      (Örn: dusen-sicimler/)
├── index.html                         # Oyunun giriş noktası (HTML5 Canvas)
├── manifest.json                      # [ÖNERİLEN] FDB dosya ağacı & paket kimliği
├── achievements.json                  # [ÖNERİLEN] Oyunun tüm başarımları (v1.0.1)
├── changelog.json                     # [OPSİYONEL] Sürüm geçmişi (FDB Depo sekmesinde gösterilir)
├── icon.png                           # 512x512 kare vitrin ikonu (1:1)
├── cover.png                          # Yatay vitrin kapağı (16:9 - 1600x900 veya 1920x1080)
├── banner.png                         # Geniş sinematik afiş görseli (16:9 - 1920x1080 Full HD)
├── shortcut.png                       # [4. GÖRSEL STANDARDI] 512x512 mobil ana ekran (PWA) & masaüstü kısayol simgesi (yoksa icon.png kullanılır)
├── css/
│   └── style.css                      # Oyun stilleri (100dvh ve koyu mod korumalı)
└── js/
    ├── felerous-bridge.js             # Felerous Store resmi köprü SDK'sı
    ├── sound.js                       # 8-bit prosedürel Web Audio motoru
    └── game.js                        # Oyun mantığı ve döngüsü

{
  "id": "dusen-sicimler",
  "slug": "dusen-sicimler",
  "name": "Düşen Sicimler",
  "version": "1.0.5",
  "developer": "Subushaki",
  "publisher": "FELEROUS",
  "category": "Retro / Piksel",
  "game_type": "web",
  "entry": "index.html",
  "icon": "icon.png",
  "cover": "cover.png",
  "banner": "banner.png",
  "shortcut": "shortcut.png",
  "orientation": "portrait_or_landscape",
  "resolution": {
    "width": 1080,
    "height": 1920,
    "responsive": true
  },
  "features": {
    "achievements": true,
    "leaderboards": true,
    "anti_cheat": true,
    "telemetry": true
  },
  "files": [
    { "name": "index.html", "type": "Oyun Giriş Dosyası" },
    { "name": "banner.png", "type": "Afiş Görseli" },
    { "name": "cover.png", "type": "Kapak Görseli" },
    { "name": "icon.png", "type": "Oyun İkonu" },
    { "name": "manifest.json", "type": "Oyun Yapılandırması" },
    { "name": "achievements.json", "type": "Başarım Veritabanı" },
    { "name": "changelog.json", "type": "Sürüm Notları" },
    { "name": "js/game.js", "type": "Oyun Motoru & Mantığı" },
    { "name": "js/felerous-bridge_html5.js", "type": "Platform SDK Köprüsü" },
    { "name": "js/sound.js", "type": "8-bit Ses Motoru" },
    { "name": "css/style.css", "type": "Stil Dosyası" }
  ]
}

{
  "game_id": "dusen-sicimler",
  "version": "1.0.5",
  "total": 18,
  "achievements": [
    {
      "id": "first_clear",
      "title": "İlk Adım",
      "description": "İlk satırını başarıyla temizle.",
      "icon": "🧱",
      "category": "progression",
      "rarity": "common",
      "points": 10
    },
    {
      "id": "tetris_master",
      "title": "Düşen Sicim",
      "description": "Tek hamlede 4 satır birden sil.",
      "icon": "⚡",
      "category": "skill",
      "rarity": "rare",
      "points": 25
    },
    {
      "id": "combo_king",
      "title": "Kombo Ustası",
      "description": "En az 4x ardışık satır kombosu yap.",
      "icon": "🌪️",
      "category": "skill",
      "rarity": "epic",
      "points": 50
    },
    {
      "id": "hard_dropper",
      "title": "Işık Hızı",
      "description": "Tek oyunda 25 kez sert düşüş (smash) yap.",
      "icon": "💥",
      "category": "speed",
      "rarity": "uncommon",
      "points": 15
    },
    {
      "id": "survivor",
      "title": "Kabus Gazisi",
      "description": "Kabus modunda en az 60 saniye hayatta kal.",
      "icon": "🛡️",
      "category": "survival",
      "rarity": "legendary",
      "points": 100
    },
    {
      "id": "architect",
      "title": "Büyük Mimar",
      "description": "Tek bir oyunda 50+ satır sil.",
      "icon": "👑",
      "category": "endurance",
      "rarity": "epic",
      "points": 50
    },
    {
      "id": "high_scorer",
      "title": "Puan Avcısı",
      "description": "Tek bir oyunda 20.000 puanı aş.",
      "icon": "🎯",
      "category": "score",
      "rarity": "rare",
      "points": 30
    },
    {
      "id": "tactician",
      "title": "Usta Taktisyen",
      "description": "Hold (saklama) özelliğini en az 10 kez kullan.",
      "icon": "🔄",
      "category": "strategy",
      "rarity": "uncommon",
      "points": 15
    },
    {
      "id": "double_trouble",
      "title": "Çifte Vuruş",
      "description": "Toplam 50 İkili Satır (2 satır birden) temizle.",
      "icon": "2️⃣",
      "category": "skill",
      "rarity": "uncommon",
      "points": 20
    },
    {
      "id": "triple_threat",
      "title": "Üçlü Tehdit",
      "description": "Toplam 25 Üçlü Satır (3 satır birden) temizle.",
      "icon": "3️⃣",
      "category": "skill",
      "rarity": "rare",
      "points": 35
    },
    {
      "id": "back_to_back",
      "title": "Ardarda Tetris",
      "description": "Arka arkaya 2 Tetris (4 satır) yap.",
      "icon": "🔥",
      "category": "skill",
      "rarity": "epic",
      "points": 60
    },
    {
      "id": "perfect_clear",
      "title": "Mükemmel Temizlik",
      "description": "Tahtayı tamamen boşalt (Perfect Clear).",
      "icon": "✨",
      "category": "skill",
      "rarity": "legendary",
      "points": 120
    },
    {
      "id": "speed_demon",
      "title": "Hız Canavarı",
      "description": "1 dakika içinde 40 satır temizle.",
      "icon": "⏱️",
      "category": "speed",
      "rarity": "rare",
      "points": 40
    },
    {
      "id": "marathon_runner",
      "title": "Maratoncu",
      "description": "Toplam 1000 satır temizle.",
      "icon": "🏃",
      "category": "endurance",
      "rarity": "epic",
      "points": 75
    },
    {
      "id": "piece_master",
      "title": "Parça Ustası",
      "description": "Toplam 1000 parça indir.",
      "icon": "🎮",
      "category": "progression",
      "rarity": "rare",
      "points": 30
    },
    {
      "id": "apm_champion",
      "title": "Hızlı Parmaklar",
      "description": "Bir oyunda 300 APM (Aksiyon/Dk) üzerine çık.",
      "icon": "⚡",
      "category": "speed",
      "rarity": "epic",
      "points": 55
    },
    {
      "id": "nightmare_warrior",
      "title": "Kabus Savaşçısı",
      "description": "Kabus modunda 120 saniye hayatta kal.",
      "icon": "👹",
      "category": "survival",
      "rarity": "legendary",
      "points": 170
    },
    {
      "id": "millionaire",
      "title": "Milyoner",
      "description": "Toplam 1.000.000 kariyer puanı topla.",
      "icon": "💎",
      "category": "score",
      "rarity": "legendary",
      "points": 100
    }
  ]
}

[
  {
    "version": "v1.0.3",
    "date": "2026-09-27T18:35:00Z",
    "description": "Başarım açılışı ve ses motoru stabilite güncellemesi.",
    "changes": [
      "Başarım kilidi açıldığında oluşan ses motoru uyumsuzluğu giderildi",
      "Kesintisiz oyun için başarım akışları tam korumalı (fail-safe) hale getirildi",
      "Özel prosedürel zafer arpeji (playAchievement) ses motoruna eklendi"
    ]
  },
  {
    "version": "v1.0.2",
    "date": "2026-09-27T00:00:00Z",
    "description": "Canvas doğrudan dokunmatik kaydırma ve jest kontrolleri güncellemesi.",
    "changes": [
      "Tahta üzerinde doğrudan parmakla sola/sağa hassas blok kaydırma eklendi",
      "Yatay kaydırma sırasında kazara düşüşleri önleyen eksen kilidi (axis lock) geliştirildi",
      "Aşağı hızlı kaydırmada (flick down) doğrudan zemine yapışma (Hard Drop) eklendi",
      "Tek dokunuşla (tap) 90 derece döndürme ve yukarı kaydırmayla saklama (Hold) entegre edildi"
    ]
  },
  {
    "version": "v1.0.1",
    "date": "2026-09-26T21:30:00Z",
    "description": "18 Başarım Paketi ve Kariyer Takibi güncellemesi.",
    "changes": [
      "10 yeni beceri ve kariyer başarımı eklendi (toplam 18 başarım)",
      "Kümülatif kariyer istatistikleri ve SafeStorage kalıcılığı sağlandı",
      "Perfect Clear (Mükemmel Temizlik) ve Back-to-Back Tetris tespiti eklendi"
    ]
  },
  {
    "version": "v1.0.0",
    "date": "2026-09-26T21:00:00Z",
    "description": "Düşen Sicimler resmi PlayZone ve FDB lansman sürümü.",
    "changes": [
      "8 adet Arcade başarımı entegre edildi",
      "Gerçek zamanlı Supabase telemetrisi bağlandı",
      "FDB Depo tarama desteği eklendi",
      "Mobil, Samsung Internet ve Safari tam uyumluluk optimizasyonları yapıldı"
    ]
  }
]

/**
 * 🛡️ FELEROUS ARCADE BRIDGE SDK — HTML5 / CANVAS / WEBGL EDITION (v4.3.8)
 * Resmi CDN: https://store.felerous.com/js/felerous-bridge_html5.js
 * Phaser 3 CDN: https://store.felerous.com/js/felerous-bridge_phaser.js
 *
 * Özellikler:
 * - Polimorfik submitScore(score, tier) & submitScore({ score, difficultyTier, ... })
 * - Yerleşik Neon Cam Liderlik Tablosu (showLeaderboard / closeLeaderboard) & Köşe Rozeti (mountBadge)
 * - Erken skor gönderimlerini koruyan _pendingScores kuyruğu (FELEROUS_PLAYER_INFO el sıkışmasını bekler)
 * - Çift yönlü Origin doğrulaması, Pause / Resume / Mute sinyalleri, Cloud Save & Workshop UGC
 * - Hem kanonik (name, felerousId, avatar) hem alias (username, displayName, felId, avatarUrl) oyuncu alanları
 */
class FelerousBridgeHTML5 {
    constructor(config = {}) {
        if (typeof config === 'string') config = { gameSlug: config };
        this.version = '4.3.8-html5';
        this.engine = 'html5';
        this.gameSlug = config.gameSlug || config.gameId || 'felerous-game';
        this.appId = config.appId || null;
        this.bridgeToken = config.bridgeToken || null;
        this.targetOrigin = config.targetOrigin || 'https://store.felerous.com';

        this.player = this._buildPlayerObject({
            name: 'Oyuncu',
            felerousId: null,
            avatar: 'https://store.felerous.com/image/felerous/FELEROUS.png',
            isGuest: true,
            userId: null
        });
        this.sessionTicket = null;
        this.leaderboard = [];
        this.friends = [];
        this._pendingScores = [];
        this._memoryStorage = {};
        this._verifiedParentOrigin = null;
        this.isEmbedded = typeof window !== 'undefined' && window.self !== window.top;
        this.sessionStartTime = Date.now();
        this.isReady = false;
        this._resolveReady = null;
        this.ready = new Promise((resolve) => {
            this._resolveReady = resolve;
        });

        this._listeners = { ready: [], pause: [], resume: [], mute: [], leaderboard: [], achievement: [], friends: [] };
        this.workshop = new FelerousWorkshopClient(this);

        if (config.onReady) this.on('ready', config.onReady);
        if (config.onLeaderboard) this.on('leaderboard', config.onLeaderboard);
        if (config.onAchievementConfirmed) this.on('achievement', config.onAchievementConfirmed);

        this._setupListeners();
    }

    _isLocalDevEnvironment() {
        if (typeof window === 'undefined' || !window.location) return false;
        const protocol = window.location.protocol;
        const host = (window.location.hostname || '').toLowerCase();
        return (
            protocol === 'file:' ||
            host === 'localhost' ||
            host === '127.0.0.1' ||
            host === '::1' ||
            host === '[::1]' ||
            host.endsWith('.local')
        );
    }

    _isTrustedOrigin(origin) {
        if (!origin || typeof origin !== 'string') return false;
        const trustedOrigins = [
            'https://store.felerous.com',
            'https://arcade.felerous.com',
            'https://developer.felerous.com',
            'https://felerous-store.vercel.app'
        ];
        if (this.targetOrigin && this.targetOrigin !== '*' && !trustedOrigins.includes(this.targetOrigin)) {
            trustedOrigins.push(this.targetOrigin);
        }
        if (trustedOrigins.includes(origin)) return true;
        if (this._isLocalDevEnvironment()) {
            return /^http:\/\/(localhost|127\.0\.0\.1)(:\d+)?$/i.test(origin);
        }
        return false;
    }

    _resolveTargetOrigin() {
        if (this._verifiedParentOrigin && this._isTrustedOrigin(this._verifiedParentOrigin)) {
            return this._verifiedParentOrigin;
        }
        if (typeof document !== 'undefined' && document.referrer) {
            try {
                const refOrigin = new URL(document.referrer).origin;
                if (this._isTrustedOrigin(refOrigin)) return refOrigin;
            } catch (_) {}
        }
        if (this.targetOrigin && this.targetOrigin !== '*' && this._isTrustedOrigin(this.targetOrigin)) {
            return this.targetOrigin;
        }
        return 'https://store.felerous.com';
    }

    _buildPlayerObject(raw = {}) {
        const name = raw.name || raw.player_name || raw.username || raw.displayName || 'Oyuncu';
        const felerousId = raw.felerousId || raw.felerous_id || raw.felId || null;
        const avatar = raw.avatar || raw.avatar_url || raw.avatarUrl || 'https://store.felerous.com/image/felerous/FELEROUS.png';
        const isGuest = raw.isGuest !== undefined ? Boolean(raw.isGuest) : Boolean(raw.is_guest);
        const userId = raw.userId || raw.user_id || raw.id || felerousId || null;
        return {
            name, felerousId, avatar, isGuest, userId,
            username: name, displayName: name, felId: felerousId, avatarUrl: avatar, id: userId || felerousId || 'guest'
        };
    }

    on(event, callback) {
        if (typeof callback !== 'function') return this;
        if (!this._listeners[event]) this._listeners[event] = [];
        this._listeners[event].push(callback);
        if (event === 'ready' && this.isReady) callback(this.player);
        return this;
    }

    onReady(cb) { return this.on('ready', cb); }
    onLeaderboard(cb) { return this.on('leaderboard', cb); }
    onAchievementConfirmed(cb) { return this.on('achievement', cb); }
    onFriends(cb) { return this.on('friends', cb); }

    _emit(event, data, extra) {
        (this._listeners[event] || []).forEach(fn => {
            try { fn(data, extra); } catch (e) { console.warn('[FelerousBridge]', e); }
        });
    }

    init(options = {}) {
        if (typeof options === 'string') options = { gameSlug: options };
        if (options.gameSlug || options.gameId) this.gameSlug = options.gameSlug || options.gameId;
        if (options.appId) this.appId = options.appId;
        if (options.bridgeToken) this.bridgeToken = options.bridgeToken;
        if (options.targetOrigin) this.targetOrigin = options.targetOrigin;
        if (options.onReady) this.on('ready', options.onReady);
        if (options.onLeaderboard) this.on('leaderboard', options.onLeaderboard);
        if (options.onAchievementConfirmed) this.on('achievement', options.onAchievementConfirmed);
        if (options.mountBadge) {
            this.mountBadge(typeof options.mountBadge === 'object' ? options.mountBadge : { position: options.mountBadge });
        }

        this.sessionStartTime = Date.now();

        return new Promise((resolve) => {
            const handleReady = (p) => {
                if (this._resolveReady) this._resolveReady(p);
                resolve(p);
            };

            if (this.isReady && this.player) {
                handleReady(this.player);
                return;
            }

            this.on('ready', handleReady);

            if (this.isEmbedded) {
                this._postToParent({
                    type: 'FELEROUS_INIT_PLAYER',
                    game_id: this.gameSlug,
                    app_id: this.appId,
                    bridge_token: this.bridgeToken,
                    timestamp: Date.now()
                });
            } else if (this._isLocalDevEnvironment()) {
                // 🧪 Yerel Geliştirici Simülasyon Modu (Yalnızca localhost / 127.0.0.1 / file://)
                setTimeout(() => {
                    if (!this.isReady) {
                        this.player = this._buildPlayerObject({
                            name: 'Geliştirici (Yerel Test)',
                            felerousId: 'DEV-TEST-001',
                            avatar: 'https://store.felerous.com/image/felerous/FELEROUS.png',
                            isGuest: false,
                            userId: 'mock-dev-id'
                        });
                        this.sessionTicket = 'mock_tkt_' + Date.now();
                        this.isReady = true;
                        this._emit('ready', this.player);
                    }
                }, 50);
            } else {
                // 🌐 Üretim Ortamında Doğrudan Açılış — Standalone Misafir Modu
                setTimeout(() => {
                    if (!this.isReady) {
                        this.player = this._buildPlayerObject({
                            name: 'Misafir Oyuncu',
                            felerousId: null,
                            avatar: 'https://store.felerous.com/image/felerous/FELEROUS.png',
                            isGuest: true,
                            userId: null
                        });
                        this.sessionTicket = null;
                        this.isReady = true;
                        this._emit('ready', this.player);
                    }
                }, 50);
            }
        });
    }

    _setupListeners() {
        if (typeof window === 'undefined' || typeof window.addEventListener !== 'function') return;

        window.addEventListener('message', (event) => {
            if (this.isEmbedded) {
                if (event.source !== window.parent) return;
                if (!this._isTrustedOrigin(event.origin)) return;
                this._verifiedParentOrigin = event.origin;
            } else if (!this._isLocalDevEnvironment()) {
                return;
            }

            const data = event.data;
            if (!data || typeof data !== 'object') return;

            switch (data.type) {
                case 'FELEROUS_PLAYER_INFO':
                case 'FELEROUS_AUTH_SUCCESS':
                    this.player = this._buildPlayerObject(data);
                    if (data.session_ticket) this.sessionTicket = data.session_ticket;
                    this.isReady = true;
                    if (this._resolveReady) this._resolveReady(this.player);
                    this._flushPendingScores();
                    this._emit('ready', this.player);
                    break;
                case 'FELEROUS_LEADERBOARD_UPDATE':
                    this.leaderboard = data.leaderboard || [];
                    this._emit('leaderboard', this.leaderboard);
                    break;
                case 'FELEROUS_ACHIEVEMENT_CONFIRMED':
                    this._emit('achievement', data);
                    break;
                case 'FELEROUS_FRIENDS_DATA':
                    this._emit('friends', data.friends || []);
                    break;
            }
        });
    }

    _flushPendingScores() {
        if (!this.sessionTicket || !this._pendingScores || this._pendingScores.length === 0) return;
        const queue = this._pendingScores.splice(0, this._pendingScores.length);
        queue.forEach(payload => {
            payload.session_ticket = this.sessionTicket;
            this._postToParent(payload);
        });
    }

    submitScore(input = 0, maybeTier = 'lvl1') {
        let cfg = {};
        if (typeof input === 'number') {
            cfg = (typeof maybeTier === 'object' && maybeTier !== null)
                ? { ...maybeTier, score: input }
                : { score: input, difficultyTier: typeof maybeTier === 'string' ? maybeTier : 'lvl1' };
        } else if (typeof input === 'object' && input !== null) {
            cfg = input;
        }

        const rawDuration = cfg.durationSeconds !== undefined && cfg.durationSeconds !== null
            ? Number(cfg.durationSeconds)
            : Math.floor((Date.now() - this.sessionStartTime) / 1000);
        const duration = Math.max(1, Math.floor(Number.isFinite(rawDuration) ? rawDuration : 1));

        const payload = {
            type: 'FELEROUS_SUBMIT_SCORE',
            game_id: this.gameSlug,
            app_id: this.appId,
            bridge_token: this.bridgeToken,
            session_ticket: this.sessionTicket,
            score: Math.max(0, Math.floor(Number(cfg.score) || 0)),
            level_reached: cfg.levelReached || 1,
            lines_cleared: cfg.linesCleared || 0,
            difficulty_tier: cfg.difficultyTier || 'lvl1',
            difficulty_label: cfg.difficultyLabel || 'Standart',
            duration_seconds: duration,
            achievements: cfg.achievements || [],
            stats: cfg.stats || {},
            timestamp: Date.now()
        };

        if (this.isEmbedded) {
            if (!this.sessionTicket) {
                if (this._pendingScores.length < 20) this._pendingScores.push(payload);
                this._postToParent({
                    type: 'FELEROUS_INIT_PLAYER',
                    game_id: this.gameSlug,
                    app_id: this.appId,
                    bridge_token: this.bridgeToken,
                    timestamp: Date.now()
                });
            } else {
                this._postToParent(payload);
            }
        }
        return Promise.resolve(payload);
    }

    unlockAchievement(achievementId) {
        if (!achievementId) return;
        this._postToParent({
            type: 'FELEROUS_UNLOCK_ACHIEVEMENT',
            game_id: this.gameSlug,
            app_id: this.appId,
            session_ticket: this.sessionTicket,
            achievement_id: achievementId,
            timestamp: Date.now()
        });
    }

    requestLeaderboard(difficultyTier = null) {
        if (this.isEmbedded) {
            this._postToParent({
                type: 'FELEROUS_GET_LEADERBOARD',
                game_id: this.gameSlug,
                difficulty_tier: difficultyTier
            });
        }
    }

    getLeaderboard(difficultyTier = null) { return this.requestLeaderboard(difficultyTier); }

    saveCloudData(slotOrData = 'default', maybeData = undefined) {
        const slotKey = (maybeData === undefined && typeof slotOrData === 'object') ? 'default' : String(slotOrData || 'default');
        const data = (maybeData === undefined && typeof slotOrData === 'object') ? slotOrData : maybeData;
        try { localStorage.setItem(`felerous_cloud_${this.gameSlug}_${slotKey}`, JSON.stringify(data)); } catch (e) {}
        if (this.isEmbedded) {
            this._postToParent({ type: 'FELEROUS_CLOUD_SAVE', game_id: this.gameSlug, app_id: this.appId, session_ticket: this.sessionTicket, slot: slotKey, data, timestamp: Date.now() });
        }
        return Promise.resolve({ success: true, slot: slotKey });
    }

    loadCloudData(slotKey = 'default') {
        try {
            const raw = localStorage.getItem(`felerous_cloud_${this.gameSlug}_${slotKey}`);
            return Promise.resolve(raw ? JSON.parse(raw) : null);
        } catch (e) { return Promise.resolve(null); }
    }

    openReviews() {
        if (this.isEmbedded) {
            this._postToParent({
                type: 'FELEROUS_OPEN_REVIEWS',
                game_id: this.gameSlug,
                app_id: this.appId,
                timestamp: Date.now()
            });
        }
    }

    exitToPlayzone() {
        const targetUrl = 'https://store.felerous.com/playzone';
        if (this.isEmbedded) {
            this._postToParent({ type: 'FELEROUS_EXIT_GAME', game_id: this.gameSlug, redirect_url: targetUrl });
        }
        setTimeout(() => {
            try {
                if (window.top && window.top !== window.self) window.top.location.href = targetUrl;
                else window.location.href = targetUrl;
            } catch (e) {
                window.location.href = targetUrl;
            }
        }, 150);
    }

    _postToParent(payload) {
        if (!this.isEmbedded || typeof window === 'undefined' || !window.parent || window.parent === window.self) return;
        try {
            const targetOrigin = this._resolveTargetOrigin();
            if (!targetOrigin || targetOrigin === '*') return;
            window.parent.postMessage(payload, targetOrigin);
        } catch (e) {
            console.warn('[FelerousBridge] postMessage hatası:', e);
        }
    }
}

// Oyuncu editörde veya stüdyoda "Atölyede Paylaş" butonuna bastığında:
const result = await felerousBridge.workshop.publish({
  gameSlug: 'neonvolt',
  title: 'Özel Arena Parkuru Mk-IV',
  category: 'map',                  // 'map', 'skin', 'blueprint', 'mod'
  description: 'Gelişmiş neon engeller ve çift hızlı hızlandırma hatlarına sahip arena haritası.',
  footprint: '2x2',                 // Ayak izi (1x1, 2x2, 3x3 vb.)
  previewImage: canvas.toDataURL('image/png'), // Küçük resim (thumbnail)
  blueprintData: myMapModelData,    // JSON formatında model/çizim verisi (Maks 512KB)
  tags: ['neon', 'arena', 'speed', 'custom']
});

if (result.success) {
  alert('🎉 Tasarımınız FELEROUS Topluluk Atölyesi\'nde yayınlandı! Eser ID: ' + result.item_id);
} else {
  alert('Yayınlama hatası: ' + result.error);
}

// Oyun içi Varlık Mağazasında (Roblox Toolbox tarzı) topluluk modellerini getirin:
const res = await felerousBridge.workshop.getItems({
  gameSlug: 'neonvolt',
  category: 'map',                  // Opsiyonel filtre
  search: 'neon',                   // Opsiyonel arama kelimesi
  sort: 'popular',                  // 'popular', 'newest', 'subscribers'
  limit: 20
});

if (res.success && res.items.length > 0) {
  res.items.forEach(item => {
    console.log(`[Atölye] ${item.title} — Yazar: ${item.author_name} — 👍 ${item.upvotes_count}`);
    // Modeli oyuna yüklemek için:
    // myGameEngine.loadBlueprint(item.blueprint_data);
  });
}

// Eseri beğenme (+1 Upvote):
await felerousBridge.workshop.vote(item.id, 'up');

// Esere abone olma (Kullanıcı kütüphanesine kaydetme):
await felerousBridge.workshop.subscribe(item.id, true);

class MyGame {
  constructor() {
    this.useFriendBots = SafeStorage.getItem('friend_bots_enabled') !== 'false';
    this.botNames = [];
    this.bots = [];
    
    this.setupFriendBotToggle();
    this.loadBotNames();
  }

  // 1. Ayarı ve Butonu Bağla
  setupFriendBotToggle() {
    const toggle = document.getElementById('toggle-friend-bots');
    if (toggle) {
      toggle.checked = this.useFriendBots;
      toggle.addEventListener('change', (e) => {
        this.useFriendBots = e.target.checked;
        SafeStorage.setItem('friend_bots_enabled', this.useFriendBots ? 'true' : 'false');
        this.loadBotNames(); // İsim havuzunu yenile
      });
    }
  }

  // 2. Felerous SDK ile İsim Havuzunu Yükle
  async loadBotNames() {
    if (!this.useFriendBots) {
      // Özellik kapalıysa varsayılan bot isimlerini kullan
      this.botNames = ['AlphaBot', 'BetaBot', 'OmegaBot', 'Titan', 'Ghost'];
      return;
    }

    try {
      this.botNames = await felerousBridge.getFriendBotNames({
        count: 15,
        fallbackNames: ['AlphaBot', 'BetaBot', 'OmegaBot', 'Spectre', 'Viper', 'Ghost'],
        shuffle: true
      });
      console.log('🤖 Bot isimleri hazırlandı:', this.botNames);
    } catch (err) {
      this.botNames = ['AlphaBot', 'BetaBot', 'OmegaBot'];
    }
  }

  // 3. Bot Doğarken İsim Ata
  spawnBot() {
    const randomName = this.botNames[Math.floor(Math.random() * this.botNames.length)] || 'Bot';
    this.bots.push({
      x: Math.random() * canvas.width,
      y: 0,
      name: randomName,
      speed: 3
    });
  }

  // 4. Canvas Üzerinde Botu ve İsmini Çiz
  render(ctx) {
    for (const bot of this.bots) {
      // Bot gövdesi
      ctx.fillStyle = '#ef4444';
      ctx.fillRect(bot.x - 15, bot.y - 15, 30, 30);

      // Botun üstüne arkadaş ismini yaz
      ctx.font = '11px -apple-system, sans-serif';
      ctx.fillStyle = '#bae6fd';
      ctx.textAlign = 'center';
      ctx.fillText(bot.name, bot.x, bot.y - 20);
    }
  }
}

extends Node

var friend_bot_names: Array = []
var _js_callback: JavaScriptObject

func _ready():
    if OS.has_feature("web"):
        _js_callback = JavaScriptBridge.create_callback(_on_friends_received)
        # HTML5 katmanındaki felerousBridge'e çağrı yap
        JavaScriptBridge.eval("""
            if (window.felerousBridge) {
                window.felerousBridge.getFriendBotNames({ count: 10, fallbackNames: ['CyberBot', 'DroidX', 'Titan'] })
                    .then(names => window._godotFriendsCallback(JSON.stringify(names)));
            }
        """)
        var window = JavaScriptBridge.get_interface("window")
        window._godotFriendsCallback = _js_callback

func _on_friends_received(args):
    if args.size() > 0:
        var json_str = args[0]
        var parsed = JSON.parse_string(json_str)
        if typeof(parsed) == TYPE_ARRAY:
            friend_bot_names = parsed
            print("Godot: Arkadaş Bot İsimleri Yüklendi: ", friend_bot_names)

func spawn_bot():
    var bot_instance = preload("res://Bot.tscn").instantiate()
    if friend_bot_names.size() > 0:
        bot_instance.bot_name = friend_bot_names.pick_random()
    add_child(bot_instance)

mergeInto(LibraryManager.library, {
    FetchFriendBotNames: function (gameObjectNamePtr, callbackMethodNamePtr) {
        var objName = UTF8ToString(gameObjectNamePtr);
        var methodName = UTF8ToString(callbackMethodNamePtr);
        
        if (window.felerousBridge) {
            window.felerousBridge.getFriendBotNames({ count: 10 })
                .then(function(names) {
                    SendMessage(objName, methodName, JSON.stringify(names));
                });
        }
    }
});

using System.Runtime.InteropServices;
using UnityEngine;

public class GameManager : MonoBehaviour
{
    [DllImport("__Internal")]
    private static extern void FetchFriendBotNames(string gameObjectName, string callbackMethodName);

    public string[] friendBotNames;

    void Start()
    {
#if UNITY_WEBGL && !UNITY_EDITOR
        FetchFriendBotNames(gameObject.name, "OnFriendNamesReceived");
#else
        friendBotNames = new string[] { "AlphaBot", "BetaBot", "OmegaBot" };
#endif
    }

    public void OnFriendNamesReceived(string jsonArray)
    {
        friendBotNames = JsonUtility.FromJson<string[]>(jsonArray);
        Debug.Log("Unity: Arkadaş bot isimleri yüklendi!");
    }
}

// 1. Köprüyü ve Avatar Çiziciyi Başlatın
const bridge = window.felerousBridge;
const renderer = new FelerousAvatarRenderer({ pixelScale: 2 });

// 2. Oyuncunun Kendi Avatarını Alıp Çizdirin
const mySpec = await bridge.avatars.getMyAvatar('cube_v1');
renderer.render(ctx, mySpec, 200, 300, {
  facing: 'right',             // 'left' veya 'right' (Omuz Z-Order katmanlaması otomatik)
  isWalking: true,             // Yürüyüş mafsal salınımı
  walkCycleTime: performance.now(),
  holdsBag: true,              // Elinde AVM alışveriş poşeti
  bagColor: '#e74c3c'
});

// 3. Canlı Oyuncu NPC Havuzunu Çekip Oyuna Doldurun
const npcs = await bridge.avatars.getNPCPool({ count: 10, category: 'fashion' });
npcs.forEach((npc, index) => {
  console.log(`[NPC Doğdu] ${npc.player_name} — Bütçe: ₺${npc.simulated_budget} — VIP: ${npc.is_vip}`);
  // NPC avatar verisini sahneye ekleyin:
  // spawnCustomer(npc.avatar_spec, npc.player_name, npc.simulated_budget);
});

// Oyun bittiğinde veya oyuncu ana menüde "⭐ Oyunu Değerlendir" butonuna bastığında:
function onGameOverOrFeedbackClick() {
    // PlayZone üst çubuğundaki oylama & yorum modalını tetikler:
    felerousBridge.openReviews();
}

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": ["VideoGame", "WebApplication"],
  "name": "Düşen Sicimler",
  "applicationCategory": "GameApplication",
  "operatingSystem": "Web Browser, HTML5, WebGL",
  "inLanguage": "tr",
  "offers": {
    "@type": "Offer",
    "price": "0",
    "priceCurrency": "TRY",
    "availability": "https://schema.org/InStock"
  },
  "author": {
    "@type": "Organization",
    "name": "Subushaki"
  },
  "publisher": {
    "@type": "Organization",
    "name": "FELEROUS",
    "url": "https://felerous.com"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "bestRating": "5",
    "worstRating": "1",
    "ratingCount": "18"
  }
}
</script>

html, body, #game-container {
  height: 100vh;
  height: -webkit-fill-available;
  height: 100dvh;
  overflow: hidden;
  position: fixed;
  width: 100%;
}

window.SafeStorage = {
  _mem: {},
  getItem(k) {
    try { return localStorage.getItem(k); }
    catch (e) { return this._mem[k] || null; }
  },
  setItem(k, v) {
    try { localStorage.setItem(k, v); }
    catch (e) { this._mem[k] = String(v); }
  }
};

function unlockAudio() {
  if (!window.audioCtx) return;
  if (window.audioCtx.state === 'suspended') {
    window.audioCtx.resume().then(() => {
      if (window.audioCtx.state === 'running') {
        document.removeEventListener('pointerdown', unlockAudio);
      }
    }).catch(() => {});
  } else if (window.audioCtx.state === 'running') {
    document.removeEventListener('pointerdown', unlockAudio);
  }
}
document.addEventListener('pointerdown', unlockAudio, { passive: true });

:root { color-scheme: dark; }
canvas { color-scheme: dark; forced-color-adjust: none; touch-action: none; }

// Yatay sürüklemede kazara düşüşleri engelleyen eksen kilidi
let touchStartX = 0, touchStartY = 0, isDragging = false;

canvas.addEventListener('touchstart', (e) => {
  const t = e.touches[0];
  touchStartX = t.clientX;
  touchStartY = t.clientY;
  isDragging = true;
}, { passive: true });

canvas.addEventListener('touchmove', (e) => {
  if (!isDragging) return;
  const dx = e.touches[0].clientX - touchStartX;
  const dy = e.touches[0].clientY - touchStartY;

  // Eksen kilidi: Yatay hareket dikey hareketten fazlaysa sola/sağa kaydır
  if (Math.abs(dx) > Math.abs(dy) && Math.abs(dx) > 28) {
    if (dx > 0) game.moveRight(); else game.moveLeft();
    touchStartX = e.touches[0].clientX;
  }
}, { passive: true });

canvas.addEventListener('touchend', (e) => {
  isDragging = false;
});

{
  "protocol": "felerous-telemetry-v1",
  "status": "online",
  "service": "neon-volt-multiplayer",
  "timestamp": 1727701800000,
  "uptime": 14200,
  "performance": {
    "tps": 30.0,
    "tickIntervalMs": 33.33,
    "memoryMB": 42
  },
  "players": {
    "online": 3,
    "max": 30,
    "humans": 3,
    "bots": 10,
    "list": [
      { "id": "p_1", "name": "Vortex", "score": 2400, "isVerified": true }
    ]
  },
  "bots": {
    "count": 10,
    "archetypes": [
      { "name": "SiberCellat", "title": "Psikopat Avcı (Bwoniknife)", "score": 1420 }
    ]
  },
  "arena": {
    "radius": 2900,
    "foodCount": 650
  },
  "leaderboard": [
    { "rank": 1, "name": "Vortex", "score": 2400, "isPlayer": true },
    { "rank": 2, "name": "SiberCellat", "score": 1420, "isPlayer": false }
  ]
}