Comment proposer une mascotte

Avant de commencer

Tout se passe dans l'application PicoPixel. Pour accéder à l'écran de soumission :

1. Ouvrez l'application sur app.picopixel.io.
2. Connectez-vous si ce n'est pas déjà fait ; la connexion se fait via OAuth avec Google ou GitHub. Si vous ignorez cette étape, vous serez invité à le faire avant de pouvoir soumettre.
3. Cliquez sur votre compte en bas de la barre latérale gauche.
4. Choisissez "Your account".
5. Ouvrez "Submit a Sprite".

L'écran Submit a Sprite propose les deux méthodes décrites ci-dessous.

Soumettre via Petdex

C'est la méthode recommandée et la plus rapide. Petdex est un répertoire externe de mascottes sur petdex.crafter.run où vous pouvez parcourir, créer et héberger des mascottes. Chaque mascotte y dispose d'une URL partageable de la forme https://petdex.crafter.run/pets/<pet-id>.

Pour soumettre :

1. Trouvez ou créez la mascotte sur Petdex et copiez son URL.
2. Sur l'écran Submit a Sprite, choisissez "Submit via Petdex".
3. Collez l'URL de la mascotte dans le champ "Petdex URL".
4. Ajoutez ce qui peut être utile dans le champ optionnel "Notes".
5. Envoyez.

Soumettre via GitHub

Utilisez cette méthode lorsque vous hébergez vous-même le sprite. Vous fournirez les fichiers bruts plutôt qu'un lien Petdex.

1. Placez votre image de feuille de sprites et un sprite.json correspondant dans un dépôt GitHub public.
2. Sur l'écran Submit a Sprite, choisissez "Submit via GitHub".
3. Collez l'URL du dépôt (https://github.com/...).
4. Remplissez "Credits / Author" pour que votre travail soit attribué.
5. Ajoutez ce qui est utile dans le champ optionnel "Notes", puis envoyez.

La feuille de sprites et le sprite.json doivent suivre un format spécifique. La section suivante l'explique.

Créer votre propre mascotte

Vous pouvez aussi créer votre propre personnage. Des outils comme OpenAI Codex ou un générateur d’images IA peuvent vous aider à produire une feuille de sprites originale.

Une feuille de sprites est une image PNG ou WebP découpée en grille régulière, aussi appelée atlas. Placez une animation par ligne et donnez les mêmes dimensions à toutes les images.

Un sprite.json décrit la feuille. Il a deux parties principales :

• atlas : la disposition de la grille : columns, rows, frameWidth et frameHeight.
• states : un tableau d'animations. Chaque état a un id, un label, la row sur laquelle il se trouve, le nombre de frames, un durationMs optionnel, un group et une caption.

Les états typiques incluent idle, wave, jump, run-right, run-left, running, waiting, failed et review. Un sprite a besoin d'au moins deux états, alors générez les plus courants, au minimum idle plus un mouvement.

Commencez par créer des images de même taille, puis disposez-les dans une grille, avec une animation par ligne. Décrivez ensuite la grille et les états dans sprite.json, puis envoyez votre proposition via Petdex ou GitHub.

Ce qui se passe ensuite

L’équipe PicoPixel examine votre proposition et peut vous demander des précisions. Les mascottes acceptées apparaissent dans la galerie de mascottes avec le nom de leur auteur. Toute la communauté peut ensuite les découvrir et les utiliser.

Où aller ensuite

• LVGL Sprites : comment fonctionnent les états et les images des sprites.
• Éditeur d'événements : ajoutez de l'interactivité à vos designs.
• Soumettre un modèle : partagez un design PicoPixel dont les autres peuvent se servir comme point de départ.
• Signaler du contenu : signalez une mascotte ou un modèle qui enfreint les règles.
• Galerie de mascottes : parcourez les mascottes de la communauté.