CommunityImagegithub.com

Sprite Forge

Générez localement et gratuitement des assets 2D pour vos jeux : sprites, objets, icônes, éléments d'interface avec fond transparent, pixel art authentique (grille réelle, palette limitée), personnages avec vues à 4/8 directions et feuilles d'animation (marche, course, repos, attaque...), animation d'un sprite pixel existant à partir d'une description, normal maps pour éclairage 2D, tuiles seamless, portraits et images d'effets spéciaux – le tout au format PNG, GIF et atlas JSON prêts pour le jeu. Utilisez-le dès que l'utilisateur demande de créer, générer, régénérer, animer ou corriger un sprite, un asset 2D, du pixel art, une icône, une feuille de sprites, une feuille de personnage, un cycle de marche, une tuile ou texture, un portrait, une animation d'effet ou une normal map, ou de vérifier un PNG.

Qu'est-ce que Sprite Forge ?

Sprite Forge est un outil de génération d'assets 2D pour jeux vidéo, fonctionnant entièrement en local sur le GPU de la machine via ComfyUI. Il permet de créer des sprites, du pixel art authentique, des personnages avec turnarounds et animations, des tuiles seamless, des portraits, des effets visuels et des normal maps, le tout sans frais ni envoi de données à des services payants. L'outil propose à la fois des outils MCP (list_profiles, generate_sprite, create_character, animate_pixel, make_normal_map, get_job, check_image, models, forge_status) et une interface en ligne de commande. Il assure une qualité professionnelle : chaque résultat est découpé avec des bords nets, recadré, redimensionné, vérifié et accompagné d'un manifeste. Le pixel art est traité de manière rigoureuse : détection de la grille, réduction de la palette, alpha opaque et suppression des pixels parasites. Le système prend en charge les projets de jeu via un fichier spriteforge.json qui centralise le style, les dossiers de sortie et les paramètres par profil, garantissant une cohérence artistique sur l'ensemble du projet.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Noamcelermajer/comfyui-text-to-sprite-mcp/tree/main/skills/sprite-forge

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

ProfilPourSortie
spriteobjets, items, pickups, armes, meubles, éléments d'interfacePNG transparent, recadré, centré sur un canevas carré
iconicônes de compétences / objets, badges, boutonsPNG carré + versions 256/128/64 px
pixel_spritevrai pixel art : personnages, objets, ennemisvraie grille de pixels (ex. 32 px), alpha dur, palette limitée ou nommée, plus un aperçu x8
characterune référence de personnage réutilisablePNG transparent corps entier, pieds sur la ligne de sol
pixel_characterla même chose, dessinée en style pixel artréférence pour les feuilles pixel art
turnaroundle personnage face à 4 ou 8 directionsimages + <nom>_sheet.png + <nom>.atlas.json
animationmarche, course, repos, attaque, saut, blessure, mort, incantationimages + feuille + atlas avec un tag d'animation
tilesol, murs, sols, eau, feuillagetexture carrée seamless + aperçu 3x3 tuilé (version pixel optionnelle)
portraitportraits de dialogue, cartes, illustrationsimage pleine résolution
vfxexplosions, fumée, éclats magiques, étincelles de coupimages + feuille + atlas ; la luminosité est la transparence
animate_pixel (outil)animer un sprite pixel EXISTANT à partir d'une descriptionimages 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

  1. Passez toujours le dossier du projet de jeu (project_dir / --project). Son fichier spriteforge.json fournit 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>).
  2. Écrivez le prompt comme indiqué dans le prompt_guide du profil (list_profiles le 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 avec params.view (front view, side view, top-down view, isometric view).
  3. Personnages qui apparaissent plus d'une fois : créez-les d'abord. create_character (ou le profil character avec character dé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, utilisez profile: "pixel_character" et passez params.pixel_grid (ex. 32) à la feuille.
  4. Les tâches longues sont asynchrones. Si un outil renvoie un identifiant de tâche, appelez get_job avec wait_seconds: 50 jusqu'à ce que le statut ne soit plus queued ou running. Une tâche à la fois.
  5. 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 sous palette.hex dans le projet par le premier asset pixel, réutilisée par tous les suivants). Utilisez "project" pour un jeu.
  • outline: true ajoute un contour foncé de 1 pixel ; canvas: 32 place 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 poses vous-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: true place 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 seed ou preset: "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_strength 0.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èmeCorrection
cut offRelancez avec une nouvelle seed ; ajoutez "petit, centré, avec de l'espace autour" ou augmentez params.padding.
several objectsNommez un seul objet ; relancez avec une nouvelle seed.
background not removed / emptyDé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 foundL'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 colourLe 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_profiles liste chaque paramètre avec une explication.
  • Nouveau profil : un petit fichier JSON dans le dossier spriteforge_profiles/ du projet qui extends un autre.
  • Modèles et matériel : l'outil models indique 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.

Skills associés