Pelaa yhdessä

Saavutukset PlayDrop-peleihin

Määrittele tavalliset ja kasvavat saavutukset kuvakkeineen catalogue.json-tiedostossa, avaa ne ja raportoi edistyminen sdk.achievements-rajapinnalla.

Saavutukset merkitsevät pelisi tavoitteita kuvakkeella ja kuvauksella, jotka pelaajat näkevät PlayDropissa. Ne toimivat sekä vieraille että kirjautuneille pelaajille.

Määrittele saavutukset

json

{
  "achievements": [
    { "key": "first-win", "displayName": "First flag", "description": "Reach the flag once",
      "kind": "STANDARD", "icon": "achievements/first-win.png" },
    { "key": "collector", "displayName": "Collector", "description": "Collect 100 stars",
      "kind": "INCREMENTAL", "maxProgress": 100, "icon": "achievements/collector.png" },
    { "key": "secret-room", "displayName": "Secret room", "description": "Find the hidden room",
      "kind": "STANDARD", "hidden": true, "icon": "achievements/secret-room.png" }
  ]
}

key noudattaa samaa muotoa kuin tulostaulujen avaimet.
kind on STANDARD (avataan kerran) tai INCREMENTAL (avataan, kun edistyminen saavuttaa arvon maxProgress, joka on positiivinen kokonaisluku).
icon on paketissa oleva PNG-kuva. Käytä selkeää neliökuvaa, joka erottuu pienenäkin.
hidden: true pitää nimen ja kuvauksen salassa, kunnes saavutus avataan.

Julkaistuja avaimia ei voi poistaa, eikä arvoja kind, maxProgress ja hidden voi muuttaa. Poista saavutus käytöstä asetuksella "status": "RETIRED".

Avaa saavutuksia ja raportoi edistyminen

await sdk.achievements.unlock("first-win");
await sdk.achievements.setProgressAtLeast("collector", starsCollected);

const { achievements } = await sdk.achievements.list();
const { achievement } = await sdk.achievements.get("collector");

setProgressAtLeast ottaa tähänastisen kokonaismäärän, ei koskaan lisäystä. Edistyminen vain kasvaa, rajoittuu arvoon maxProgress ja avaa saavutuksen siinä kohdassa.
Molemmat kutsut palauttavat { accepted, changed, unlocked, progress, unlockedAt, achievement }; changed on false, kun mitään uutta ei tapahtunut, joten voit näyttää oman ilmoituksesi vain kerran.
list({ includeHiddenDefinitions: true, includeRetired: true }) sisältää myös piilotetut ja käytöstä poistetut määritelmät.

Avaa saavutuksia vain oikean pelaamisen aikana, ei koskaan esikatseluissa tai kaappauksissa. Ilman pelaajaistuntoa kutsut valmistuvat tallentumatta.

Hyvät saavutukset

Yhdistä alkuvaiheen saavutuksia, jotka opettavat pelin, pitkän aikavälin tavoitteisiin. Nimeä teko, älä palkintoa: ”Voita ottamatta vahinkoa” kertoo, mitä pitää tehdä. Tusina harkittua saavutusta voittaa sata vähäpätöistä.