Felerous Arcade SDK v4.3.8 & Atölye UGC 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
    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:
  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: 'void-factory',
  title: 'Ağır Plazma Kulesi Mk-IV',
  category: 'turret',               // 'turret', 'factory', 'defense', 'conveyor', 'blueprint', 'mod', 'map'
  description: 'Gelişmiş soğutma ünitesi ve çift manyetik hızlandırıcıya sahip savunma kulesi.',
  footprint: '2x2',                 // Ayak izi (1x1, 2x2, 3x3 vb.)
  previewImage: canvas.toDataURL('image/png'), // Küçük resim (thumbnail)
  blueprintData: myTurretModelData, // JSON formatında model/çizim verisi (Maks 512KB)
  tags: ['plasma', 'heavy', 'defense', '2x2']
});

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: 'void-factory',
  category: 'turret',               // Opsiyonel filtre
  search: 'plazma',                 // 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);

<script>
  // 1. Aktif oyuncunun veya arkadaşının avatarını FEL-ID ile çek:
  const avatar = await FelerousCubeRig.getAvatar(player.felerousId);
  console.log('Avatar Renk Paleti:', avatar.palette);
  console.log('Kıyafet & Aksesuarlar:', avatar.slots);

  // 2. Canlı 10 adet Drivatar NPC'si çek (Arka plan kalabalığı, yarış rakipleri vb.):
  const npcs = await FelerousCubeRig.getNPCPool(10);
  npcs.forEach(npc => {
    console.log(`NPC Adı: ${npc.name}, FEL-ID: ${npc.felerousId}`);
  });
</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 && window.audioCtx.state === 'suspended') {
    window.audioCtx.resume();
  }
  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": "SiberCellat", "score": 1420, "isPlayer": false },
    { "rank": 2, "name": "Vortex", "score": 2400, "isPlayer": true }
  ]
}