Başvuru

PlayDrop MCP yükleme hataları ve kurtarma

PlayDrop’un MCP araçlarının döndürdüğü hata biçimi, aynı requestId ile ne zaman tekrar denenmeli ve her yaygın hata kodunun çözümü.

Her PlayDrop MCP aracı hatası değişmeyen error kodunu ve path, field, name veya expected gibi ayrıntıları korur ve şunları ekler:

message: neyin yanlış gittiği, sade bir dille.
retryable: yalnızca aynı çağrı daha sonra başarılı olabilecekse true.
nextAction: somut düzeltme.
docsUrl ve documentationTopic: okunacak kılavuz; get_documentation ile de alınabilir.

Tekrar dene ya da düzelt

Tekrar denenebilir hatalar (geçici hatalar, hız sınırları, yarıda kalan bir tamamlama): kısa bir beklemeden sonra aynı çağrıyı aynı requestId ile tekrar dene. Başka bir sürüm oluşturma.
Kaybolan yanıt: işe yarayıp yaramadığını bilemezsin; bu yüzden aynı içeriği aynı requestId ile tekrar dene. PlayDrop iki kez yayınlamak yerine özgün sonucu döndürür.
Reddedilen girdi: önce belirtilen alanı ya da dosyayı düzelt. Değişen içerik yeni bir requestId gerektirir; değişmemiş girdiyi tekrar denemek yine başarısız olur.
Kısmi paket sonuçları: tamamlanan öğeler yayınlanmış kalır. Düzeltilmiş bir istek yalnızca bitmemiş işi içermelidir.
send_feedback için tekrar deneme anahtarı yoktur. Belirsiz bir hatadan sonra otomatik olarak yeniden gönderme: ilk mesaj ulaşmış olabilir.

Yaygın hatalar

Kod	Ne yapmalı
`advanced_upload_required`	Oyun SDK’yı, bir sunucuyu, ayrı dosyaları ya da yalnızca pakete özgü alanları kullanıyor. Bu özellikleri koru ve yeni bir `requestId` ile bir paket yükle.
`invalid_html_file`	HTML boş ya da 10 MiB’tan büyük. Daha büyük oyunlar için bir paket kullan.
`visibility_required`	Bir paket uygulamasının görünürlüğü yok. İstekte ya da uygulamada `visibility` ayarla: `public`, `unlisted` veya `private`.
`invalid_visibility`	`public`, `unlisted` veya `private` kullan.
`visibility_conflict`	İstek ve bir uygulama girişi farklı görünürlükler istiyor. Kitlenin asla sessizce değişmemesi için tek bir değer ver.
`expected_current_version_required`	Her uygulamanın adını `expectedCurrentVersion` içine ekle: yeni bir oyun için `null`, aksi halde `list_games` içindeki güncel sürüm.
`current_version_changed`	Biri daha yeni bir sürüm yayınladı. `list_games` çağır, hedefi kullanıcınla doğrula, sonra güncel sürümle ve yeni bir `requestId` ile yükle.
`game_exists_use_id`, `game_not_found`	`list_games` çağır, doğru `gameId` değerini ya da adı kullan ve oyunun mevcut adını koru.
`request_id_content_conflict`	Bu `requestId` zaten farklı bir içeriğe ait. Yeni bir kimlik kullan ya da özgün içeriği değiştirmeden yeniden gönder.
`catalogue_file_missing_or_invalid`	Bir dosya yüklenmedi ya da baytları eşleşmiyor. `prepare_catalogue_upload` çağrısını aynı girdiyle ve aynı `requestId` ile tekrar yap, eksik dosyaları PUT ile gönder, sonra yeniden tamamla.
`catalogue_files_unclaimed`	Bazı dosyalar hiçbir katalog girişi tarafından kullanılmıyor. Onlara referans ver, oyun sayfası dosyalarına `role: "LISTING"` ve `app` ver ya da onları kaldır.
`entry_point_missing`	`apps[].file`, yüklenmemiş bir dosyayı belirtiyor. `file` olmadan giriş varsayılan olarak `<name>.html` olur.
`archive_catalogue_required`	catalogue.json dosyasını bir klasörün içine değil, ZIP’in köküne koy.
`archive_too_large`	Sıkıştırılmış hali 20 MiB’ı aşıyorsa: arşivi aç ve klasörü dosya başına 50 MiB’a kadar izin veren imzalı dosyalarla yükle. Açılmış hali 200 MiB’ı aşıyorsa: oyunun kendisi tek bir sürüm için fazla büyük; asset’leri sıkıştır ya da kaldır.
`procedural_module_validation_unavailable`	Çalıştırılabilir prosedürel 3D ya da özel biçimli modeller MCP üzerinden yüklenemez. Bunları sabit bir biçime dönüştür ya da yayınlanmış bir asset’e referans ver.
`upload_expired`, `upload_cancelled`	Yüklemeyi yeni bir `requestId` ile tekrar hazırla ve 30 dakika içinde tamamla.
`invalid_token`, `insufficient_scope`	PlayDrop hesabını yapay zeka uygulamanda yeniden bağla ve yayınlamaya izin ver.

Geçersiz bir etiket, kumanda bildirimi ya da oyuncu modu gibi katalog alanı hataları catalogue.json başvurusuna yönlendirir.

Bağlantı ve ekler

Süresi dolmuş bağlantı: etkin bir bağlantı kullanıldıkça kendini yeniler. 30 gün kullanılmamış ya da bu kuraldan önce süresi dolmuş bir bağlantının yeniden kurulması gerekir.
Reddedilen ek: PlayDrop dosyaları yalnızca ana uygulamanın kendi ek hizmetinden indirir. Bu bir ülke kısıtlaması değil, dosya barındırma kısıtlamasıdır. Ana uygulamanın çözümlediği eki geçir ya da dosyaları imzalı URL’lerle yükle. Asla bir download_url veya file_id uydurma.

Sorun bildir

Bir hata yanlış görünüyorsa ya da sonraki eylem işe yaramıyorsa send_feedback aracını bir kez çağır; araç adını, hata kodunu, ne gönderdiğini (jetonlar ya da imzalı URL’ler olmadan) ve ne beklediğini belirt.