Een pet indienen

Voordat je begint

Alles gebeurt in de PicoPixel-app. Zo kom je bij het indieningsscherm:

1. Open de app op app.picopixel.io.
2. Log in als je dat nog niet bent; dat kan met Google of GitHub. Als je dit overslaat, word je gevraagd in te loggen voordat je kunt indienen.
3. Klik op je account onderaan de linkerzijbalk.
4. Kies "Your account".
5. Open "Submit Sprite".

Het Submit Sprite-scherm biedt de twee methoden die hieronder worden beschreven.

Indienen via Petdex

Dit is de aanbevolen en snelste methode. Petdex is een externe petdirectory op petdex.crafter.run waar je pets kunt bekijken, maken en hosten. Elke pet daar heeft een deelbare URL met de vorm https://petdex.crafter.run/pets/<pet-id>.

Zo dien je in:

1. Zoek of maak de pet op Petdex en kopieer de URL.
2. Kies op het Submit Sprite-scherm "Submit via Petdex".
3. Plak de pet-URL in het veld "Petdex URL".
4. Voeg eventueel een toelichting toe in het veld "Notes".
5. Verzend het.

Indienen via GitHub

Gebruik deze methode wanneer je de sprite zelf host. Je levert de ruwe bestanden aan in plaats van een Petdex-link.

1. Zet je spritesheet-afbeelding en een bijpassende sprite.json in een openbare GitHub-repository.
2. Kies op het Submit Sprite-scherm "Submit via GitHub".
3. Plak de repository-URL (https://github.com/...).
4. Vul "Credits / Author" in zodat je werk wordt toegeschreven.
5. Voeg eventueel een toelichting toe in het veld "Notes" en verzend daarna.

De spritesheet en sprite.json moeten een specifiek formaat volgen. Hieronder lees je hoe dat formaat is opgebouwd.

Je eigen unieke pet maken

In plaats van een uitgelichte Petdex-pet opnieuw te gebruiken, kun je een originele maken. AI-tools zoals OpenAI Codex of AI-afbeeldingsgeneratoren zijn een praktische manier om vanaf nul een spritesheet voor een personage te maken.

Een spritesheet is één afbeelding (PNG of WebP) met een regelmatig raster, ook wel een atlas genoemd. Plaats één animatie per rij en maak elk frame precies even groot.

Het bestand sprite.json beschrijft de spritesheet. Het heeft twee hoofdonderdelen:

• atlas, de rasterindeling: columns, rows, frameWidth en frameHeight.
• states, de lijst met animatietoestanden. Elke toestand heeft een id, een label, de row waarop hij staat, het aantal frames, een optionele durationMs, een group en een caption.

Veelgebruikte toestanden zijn idle, wave, jump, run-right, run-left, running, waiting, failed en review. Een sprite heeft minstens twee toestanden nodig, dus maak in elk geval idle plus één beweging.

Een goede workflow: genereer de frames op een consistente grootte, plaats ze in een regelmatig raster met één animatie per rij, beschrijf daarna het raster en de animatietoestanden in sprite.json en dien in via Petdex of GitHub.

Wat er daarna gebeurt

Nadat je hebt ingediend, beoordeelt het PicoPixel-team je pet en kan het contact opnemen als er iets verduidelijkt moet worden. Goedgekeurde pets verschijnen in de Pets-galerij, met jouw naam erbij. Vanaf daar kan iedereen in de community je creatie vinden en gebruiken.

Waar nu heen

• LVGL Sprites, hoe sprite-toestanden en frames werken.
• Event-editor, voeg interactiviteit toe aan je ontwerpen.
• Een sjabloon indienen, deel een PicoPixel-ontwerp waarmee anderen kunnen starten.
• Content melden, meld een pet of sjabloon dat de regels overtreedt.
• Pets-galerij, bekijk communitypets.