Oyun Entegrasyonu

TDZ Pro Skin Hub, oyununa skinleri URL üzerinden taşır. Oyuncular bir skin sayfasındaki URL Kopyala butonuna basıp kopyaladıkları bağlantıyı oyunun "Skin URL" alanına yapıştırırlar. Oyun da o URL'ye basit bir HTTP GET isteği atar ve PNG'yi indirir.

Adım 1

Skin URL formatı

Her yayınlanan skin için sabit, public bir URL üretilir:

GET https://<host>/api/skins/{public_id}/raw

Response:
  Content-Type: image/png
  X-Skin-Id: {public_id}
  Body: <raw PNG bytes>

Adım 2

Oyunda nasıl kullanılır

Oyun kodunda örnek (UnityWebRequest):

using UnityEngine;
using UnityEngine.Networking;
using System.Collections;

IEnumerator LoadSkin(string url, Renderer target) {
    using (var req = UnityWebRequestTexture.GetTexture(url)) {
        yield return req.SendWebRequest();
        if (req.result == UnityWebRequest.Result.Success) {
            var tex = ((DownloadHandlerTexture)req.downloadHandler).texture;
            target.material.mainTexture = tex;
        }
    }
}

Adım 3

Doğrulama / cache

Endpoint Cache-Control: public, max-age=300 döner.
Geçerli URL ise 200 + PNG, geçersizse 404.
CORS açık (Access-Control-Allow-Origin: *).
Bir skin silinirse aynı URL artık 404 döner — oyun fallback uygulayabilir.

Adım 4

Base texture indirme

Modder, araç sayfasındaki Base Texture İndir butonu ile 1024×1024 PNG'yi indirir. Üstüne kendi tasarımını çizip Skin Yükle ekranından paylaşır. Yüklediği skinin URL'si otomatik üretilir, oyuna o URL'yi yapıştırır.