Que fait Sprite Forge ?
Sprite Forge transforme du texte en assets 2D prêts pour le jeu sur le GPU de cette machine (ComfyUI en dessous ; il est démarré automatiquement). Rien n'est envoyé à un service payant. Chaque résultat est découpé avec un bord net, recadré, redimensionné, vérifié et sauvegardé avec un manifeste ; plusieurs prises sont réalisées et la meilleure est conservée.
Comment l'appeler
Privilégiez les outils MCP sprite-forge lorsqu'ils sont disponibles :
list_profiles, generate_sprite, create_character, animate_pixel, make_normal_map, get_job, check_image, models, forge_status.
Sinon, utilisez la ligne de commande depuis le dossier Sprite Forge ; chaque commande affiche un objet JSON :
python forge.py profiles
python forge.py sprite <nom> "<prompt>" -p sprite --project <dossier du jeu>
python forge.py sprite <nom> "<prompt>" -p pixel_sprite --set grid=32 --set palette=project --project <dossier du jeu>
python forge.py character <id> "<qui, tenue, couleurs, accessoires>" --project <dossier du jeu>
python forge.py sprite <nom> -p turnaround --character <id> --set directions=8 --project <dossier du jeu>
python forge.py sprite <nom> -p animation --character <id> --set action=walk --set facing=right --project <dossier du jeu>
python forge.py animate <nom> <sprite.png> "<le mouvement>" --pose "<image 1>" --pose "<image 2>" ...
python forge.py normal <sprite.png>
python forge.py check <fichier.png> --kind sprite
Code de sortie 0 = ok, 2 = terminé mais le résultat a échoué à sa vérification, 1 = erreur.
Choisir le profil
| Profil | Pour | Sortie |
|---|---|---|
sprite | objets, items, pickups, armes, meubles, éléments d'interface | PNG transparent, recadré, centré sur un canevas carré |
icon | icônes de compétences / objets, badges, boutons | PNG carré + versions 256/128/64 px |
pixel_sprite | vrai pixel art : personnages, objets, ennemis | vraie grille de pixels (ex. 32 px), alpha dur, palette limitée ou nommée, plus un aperçu x8 |
character | une référence de personnage réutilisable | PNG transparent corps entier, pieds sur la ligne de sol |
pixel_character | la même chose, dessinée en style pixel art | référence pour les feuilles pixel art |
turnaround | le personnage face à 4 ou 8 directions | images + <nom>_sheet.png + <nom>.atlas.json |
animation | marche, course, repos, attaque, saut, blessure, mort, incantation | images + feuille + atlas avec un tag d'animation |
tile | sol, murs, sols, eau, feuillage | texture carrée seamless + aperçu 3x3 tuilé (version pixel optionnelle) |
portrait | portraits de dialogue, cartes, illustrations | image pleine résolution |
vfx | explosions, fumée, éclats magiques, étincelles de coup | images + feuille + atlas ; la luminosité est la transparence |
animate_pixel (outil) | animer un sprite pixel EXISTANT à partir d'une description | images sur la grille et la palette propres du sprite + feuille + atlas + GIF |
Chaque feuille reçoit aussi <nom>.gif (en boucle) pour que l'utilisateur puisse la regarder.
Chacun a trois préréglages : fast (une prise rapide), standard (par défaut), max (modèle plus grand ou plus de prises ; Qwen-Image-Edit pour les turnarounds/animations). Dites quel préréglage vous avez utilisé.
Workflow
- Passez toujours le dossier du projet de jeu (
project_dir/--project). Son fichierspriteforge.jsonfournit le style, le dossier de sortie, le dossier des personnages et les paramètres par profil, garantissant ainsi la cohérence artistique d'un jeu. S'il n'en a pas, proposez d'en créer un (forge.py init <dossier>). - Écrivez le prompt comme indiqué dans le
prompt_guidedu profil (list_profilesle renvoie). Décrivez la chose, pas l'image : pas de "un sprite de", pas de fond, pas de mots de caméra dans le prompt – réglez l'angle avecparams.view(front view,side view,top-down view,isometric view). - Personnages qui apparaissent plus d'une fois : créez-les d'abord.
create_character(ou le profilcharacteraveccharacterdéfini) sauvegarde une référence ; les turnarounds et les animations sont des éditions de celle-ci, donc le personnage conserve le même aspect. Pour les feuilles pixel art, utilisezprofile: "pixel_character"et passezparams.pixel_grid(ex. 32) à la feuille. - Les tâches longues sont asynchrones. Si un outil renvoie un identifiant de tâche, appelez
get_jobavecwait_seconds: 50jusqu'à ce que le statut ne soit plusqueuedourunning. Une tâche à la fois. - Regardez l'aperçu. Chaque résultat est accompagné d'une image d'aperçu (sprites sur un
damier). Vérifiez-le avant de considérer l'asset comme terminé : mauvais sujet, partie coupée,
second objet, halo, image qui n'est pas le même personnage. Signalez le fichier, sa taille,
les éventuels
problems, et mentionnez les autres prises dans.spriteforge/<nom>/.
Pixel art
- Les modèles d'image ne dessinent qu'un style pixel art ; Sprite Forge le rend réel : il trouve la
grille de pixels du modèle (ou force
grid), prend la couleur dominante de chaque cellule, supprime les pixels parasites, rend l'alpha totalement activé/désactivé et limite la palette. Ne prétendez jamais qu'un sprite est du pixel art sans cette étape. grid: le côté le plus long du sprite en pixels (16, 24, 32, 48, 64)."auto"conserve la taille de pixel que le modèle a dessinée.palette:pico8,gameboy,nes,endesga32,sweetie16, une liste de couleurs hexadécimales, ou"project"– une palette figée pour tout le jeu (sauvegardée souspalette.hexdans le projet par le premier asset pixel, réutilisée par tous les suivants). Utilisez"project"pour un jeu.outline: trueajoute un contour foncé de 1 pixel ;canvas: 32place le sprite sur une grille 32x32.- Aucun tramage n'est appliqué (il scintille dans l'animation).
Animer un sprite pixel existant
Utilisez animate_pixel lorsque l'utilisateur a déjà un sprite pixel (le sien, ou un créé avec
pixel_sprite) et décrit un mouvement : "fais rebondir le slime", "anime le chevalier qui brandit son épée".
Il conserve la taille de pixel exacte et la palette du sprite dans chaque image.
image: le PNG (taille native jusqu'à 256 px, ou une copie agrandie avec des pixels durs).description: le mouvement. walk / run / idle / attack / jump / hurt / death / cast utilisent des poses clés intégrées.- Écrivez les
posesvous-même pour tout le reste : une ligne courte par frame indiquant ce qui change, ex. pour un coup d'épée["levant l'épée haut au-dessus de sa tête", "l'épée au sommet, corps penché en arrière", "abaissant l'épée devant lui", "l'épée basse après le coup"]. 3-6 frames sont les plus lisibles. Ce sont des poses clés, pas des interpolations. params.include_original: trueplace le sprite non modifié en tant qu'image 0 ;params.fps.- Regardez le GIF / l'aperçu : si une frame a perdu une partie du sprite ou l'a modifié, relancez avec une
nouvelle
seedoupreset: "max"(plus de prises par image).
Normal maps (éclairage 2D)
Pour les jeux avec éclairage 2D (Godot CanvasTexture + Light2D, Unity 2D lights, Phaser
light2d), passez params.normal_map: true à sprite, icon, pixel_sprite, character,
turnaround, animation ou animate_pixel, ou appelez make_normal_map sur n'importe quel PNG existant.
- Écrit
<nom>_normal.png(ou<nom>_sheet_normal.png, même disposition que la feuille) et<nom>_lit_preview.png(le sprite éclairé par la gauche, le haut, la droite et le bas) – montrez l'aperçu à l'utilisateur. - Le pixel art conserve sa grille de pixels avec des normales nettes et ajustées.
- La convention par défaut est OpenGL (vert = haut), ce que Godot et Unity attendent ;
normal_y: "down"/y: "down"pour DirectX.normal_strength0.5 subtil – 2 fort. - Le relief est déduit du dessin (contour, zones de couleur, reflets), pas modélisé : il se lit bien sous des lumières en mouvement mais n'est pas un scan de profondeur réel.
Quand le résultat indique failed_check
Le fichier est écrit mais ne doit pas être utilisé tel quel. Les problems expliquent pourquoi.
| Problème | Correction |
|---|---|
cut off | Relancez avec une nouvelle seed ; ajoutez "petit, centré, avec de l'espace autour" ou augmentez params.padding. |
several objects | Nommez un seul objet ; relancez avec une nouvelle seed. |
background not removed / empty | Décrivez un objet solide ; gardez l'background simple ; relancez. |
may not look like the character (feuilles) | Relancez cette feuille avec une nouvelle seed ou preset: "max" ; gardez le prompt du personnage simple. |
may not have turned (turnaround) | Relancez avec preset: "max" (Qwen-Image-Edit suit mieux les changements de vue). |
no clear pixel grid found | L'image n'a pas été dessinée en pixel art : définissez grid à un nombre, ou relancez. |
visible seam (tuile) | Utilisez une surface organique ou augmentez params.blend ; relancez. |
much smaller than the original (animate_pixel) | Cette image a perdu une partie du sprite : relancez avec une nouvelle seed ou donnez une pose plus claire. |
flat: almost a single colour | Le modèle a dessiné une silhouette : relancez avec une nouvelle seed ; dites "en couleur complète". |
Même nom + mêmes paramètres renvoie le fichier existant ; modifiez un paramètre, la seed, ou passez
force: true pour en créer un nouveau.
Personnalisation
- Par projet :
spriteforge.json(style,style_preset,output_dir,characters_dir,profiles.<id>.params, ex.{"pixel_sprite": {"params": {"grid": 32, "palette": "project"}}}). - Par appel :
params, ex.{"size": 256, "candidates": 6, "view": "side view", "directions": 4, "action": "attack", "facing": "down"}.list_profilesliste chaque paramètre avec une explication. - Nouveau profil : un petit fichier JSON dans le dossier
spriteforge_profiles/du projet quiextendsun autre. - Modèles et matériel : l'outil
modelsindique ce dont chaque profil et préréglage a besoin et ce qui manque. Les téléchargements sont volumineux – demandez à l'utilisateur avant d'installer. - Licences : chaque modèle installé par Sprite Forge permet l'utilisation commerciale de ce que vous créez (FLUX.2 Klein 4B, Z-Image Turbo, Qwen-Image-Edit 2511 et le LoRA pixel : Apache 2.0 ; BiRefNet et CLIP : MIT). Certaines plateformes (ex. Steam, itch.io) demandent de divulguer les assets créés par IA.