Comment soumettre un pet

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 "Votre compte".
5. Ouvrez "Soumettre un Sprite".

L'écran Soumettre un 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 pets sur petdex.crafter.run où vous pouvez parcourir, créer et héberger des pets. Chaque pet y dispose d'une URL partageable de la forme https://petdex.crafter.run/pets/<pet-id>.

Pour soumettre :

1. Trouvez ou créez le pet sur Petdex et copiez son URL.
2. Sur l'écran Soumettre un Sprite, choisissez "Soumettre via Petdex".
3. Collez l'URL du pet 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 Soumettre un Sprite, choisissez "Soumettre via GitHub".
3. Collez l'URL du dépôt (https://github.com/...).
4. Remplissez "Crédits / Auteur" 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 pet unique

Plutôt que de réutiliser un pet Petdex mis en avant, vous pouvez en créer un original. Des outils IA comme OpenAI Codex ou des générateurs d'images IA sont un moyen pratique de produire une feuille de sprites de personnage from scratch.

Une feuille de sprites est une seule image (PNG ou WebP) organisée en une grille uniforme, un "atlas". Disposez-la avec une animation par ligne, et gardez chaque frame de taille identique.

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.

Un bon flux de travail : générez les frames à une taille cohérente, disposez-les sur une grille régulière avec une animation par ligne, puis décrivez la grille et les états dans sprite.json et soumettez via Petdex ou GitHub.

Ce qui se passe ensuite

Une fois que vous soumettez, l'équipe PicoPixel examine votre pet et peut vous contacter si quelque chose nécessite une clarification. Les pets approuvés apparaissent dans la galerie de Pets, avec votre crédit. De là, n'importe qui dans la communauté peut trouver et utiliser votre création.

Où aller ensuite

• LVGL Sprites : comment fonctionnent les états et les frames 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 un pet ou un modèle qui enfreint les règles.
• Galerie de Pets : parcourez les pets de la communauté.