Referanse

Opplastingsfeil i PlayDrop MCP og hvordan du løser dem

Feilformatet PlayDrops MCP-verktøy returnerer, når du skal prøve igjen med samme requestId, og løsningen på hver vanlige feilkode.

Hver feil fra et PlayDrop MCP-verktøy beholder sin stabile error-kode og eventuelle detaljer som path, field, name eller expected, og legger til:

message: hva som gikk galt, med enkle ord.
retryable: true bare når det identiske kallet kan lykkes senere.
nextAction: den konkrete rettelsen.
docsUrl og documentationTopic: veiledningen du bør lese, også tilgjengelig med get_documentation.

Prøv igjen eller rett opp

Feil som kan prøves igjen (midlertidige feil, hastighetsgrenser, en avbrutt fullføring): prøv det identiske kallet igjen med samme requestId etter en kort pause. Ikke opprett en ny versjon.
Tapt svar: du kan ikke vite om det fungerte, så send identisk innhold igjen med samme requestId. PlayDrop returnerer det opprinnelige resultatet i stedet for å publisere to ganger.
Avvist inndata: rett først det navngitte feltet eller den navngitte filen. Endret innhold trenger en ny requestId; å prøve uendret inndata igjen feiler på nytt.
Delvise pakkeresultater: fullførte elementer forblir publisert. En rettet forespørsel skal bare inneholde arbeidet som ikke er ferdig.
send_feedback har ingen nøkkel for nye forsøk. Etter en uklar feil skal du ikke sende på nytt automatisk: den første meldingen kan ha kommet frem.

Vanlige feil

Kode	Hva du gjør
`advanced_upload_required`	Spillet bruker SDK-en, en server, separate filer eller felt som bare finnes i pakker. Behold disse funksjonene og last opp en pakke med en ny `requestId`.
`invalid_html_file`	HTML-en er tom eller større enn 10 MiB. Bruk en pakke for større spill.
`visibility_required`	En app i en pakke har ingen synlighet. Sett `visibility` i forespørselen eller på appen: `public`, `unlisted` eller `private`.
`invalid_visibility`	Bruk `public`, `unlisted` eller `private`.
`visibility_conflict`	Forespørselen og en appoppføring ber om ulik synlighet. Oppgi én, slik at publikummet aldri endres i det stille.
`expected_current_version_required`	Legg til navnet på hver app i `expectedCurrentVersion`: `null` for et nytt spill, ellers den nåværende versjonen fra `list_games`.
`current_version_changed`	Noen har publisert en nyere versjon. Kall `list_games`, bekreft målet med brukeren din, og last deretter opp med den nåværende versjonen og en ny `requestId`.
`game_exists_use_id`, `game_not_found`	Kall `list_games`, bruk riktig `gameId` eller navn, og behold spillets eksisterende navn.
`request_id_content_conflict`	Denne `requestId` tilhører allerede annet innhold. Bruk en ny ID, eller send det opprinnelige innholdet uendret på nytt.
`catalogue_file_missing_or_invalid`	En fil ble ikke lastet opp, eller bytene samsvarer ikke. Kall `prepare_catalogue_upload` igjen med identisk inndata og samme `requestId`, last opp de manglende filene med PUT, og fullfør deretter på nytt.
`catalogue_files_unclaimed`	Noen filer brukes ikke av noen katalogoppføring. Referer til dem, gi oppføringsfiler `role: "LISTING"` og `app`, eller fjern dem.
`entry_point_missing`	`apps[].file` navngir en fil som ikke ble lastet opp. Uten `file` er inngangssiden som standard `<name>.html`.
`archive_catalogue_required`	Legg catalogue.json i roten av ZIP-filen, ikke inne i en mappe.
`archive_too_large`	Over 20 MiB komprimert: pakk den ut og last opp mappen med signerte filer, som tillater opptil 50 MiB per fil. Over 200 MiB utpakket: selve spillet er for stort for én versjon; komprimer eller fjern ressurser.
`procedural_module_validation_unavailable`	Kjørbare prosedyriske 3D-modeller eller modeller i egendefinert format kan ikke lastes opp via MCP. Bak dem til faste modeller eller referer til en publisert ressurs.
`upload_expired`, `upload_cancelled`	Forbered opplastingen på nytt med en ny `requestId` og fullfør den innen 30 minutter.
`invalid_token`, `insufficient_scope`	Koble PlayDrop-kontoen til på nytt i KI-appen din og tillat publisering.

Feil i katalogfelt, som en ugyldig tagg, kontrollerdeklarasjon eller spillermodus, viser til catalogue.json-referansen.

Tilkobling og vedlegg

Utløpt tilkobling: en aktiv tilkobling fornyer seg selv mens den brukes. En tilkobling som ikke er brukt på 30 dager, eller som utløp før denne regelen, må kobles til på nytt.
Vedlegg avvist: PlayDrop laster bare ned filer fra vertsappens egen vedleggstjeneste. Dette er en begrensning på filverten, ikke en landsbegrensning. Send vedlegget slik vertsappen har løst det opp, eller last opp filene med signerte URL-er. Finn aldri på en download_url eller file_id.

