sprite-stacking est un skill open source pour agents, écrit par Daniel White, qui transforme quatre vues en pixel art d'un objet (dessus, côté, avant et arrière) en « sprite stack » : une bande de tranches plates que le jeu dessine les unes sur les autres pour simuler un objet 3D que l'on peut faire tourner. Il fonctionne avec Claude Code, Codex, Cursor, OpenCode, Gemini CLI et Pi. Le dépôt a été créé le 20 novembre 2026 et comptait 187 étoiles lors de notre vérification, le 21 novembre 2026. Il est sous licence MIT.
Ce guide explique ce qu'est le sprite stacking, ce que le skill apporte, comment l'installer, ce qu'il faut lui fournir et où il montre ses limites. Toutes les commandes ci-dessous sont reprises du README du dépôt ou de son SKILL.md. Nous avons lu les fichiers le 21 novembre 2026 sans exécuter le skill nous-mêmes : les résultats décrits sont ceux que la documentation annonce.
Qu'est-ce que le sprite stacking
Un sprite stack, c'est un objet vu de dessus et découpé en couches horizontales, comme un pain tranché du sol vers le haut. Le jeu dessine les couches de bas en haut. Chacune est tournée du même angle, écrasée verticalement selon l'inclinaison de la caméra et remontée d'un pixel par rapport à la précédente. Le résultat ressemble à un petit modèle en voxels qui tourne en douceur, mais il s'agit toujours de simple dessin 2D : pas de moteur 3D, pas de maillage, et chaque angle reste en pixels nets.
Le README est clair, la technique n'est pas nouvelle : « Sprite stacking is a long-standing indie game technique, not invented here. » Ce que le skill ajoute, c'est la sculpture à partir de quatre vues et un flux de travail pensé pour les agents.
La difficulté habituelle, c'est de dessiner les tranches. Une voiture de 30 tranches, ce sont 30 petites images qui doivent s'aligner. Le skill évite cette étape : vous (ou votre agent) dessinez quatre vues ordinaires, et un script en tire les tranches.
Ce que fait le skill
Le README décrit quatre étapes :
- Vues : une planche avec les vues de dessus, de côté, de face et de dos, orthographiques, sur une seule rangée.
- Sculpture : un voxel n'est conservé que là où les quatre vues le recouvrent.
- Tranches : le volume sculpté est découpé en une bande de couches plates, la couche du sol en premier.
- Rendu : chaque couche est tournée, écrasée selon l'inclinaison et remontée d'1 px.
Le dossier du skill contient :
SKILL.md, les instructions que lit votre agent : comment obtenir une bonne planche à quatre vues, une liste de contrôle avant découpe, les options du découpeur, la boucle de rendu et ses valeurs, une liste « terminé quand » et un tableau des erreurs passées avec leurs correctifs.scripts/views_to_slices.py, le découpeur. Il supprime le fond, retire le contour d'1 px de chaque vue, ramène tout à une palette commune, sculpte les tranches et peut produire une image de contrôle et une page de visualisation autonome.scripts/viewer.html, une visionneuse dans le navigateur qui s'ouvre aussi seule et accepte les bandes de tranches glissées-déposées.references/engines.md, de courtes recettes pour Canvas web et React, Godot 4, Unity, et Phaser, Pygame ou autre.
Installation dans Claude Code ou Codex
L'installation en une ligne du README passe par la CLI skills, qui demande Node 22.20 ou plus récent :
npx skills add danielwh2/sprite-stacking
Cela installe le skill dans le projet courant. D'après le README, ajoutez -g pour l'installer dans tous vos projets et -a claude-code (ou codex, cursor, etc.) pour choisir l'agent.
Autre option : copier le dossier skills/sprite-stacking du dépôt dans le dossier de skills de votre agent :
| Agent | Dossier |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex, Cursor, OpenCode, Gemini CLI, Pi | ~/.agents/skills/ |
Le découpeur est un script Python : il vous faut donc aussi Python 3 avec Pillow et NumPy. La commande du README :
pip install pillow numpy
Utilisation : quoi demander à votre agent
Inutile d'appeler le skill par son nom. Une fois installé, demandez ce que vous voulez et l'agent s'en sert. Les exemples du README (traduits) :
- « Fais une voiture en pixel art qu'on peut faire tourner. »
- « Fais un sprite stack de cette planche à 4 vues et donne-moi une vue tournante. »
- « Ajoute un arbre en pixel art faux 3D à mon jeu Godot. »
SKILL.md demande à l'agent de choisir un chemin selon ce que vous lui donnez :
- Un PNG de bande de tranches ou un export de couches MagicaVoxel : il passe directement au rendu.
- Une planche à quatre vues : il la vérifie, puis la sculpte.
- Seulement un prompt ou une idée : il crée d'abord la planche à quatre vues, puis sculpte et fait le rendu.
Sans planche, l'agent utilise un outil de génération d'images s'il en a un, avec un prompt fourni tel quel dans SKILL.md. Sinon, il dessine lui-même les quatre vues en pixel art dans un court script Python. Le README le dit simplement : « No image generator? The agent draws the views itself in a short Python script. »
Dans un jeu existant, SKILL.md demande à l'agent de lire d'abord votre moteur de rendu (moteur, échelle des pixels, façon dont les sprites sont dessinés et triés) et d'y intégrer le stack, sans jamais ajouter un second canvas ni un autre pipeline de rendu.
Les entrées attendues
La planche à quatre vues obéit à des règles strictes, et la plupart des mauvais résultats viennent de leur non-respect. D'après SKILL.md :
- Une rangée dans l'ordre TOP, SIDE, FRONT, BACK (dessus, côté, face, dos), sur un blanc uni, avec des espaces nets entre les vues.
- TOP regarde droit vers le bas, l'avant de l'objet pointant vers le bas. Sur SIDE, l'avant pointe vers la gauche.
- Strictement orthographique : pas de perspective, pas d'inclinaison, pas de vue de trois quarts.
- La même échelle dans les quatre vues : la longueur de TOP égale celle de SIDE, la largeur de TOP égale celle de FRONT et BACK, la hauteur de SIDE égale celle de FRONT et BACK.
- Des aplats de couleur et des contours nets. Les bords flous façon aérographe et les fines lignes internes d'1 px bavent une fois les tranches tournées, et le skill conseille de redessiner plutôt que de rattraper.
Il propose aussi trois gabarits :
- Rétro massif : 15 à 20 tranches, environ 25×48 px, affiché à 8 à 10×.
- Hi-bit détaillé : 26 à 44 tranches, de 36×72 à 46×107 px, assez pour des grilles d'aération, des logos et des jantes à rayons.
- Vitrine / vidéo 1080p : 36 à 56 tranches, de 30×30 à 148×148 px, affiché à 4 à 6×.
Lancer le découpeur soi-même
C'est en général l'agent qui lance le découpeur, mais vous pouvez l'exécuter depuis la racine du dépôt avec la commande du README :
python3 skills/sprite-stacking/scripts/views_to_slices.py views.png slices.png \
--slices 36 --preview check.png --html viewer.html
views.png est votre planche à quatre vues et slices.png la bande de tranches produite. Les options listées dans le README :
--slices N: nombre de couches. 15 à 20 pour un rendu massif, 32 à 48 pour un rendu détaillé.--order reading: impose l'ordre TOP, SIDE, FRONT, BACK. Par défaut, le script associe les vues selon leurs proportions.--round: sculpte les tours, ballons et pots en rond plutôt qu'en carré.--side-nose right: à utiliser quand la vue SIDE regarde vers la droite.--colours N: taille de la palette commune ;0garde toutes les couleurs.--normals path.png: enregistre aussi une bande de tranches en normal map.--emissive path.png: enregistre aussi un masque de lumière détecté automatiquement (phares, fenêtres, néons).
SKILL.md en liste quelques autres, dont --top-nose (passez down pour tout ce qui n'est pas un véhicule), --shade, --bg-tol et --dark-thresh.
check.png montre les quatre vues extraites, quatre angles de rotation et une vue éclatée. Le skill demande à l'agent de la regarder avant d'écrire la moindre ligne de code du jeu.
La visionneuse
--html produit une page autonome. D'après le README, elle propose une vue tournante, un mode Scene avec des décors procéduraux, un balayage tranche par tranche, une vue éclatée et un mode Play où l'on conduit avec WASD ou les flèches. On y trouve aussi l'heure de la journée, un soleil déplaçable avec ombres, la pluie et la neige, et un bouton d'export qui génère une planche de sprites PNG en 16 directions. Pratique si votre moteur attend simplement des sprites directionnels classiques.
L'intégrer dans un jeu
La boucle de rendu est partout la même : pour chaque tranche, du sol vers le haut, la faire tourner autour de son centre, multiplier y par le facteur d'écrasement, la remonter de son indice multiplié par l'espacement, l'aligner sur des pixels entiers et la dessiner en filtrage nearest-neighbour. SKILL.md donne les valeurs par défaut : espacement 1.0 et écrasement 0.75 pour une caméra vue de dessus inclinée (1.0 regarde droit vers le bas). references/engines.md fournit une fonction Canvas 2D prête à l'emploi et un script Node2D pour Godot 4, plus des notes pour Unity (un SpriteRenderer par tranche, filtre Point) et pour Phaser ou Pygame.
Deux conseils du skill comptent pour les performances et le rendu. Triez des stacks entiers selon leur point au sol et n'entrelacez jamais les tranches de deux objets. Et transformez les stacks statiques en sprites ordinaires au chargement : le skill rappelle que 200 arbres de 30 tranches chacun représenteraient 6 000 appels de dessin par image.
Limites
Elles viennent de la liste de contrôle du skill et de son tableau d'erreurs passées :
- Les creux cachés se remplissent. La sculpture ne garde que ce que recouvrent les quatre silhouettes : une benne de pick-up ou une arche creuse qu'aucune vue ne montre ressort pleine. Les porte-à-faux qui laissent voir le fond sur la vue de côté, comme un aileron arrière surélevé, sont conservés. Les creux se corrigent à la main après la sculpture.
- Les parties rondes sortent carrées, sauf si la vue de dessus contient un cercle en pixels, ou si vous passez
--roundquand la partie ronde est plus étroite que sa base. - Les éléments d'1 px clignotent pendant la rotation. Poteaux, cordes et antennes doivent faire au moins 2 px de large ; le découpeur affiche un avertissement.
- Les saillies deviennent des corniches. Un élément qui dépasse d'un mur, comme une jardinière ou une enseigne, sculpte une corniche sur toute la longueur du mur. Peignez les petits éléments à plat.
- Les espaces fermés deviennent pleins. Un fond entièrement enclos dans une vue (entre des pattes, des ailerons ou des cordes) est traité comme une partie de l'objet. Chaque espace doit rejoindre l'extérieur de sa vue.
- Les objets décentrés oscillent. Le stack tourne autour du milieu de sa boîte englobante : centrez l'objet dans ses vues.
- Pixel art uniquement. La technique et le découpeur visent de petits sprites en aplats. Ce n'est pas un moyen d'obtenir un vrai modèle 3D pour un jeu 3D en three.js ou Unity.
Licence
Le dépôt est sous licence MIT (copyright 2026 Daniel White), comme l'indiquent GitHub et son fichier LICENSE. Vous pouvez l'utiliser, le modifier et l'intégrer dans des projets commerciaux, à condition de conserver la mention de copyright et de licence avec les copies du code. Le README ne dit rien de la licence des sprites que vous créez avec.
FAQ
Qu'est-ce que le sprite stacking ?
Une façon de simuler la 3D dans un jeu 2D. L'objet est stocké sous forme d'une bande de tranches plates vues de dessus, que le jeu dessine de bas en haut, chacune tournée du même angle et remontée d'un pixel. On dirait un petit modèle en voxels qui tourne, tout en restant du pixel art net.
Le skill sprite-stacking est-il gratuit ?
Oui. Il est open source sous licence MIT. Il vous faut seulement Python 3 avec Pillow et NumPy, et Node 22.20 ou plus récent si vous l'installez avec npx skills. L'abonnement ou l'usage d'API de votre agent IA est à part.
Fonctionne-t-il avec Claude Code et Codex ?
Oui, les deux figurent dans le README. Installez-le avec npx skills add danielwh2/sprite-stacking (avec -a claude-code ou -a codex pour choisir l'agent), ou copiez skills/sprite-stacking dans ~/.claude/skills/ pour Claude Code ou ~/.agents/skills/ pour Codex.
Faut-il un générateur d'images ?
Non. Si votre agent en a un, le skill lui fournit un prompt pour la planche à quatre vues. Sinon, l'agent dessine lui-même les vues dans un court script Python. Vous pouvez aussi lui donner une planche dessinée par vous, une bande de tranches ou un export de couches MagicaVoxel.
Peut-on utiliser le résultat dans Godot, Unity ou Phaser ?
Oui. references/engines.md contient un script Godot 4, des notes pour Unity, une fonction Canvas 2D pour le web et React, et la boucle générale pour Phaser et Pygame. La visionneuse exporte aussi une planche de sprites PNG en 16 directions pour les moteurs qui préfèrent des sprites classiques.
Pourquoi certaines parties de mon sprite sortent pleines ou carrées ?
Le découpeur ne garde un voxel que là où les quatre vues le recouvrent. Les creux invisibles sur toutes les vues se remplissent, les parties rondes ont besoin d'un cercle sur la vue de dessus ou de l'option --round, et les espaces entièrement fermés dans une vue ressortent pleins. La section Limites ci-dessus donne les correctifs.
Guides associés
- Skills d'agents et serveurs MCP pour le développement de jeux : d'autres skills pour Godot, Unity, three.js, le pixel art et les sprites.
- Blender MCP : quand il vous faut un vrai modèle 3D plutôt qu'un sprite stack.
- Modèles 3D gratuits Polyfork : des GLB low-poly gratuits pour les jeux three.js.
Sources
Vérifié le 21 novembre 2026 : README de danielwh2/sprite-stacking, SKILL.md, references/engines.md, LICENSE et les informations du dépôt sur GitHub (créé le 20 novembre 2026 ; 187 étoiles le 21 novembre 2026).
Vous avez fait un jeu avec des voitures ou des décors en sprite stacking ? Proposez-le sur VibeGamer.



