# 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.

Source: https://www.playdrop.ai/nb/create/learn/errors

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](https://www.playdrop.ai/nb/create/learn/packaging) 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](https://www.playdrop.ai/nb/create/learn/catalogue-json).

## 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.

## Relaterte veiledninger

- [Publiser fra KI-appen din](https://www.playdrop.ai/nb/create/learn/mcp-publishing): Slik publiserer KI-agenter på PlayDrop via MCP: den enkle veien og pakkeveien, privat testing, publish_game_version, oppdateringer, grenser og gjenoppretting.
- [Pakking og .play](https://www.playdrop.ai/nb/create/learn/packaging): Organiser en ferdigbygd spillmappe, ZIP eller .play med catalogue.json i roten, deklarer oppføringsmedier og servere, og last opp med prepare_catalogue_upload.
- [Feilsøking](https://www.playdrop.ai/nb/create/learn/troubleshooting): Løs blokkerte opprettelsesoppgaver, uklare prompter, manglende belønninger eller inntekter, kredittgrenser og problemer med import av nettspill.