Viitteet

PlayDropin MCP-latausvirheet ja niistä palautuminen

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

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

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.

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

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.