Rapporter et problem

Hvis en feilmelding virker feil eller neste handling ikke fungerer, kaller du send_feedback én gang med verktøynavnet, feilkoden, hva du sendte (uten tokener eller signerte URL-er) og hva du forventet.

Prøv igjen eller rett opp

Feil som kan prøves igjen (midlertidige feil, hastighetsgrenser, en avbrutt fullføring): prøv det identiske kallet igjen med samme requestId etter en kort pause. Ikke opprett en ny versjon.
Tapt svar: du kan ikke vite om det fungerte, så send identisk innhold igjen med samme requestId. PlayDrop returnerer det opprinnelige resultatet i stedet for å publisere to ganger.
Avvist inndata: rett først det navngitte feltet eller den navngitte filen. Endret innhold trenger en ny requestId; å prøve uendret inndata igjen feiler på nytt.
Delvise pakkeresultater: fullførte elementer forblir publisert. En rettet forespørsel skal bare inneholde arbeidet som ikke er ferdig.
send_feedback har ingen nøkkel for nye forsøk. Etter en uklar feil skal du ikke sende på nytt automatisk: den første meldingen kan ha kommet frem.

Vanlige feil

Kode	Hva du gjør
`advanced_upload_required`	Spillet bruker SDK-en, en server, separate filer eller felt som bare finnes i pakker. Behold disse funksjonene og last opp en pakke med en ny `requestId`.
`invalid_html_file`	HTML-en er tom eller større enn 10 MiB. Bruk en pakke for større spill.
`visibility_required`	En app i en pakke har ingen synlighet. Sett `visibility` i forespørselen eller på appen: `public`, `unlisted` eller `private`.
`invalid_visibility`	Bruk `public`, `unlisted` eller `private`.
`visibility_conflict`	Forespørselen og en appoppføring ber om ulik synlighet. Oppgi én, slik at publikummet aldri endres i det stille.
`expected_current_version_required`	Legg til navnet på hver app i `expectedCurrentVersion`: `null` for et nytt spill, ellers den nåværende versjonen fra `list_games`.
`current_version_changed`	Noen har publisert en nyere versjon. Kall `list_games`, bekreft målet med brukeren din, og last deretter opp med den nåværende versjonen og en ny `requestId`.
`game_exists_use_id`, `game_not_found`	Kall `list_games`, bruk riktig `gameId` eller navn, og behold spillets eksisterende navn.
`request_id_content_conflict`	Denne `requestId` tilhører allerede annet innhold. Bruk en ny ID, eller send det opprinnelige innholdet uendret på nytt.
`catalogue_file_missing_or_invalid`	En fil ble ikke lastet opp, eller bytene samsvarer ikke. Kall `prepare_catalogue_upload` igjen med identisk inndata og samme `requestId`, last opp de manglende filene med PUT, og fullfør deretter på nytt.
`catalogue_files_unclaimed`	Noen filer brukes ikke av noen katalogoppføring. Referer til dem, gi oppføringsfiler `role: "LISTING"` og `app`, eller fjern dem.
`entry_point_missing`	`apps[].file` navngir en fil som ikke ble lastet opp. Uten `file` er inngangssiden som standard `<name>.html`.
`archive_catalogue_required`	Legg catalogue.json i roten av ZIP-filen, ikke inne i en mappe.
`archive_too_large`	Over 20 MiB komprimert: pakk den ut og last opp mappen med signerte filer, som tillater opptil 50 MiB per fil. Over 200 MiB utpakket: selve spillet er for stort for én versjon; komprimer eller fjern ressurser.
`procedural_module_validation_unavailable`	Kjørbare prosedyriske 3D-modeller eller modeller i egendefinert format kan ikke lastes opp via MCP. Bak dem til faste modeller eller referer til en publisert ressurs.
`upload_expired`, `upload_cancelled`	Forbered opplastingen på nytt med en ny `requestId` og fullfør den innen 30 minutter.
`invalid_token`, `insufficient_scope`	Koble PlayDrop-kontoen til på nytt i KI-appen din og tillat publisering.

Feil i katalogfelt, som en ugyldig tagg, kontrollerdeklarasjon eller spillermodus, viser til catalogue.json-referansen.

Tilkobling og vedlegg

Utløpt tilkobling: en aktiv tilkobling fornyer seg selv mens den brukes. En tilkobling som ikke er brukt på 30 dager, eller som utløp før denne regelen, må kobles til på nytt.
Vedlegg avvist: PlayDrop laster bare ned filer fra vertsappens egen vedleggstjeneste. Dette er en begrensning på filverten, ikke en landsbegrensning. Send vedlegget slik vertsappen har løst det opp, eller last opp filene med signerte URL-er. Finn aldri på en download_url eller file_id.