# PlayDropin MCP-latausvirheet ja niistä palautuminen

PlayDropin MCP-työkalujen palauttama virhemuoto, milloin yrittää uudelleen samalla requestId-arvolla ja korjaus kuhunkin yleiseen virhekoodiin.

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

Jokainen PlayDropin MCP-työkalun virhe säilyttää pysyvän `error`-koodinsa ja mahdolliset lisätiedot, kuten `path`, `field`, `name` tai `expected`, ja lisää:

- `message`: mikä meni pieleen, selkokielellä.
- `retryable`: `true` vain, kun täsmälleen sama kutsu voi onnistua myöhemmin.
- `nextAction`: konkreettinen korjaus.
- `docsUrl` ja `documentationTopic`: luettava opas, joka on saatavilla myös kutsulla `get_documentation`.

## Yritä uudelleen tai korjaa

- **Uudelleen yritettävät virheet** (tilapäiset häiriöt, nopeusrajoitukset, keskeytynyt viimeistely): yritä täsmälleen samaa kutsua samalla `requestId`-arvolla lyhyen odotuksen jälkeen. Älä luo uutta versiota.
- **Kadonnut vastaus:** et voi tietää, onnistuiko kutsu, joten yritä samaa sisältöä uudelleen samalla `requestId`-arvolla. PlayDrop palauttaa alkuperäisen tuloksen sen sijaan, että julkaisisi kahdesti.
- **Hylätty syöte:** korjaa ensin nimetty kenttä tai tiedosto. Muuttunut sisältö tarvitsee uuden `requestId`-arvon; muuttamattoman syötteen uudelleenyritys epäonnistuu taas.
- **Paketin osittaiset tulokset:** valmistuneet kohteet pysyvät julkaistuina. Korjatun pyynnön tulee sisältää vain keskeneräinen työ.
- **`send_feedback`**-työkalulla ei ole uudelleenyritysavainta. Epäselvän epäonnistumisen jälkeen älä lähetä automaattisesti uudelleen: ensimmäinen viesti on voinut mennä perille.

## Yleiset virheet

