Referens

Uppladdningsfel i PlayDrops MCP och hur du åtgärdar dem

Formatet på felen som PlayDrops MCP-verktyg returnerar, när du ska försöka igen med samma requestId och åtgärden för varje vanlig felkod.

Varje fel från ett MCP-verktyg i PlayDrop behåller sin stabila error-kod och eventuella detaljer som path, field, name eller expected, och lägger till:

message: vad som gick fel, med enkla ord.
retryable: true bara när exakt samma anrop kan lyckas senare.
nextAction: den konkreta rättelsen.
docsUrl och documentationTopic: guiden att läsa, som också finns via get_documentation.

Försök igen eller rätta

Fel som går att försöka igen (tillfälliga fel, hastighetsbegränsningar, ett avbrutet slutförande): gör exakt samma anrop igen med samma requestId efter en kort stund. Skapa ingen ny version.
Förlorat svar: du kan inte veta om det fungerade, så skicka exakt samma innehåll igen med samma requestId. PlayDrop returnerar det ursprungliga resultatet i stället för att publicera två gånger.
Avvisad indata: rätta först det namngivna fältet eller den namngivna filen. Ändrat innehåll kräver ett nytt requestId; att försöka igen med oförändrad indata misslyckas igen.
Delvisa paketresultat: slutförda poster förblir publicerade. En rättad förfrågan ska bara innehålla det arbete som inte är klart.
send_feedback har ingen nyckel för nya försök. Efter ett oklart fel ska du inte skicka igen automatiskt: det första meddelandet kan ha kommit fram.

Vanliga fel

Kod	Vad du ska göra
`advanced_upload_required`	Spelet använder SDK:t, en server, separata filer eller fält som bara finns för paket. Behåll de funktionerna och ladda upp ett paket med ett nytt `requestId`.
`invalid_html_file`	HTML-filen är tom eller större än 10 MiB. Använd ett paket för större spel.
`visibility_required`	En app i ett paket saknar synlighet. Ange `visibility` i förfrågan eller i appen: `public`, `unlisted` eller `private`.
`invalid_visibility`	Använd `public`, `unlisted` eller `private`.
`visibility_conflict`	Förfrågan och posten för en app begär olika synlighet. Ange en, så att publiken aldrig ändras i tysthet.
`expected_current_version_required`	Lägg till varje apps namn i `expectedCurrentVersion`: `null` för ett nytt spel, annars den aktuella versionen från `list_games`.
`current_version_changed`	Någon har publicerat en nyare version. Anropa `list_games`, bekräfta målet med din användare och ladda sedan upp med den aktuella versionen och ett nytt `requestId`.
`game_exists_use_id`, `game_not_found`	Anropa `list_games`, använd rätt `gameId` eller namn och behåll spelets befintliga namn.
`request_id_content_conflict`	Det här `requestId` hör redan till annat innehåll. Använd ett nytt ID eller skicka det ursprungliga innehållet igen oförändrat.
`catalogue_file_missing_or_invalid`	En fil laddades inte upp eller dess byte stämmer inte. Anropa `prepare_catalogue_upload` igen med identisk indata och samma `requestId`, gör PUT på de saknade filerna och slutför sedan igen.
`catalogue_files_unclaimed`	Vissa filer används inte av någon katalogpost. Referera till dem, ge filer för spelsidan `role: "LISTING"` och `app`, eller ta bort dem.
`entry_point_missing`	`apps[].file` anger en fil som inte laddades upp. Utan `file` är startsidan som standard `<name>.html`.
`archive_catalogue_required`	Lägg catalogue.json i roten av ZIP-filen, inte i en mapp.
`archive_too_large`	Över 20 MiB komprimerat: packa upp och ladda upp mappen med signerade filer, vilket tillåter upp till 50 MiB per fil. Över 200 MiB uppackat: själva spelet är för stort för en version; komprimera eller ta bort assets.
`procedural_module_validation_unavailable`	Körbara procedurella 3D-modeller eller modeller i eget format kan inte laddas upp via MCP. Baka dem eller referera till en publicerad asset.
`upload_expired`, `upload_cancelled`	Förbered uppladdningen igen med ett nytt `requestId` och slutför den inom 30 minuter.
`invalid_token`, `insufficient_scope`	Anslut PlayDrop-kontot igen i din AI-app och tillåt publicering.

Fel i katalogfält, som en ogiltig tagg, deklaration av handkontroller eller spelarläge, hänvisar till referensen för catalogue.json.

Anslutning och bilagor

Utgången anslutning: en aktiv anslutning förnyas av sig själv medan den används. En anslutning som inte har använts på 30 dagar, eller en som gick ut före den här regeln, måste anslutas igen.
Avvisad bilaga: PlayDrop laddar bara ner filer från värdens egen bilagetjänst. Det är en begränsning för filvärdar, inte för länder. Skicka bilagan som värden har löst upp, eller ladda upp filerna med signerade URL:er. Hitta aldrig på en download_url eller ett file_id.

Rapportera ett problem

Om ett fel ser felaktigt ut eller nästa åtgärd inte fungerar, anropa send_feedback en gång med verktygets namn, felkoden, vad du skickade (utan tokens eller signerade URL:er) och vad du förväntade dig.

Försök igen eller rätta

Fel som går att försöka igen (tillfälliga fel, hastighetsbegränsningar, ett avbrutet slutförande): gör exakt samma anrop igen med samma requestId efter en kort stund. Skapa ingen ny version.
Förlorat svar: du kan inte veta om det fungerade, så skicka exakt samma innehåll igen med samma requestId. PlayDrop returnerar det ursprungliga resultatet i stället för att publicera två gånger.
Avvisad indata: rätta först det namngivna fältet eller den namngivna filen. Ändrat innehåll kräver ett nytt requestId; att försöka igen med oförändrad indata misslyckas igen.
Delvisa paketresultat: slutförda poster förblir publicerade. En rättad förfrågan ska bara innehålla det arbete som inte är klart.
send_feedback har ingen nyckel för nya försök. Efter ett oklart fel ska du inte skicka igen automatiskt: det första meddelandet kan ha kommit fram.

Vanliga fel

Kod	Vad du ska göra
`advanced_upload_required`	Spelet använder SDK:t, en server, separata filer eller fält som bara finns för paket. Behåll de funktionerna och ladda upp ett paket med ett nytt `requestId`.
`invalid_html_file`	HTML-filen är tom eller större än 10 MiB. Använd ett paket för större spel.
`visibility_required`	En app i ett paket saknar synlighet. Ange `visibility` i förfrågan eller i appen: `public`, `unlisted` eller `private`.
`invalid_visibility`	Använd `public`, `unlisted` eller `private`.
`visibility_conflict`	Förfrågan och posten för en app begär olika synlighet. Ange en, så att publiken aldrig ändras i tysthet.
`expected_current_version_required`	Lägg till varje apps namn i `expectedCurrentVersion`: `null` för ett nytt spel, annars den aktuella versionen från `list_games`.
`current_version_changed`	Någon har publicerat en nyare version. Anropa `list_games`, bekräfta målet med din användare och ladda sedan upp med den aktuella versionen och ett nytt `requestId`.
`game_exists_use_id`, `game_not_found`	Anropa `list_games`, använd rätt `gameId` eller namn och behåll spelets befintliga namn.
`request_id_content_conflict`	Det här `requestId` hör redan till annat innehåll. Använd ett nytt ID eller skicka det ursprungliga innehållet igen oförändrat.
`catalogue_file_missing_or_invalid`	En fil laddades inte upp eller dess byte stämmer inte. Anropa `prepare_catalogue_upload` igen med identisk indata och samma `requestId`, gör PUT på de saknade filerna och slutför sedan igen.
`catalogue_files_unclaimed`	Vissa filer används inte av någon katalogpost. Referera till dem, ge filer för spelsidan `role: "LISTING"` och `app`, eller ta bort dem.
`entry_point_missing`	`apps[].file` anger en fil som inte laddades upp. Utan `file` är startsidan som standard `<name>.html`.
`archive_catalogue_required`	Lägg catalogue.json i roten av ZIP-filen, inte i en mapp.
`archive_too_large`	Över 20 MiB komprimerat: packa upp och ladda upp mappen med signerade filer, vilket tillåter upp till 50 MiB per fil. Över 200 MiB uppackat: själva spelet är för stort för en version; komprimera eller ta bort assets.
`procedural_module_validation_unavailable`	Körbara procedurella 3D-modeller eller modeller i eget format kan inte laddas upp via MCP. Baka dem eller referera till en publicerad asset.
`upload_expired`, `upload_cancelled`	Förbered uppladdningen igen med ett nytt `requestId` och slutför den inom 30 minuter.
`invalid_token`, `insufficient_scope`	Anslut PlayDrop-kontot igen i din AI-app och tillåt publicering.

Fel i katalogfält, som en ogiltig tagg, deklaration av handkontroller eller spelarläge, hänvisar till referensen för catalogue.json.

Anslutning och bilagor

Utgången anslutning: en aktiv anslutning förnyas av sig själv medan den används. En anslutning som inte har använts på 30 dagar, eller en som gick ut före den här regeln, måste anslutas igen.
Avvisad bilaga: PlayDrop laddar bara ner filer från värdens egen bilagetjänst. Det är en begränsning för filvärdar, inte för länder. Skicka bilagan som värden har löst upp, eller ladda upp filerna med signerade URL:er. Hitta aldrig på en download_url eller ett file_id.