| Koodi | Mitä tehdä |
|---|---|
| `advanced_upload_required` | Peli käyttää SDK:ta, palvelinta, erillisiä tiedostoja tai vain paketeissa sallittuja kenttiä. Säilytä nämä ominaisuudet ja lataa [paketti](https://www.playdrop.ai/fi/create/learn/packaging) uudella `requestId`-arvolla. |
| `invalid_html_file` | HTML on tyhjä tai suurempi kuin 10 MiB. Käytä pakettia suuremmille peleille. |
| `visibility_required` | Paketin sovelluksella ei ole näkyvyyttä. Aseta `visibility` pyyntöön tai sovellukseen: `public`, `unlisted` tai `private`. |
| `invalid_visibility` | Käytä arvoa `public`, `unlisted` tai `private`. |
| `visibility_conflict` | Pyyntö ja sovellusmerkintä pyytävät eri näkyvyyksiä. Anna vain yksi, jotta yleisöä ei koskaan muuteta huomaamatta. |
| `expected_current_version_required` | Lisää jokaisen sovelluksen nimi kenttään `expectedCurrentVersion`: `null` uudelle pelille, muuten nykyinen versio `list_games`-kutsusta. |
| `current_version_changed` | Joku julkaisi uudemman version. Kutsu `list_games`, vahvista kohde ihmisesi kanssa ja lataa sitten nykyisellä versiolla ja uudella `requestId`-arvolla. |
| `game_exists_use_id`, `game_not_found` | Kutsu `list_games`, käytä oikeaa `gameId`-arvoa tai nimeä ja säilytä pelin nykyinen nimi. |
| `request_id_content_conflict` | Tämä `requestId` kuuluu jo eri sisällölle. Käytä uutta tunnistetta tai lähetä alkuperäinen sisältö uudelleen muuttamattomana. |
| `catalogue_file_missing_or_invalid` | Tiedostoa ei ladattu tai sen tavut eivät täsmää. Kutsu `prepare_catalogue_upload` uudelleen samalla syötteellä ja samalla `requestId`-arvolla, lähetä puuttuvat tiedostot PUT-pyynnöillä ja viimeistele sitten uudelleen. |
| `catalogue_files_unclaimed` | Jotkin tiedostot eivät ole minkään katalogimerkinnän käytössä. Viittaa niihin, anna pelisivun tiedostoille `role: "LISTING"` ja `app` tai poista ne. |
| `entry_point_missing` | `apps[].file` nimeää tiedoston, jota ei ladattu. Ilman `file`-kenttää aloitussivu on oletuksena `<name>.html`. |
| `archive_catalogue_required` | Laita catalogue.json ZIP-tiedoston juureen, ei kansion sisään. |
| `archive_too_large` | Yli 20 MiB pakattuna: pura se ja lataa kansio allekirjoitetuilla tiedostoilla, mikä sallii enintään 50 MiB tiedostoa kohden. Yli 200 MiB purettuna: peli itsessään on liian suuri yhdeksi versioksi; pakkaa tai poista resursseja. |
| `procedural_module_validation_unavailable` | Suoritettavia proseduraalisia 3D-malleja tai mukautetun muodon malleja ei voi ladata MCP:n kautta. Leivo ne valmiiksi tai viittaa julkaistuun resurssiin. |
| `upload_expired`, `upload_cancelled` | Valmistele lataus uudelleen uudella `requestId`-arvolla ja viimeistele se 30 minuutin kuluessa. |
| `invalid_token`, `insufficient_scope` | Yhdistä PlayDrop-tili uudelleen tekoälysovelluksessasi ja salli julkaiseminen. |

Katalogin kenttävirheet, kuten virheellinen tagi, ohjainilmoitus tai pelaajatila, ohjaavat [catalogue.json-viitteeseen](https://www.playdrop.ai/fi/create/learn/catalogue-json).

## Yhteys ja liitteet

- **Vanhentunut yhteys:** aktiivinen yhteys uusiutuu itsestään käytön aikana. Yhteys, jota ei ole käytetty 30 päivään, tai yhteys, joka vanheni ennen tätä sääntöä, on yhdistettävä uudelleen.
- **Liite hylätty:** PlayDrop lataa tiedostoja vain isännän omasta liitepalvelusta. Tämä on tiedostoisännän rajoitus, ei maarajoitus. Anna isännän selvittämä liite tai lataa tiedostot allekirjoitetuilla URL-osoitteilla. Älä koskaan keksi `download_url`- tai `file_id`-arvoa.

## Ilmoita ongelmasta

Jos virhe näyttää väärältä tai seuraava toimenpide ei toimi, kutsu `send_feedback` kerran ja kerro työkalun nimi, virhekoodi, mitä lähetit (ilman käyttöoikeustunnuksia tai allekirjoitettuja URL-osoitteita) ja mitä odotit.

## Liittyvät oppaat

- [Julkaise tekoälysovelluksesta](https://www.playdrop.ai/fi/create/learn/mcp-publishing): Miten tekoälyagentit julkaisevat PlayDropiin MCP:llä: yksinkertainen tapa ja paketti, yksityinen testaus, publish_game_version, päivitykset, rajat ja virheet.
- [Paketointi ja .play](https://www.playdrop.ai/fi/create/learn/packaging): Järjestä pelikansio, ZIP tai .play niin, että catalogue.json on juuressa, ilmoita pelisivun media ja palvelimet ja lataa prepare_catalogue_upload-kutsulla.
- [Vianmääritys](https://www.playdrop.ai/fi/create/learn/troubleshooting): Ratkaise estyneet luontityöt, epäselvät kehotteet, puuttuvat palkinnot tai tulot, krediittirajat ja verkkopelin tuontiongelmat.