sprite-stacking, Daniel White'ın yaptığı açık kaynaklı bir ajan skill'i. Bir nesnenin dört pixel art görünümünü (üstten, yandan, önden ve arkadan) bir "sprite stack"e çeviriyor: oyunun üst üste çizerek döndürülebilir bir 3D nesne izlenimi verdiği düz katmanlardan oluşan bir şerit. Claude Code, Codex, Cursor, OpenCode, Gemini CLI ve Pi ile çalışıyor. Depo 20 Kasım 2026'da oluşturuldu ve 21 Kasım 2026'da baktığımızda 187 yıldızı vardı. Lisansı MIT.
Bu rehberde sprite stacking'in ne olduğunu, skill'in ne eklediğini, nasıl kurulduğunu, girdi olarak neye ihtiyaç duyduğunu ve nerede yetersiz kaldığını anlatıyoruz. Aşağıdaki her komut deponun README dosyasından ya da SKILL.md dosyasından kopyalandı. Dosyaları 21 Kasım 2026'da okuduk ama skill'i kendimiz çalıştırmadık; yani anlatılan çıktılar, belgelere göre olması gerekenler.
Sprite stacking nedir
Sprite stack, üstten görülen bir nesnenin yerden yukarıya doğru dilimlenmiş bir ekmek gibi yatay katmanlara bölünmüş hâlidir. Oyun katmanları aşağıdan yukarıya çizer. Her biri aynı açıyla döndürülür, kameranın eğimine göre dikeyde basıklaştırılır ve bir öncekinin 1 piksel üstüne kaldırılır. Sonuç akıcı şekilde dönen küçük bir voksel modeli gibi görünür, ama hâlâ sıradan 2D çizimdir: 3D motor yok, mesh yok ve her açıda pikseller keskin kalır.
README tekniğin yeni olmadığını açıkça söylüyor: "Sprite stacking is a long-standing indie game technique, not invented here." Skill'in eklediği şey, dört görünümden oyma ve bunun etrafındaki ajan iş akışı.
İşin genelde en zahmetli kısmı katmanları çizmek. 30 katmanlı bir araba, birbirine tam oturması gereken 30 küçük görsel demek. Skill bunu atlıyor: sen (ya da ajanın) dört sıradan görünüm çiziyorsun, bir betik de katmanları bunlardan oyuyor.
Skill ne yapıyor
README dört adımı şöyle anlatıyor:
- Görünümler: üst, yan, ön ve arka görünümleri tek satırda, ortografik olarak içeren bir sayfa.
- Oyma: bir voksel yalnızca dört görünümün hepsinin kapladığı yerde kalır.
- Katmanlar: oyulan hacim, zemin katmanı ilk olmak üzere düz katmanlardan oluşan bir şeride kesilir.
- Render: her katman döndürülür, eğime göre basıklaştırılır ve 1 px yukarı kaldırılır.
Skill klasöründe şunlar var:
SKILL.md: ajanının okuduğu talimatlar. İyi bir dört görünümlü sayfa nasıl hazırlanır, dilimlemeden önceki kontrol listesi, slicer'ın bayrakları, render döngüsü ve değerleri, bir "bitti sayılır" listesi ve geçmiş hataları düzeltmeleriyle gösteren bir tablo.scripts/views_to_slices.py: slicer. Arka planı kaldırır, her görünümün etrafındaki 1px çerçeveyi siler, her şeyi tek bir ortak paletle sınırlar, katmanları oyar ve bir kontrol görseliyle bağımsız bir görüntüleyici sayfası yazabilir.scripts/viewer.html: tek başına da açılan ve sürüklenip bırakılan katman şeritlerini kabul eden bir tarayıcı görüntüleyicisi.references/engines.md: web Canvas ve React, Godot 4, Unity ile Phaser, Pygame ve diğerleri için kısa tarifler.
Claude Code veya Codex'e kurulum
README'deki tek satırlık kurulum skills CLI kullanıyor; bunun için Node 22.20 veya üstü gerekiyor:
npx skills add danielwh2/sprite-stacking
Bu, skill'i mevcut projeye kurar. README'ye göre tüm projeler için kurmak istersen -g, hangi ajana gideceğini seçmek için de -a claude-code (ya da codex, cursor vb.) ekliyorsun.
Diğer seçenek, depodaki skills/sprite-stacking klasörünü ajanının skill klasörüne kopyalamak:
| Ajan | Klasör |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex, Cursor, OpenCode, Gemini CLI, Pi | ~/.agents/skills/ |
Slicer bir Python betiği olduğu için Pillow ve NumPy yüklü Python 3 de gerekiyor. README'deki komut:
pip install pillow numpy
Kullanım: ajandan ne istemeli
Skill'i adıyla çağırmıyorsun. Kurulduktan sonra ne istediğini söylemen yeterli, ajan onu kendisi devreye alıyor. README'deki örnekler:
- "Döndürülebilir bir pixel art araba yap."
- "Bu 4 görünümlü sayfadan sprite stack yap ve bana bir döner tabla görünümü ver."
- "Godot oyunuma sahte 3D bir pixel art ağaç ekle."
SKILL.md, ajana kendisine verilen şeye göre bir yol seçmesini söylüyor:
- PNG katman şeridi ya da MagicaVoxel katman dışa aktarımı: doğrudan render'a geçer.
- Dört görünümlü sayfa: sayfayı kontrol eder, sonra oyar.
- Sadece bir prompt ya da fikir: önce dört görünümlü sayfayı üretir, sonra oyar ve render eder.
Elinde sayfa yoksa ajan, varsa bir görsel üretme aracını SKILL.md içinde yazılı bir prompt'la kullanır. Yoksa dört görünümü kısa bir Python betiğiyle pixel art olarak kendisi çizer. README bunu basitçe söylüyor: "No image generator? The agent draws the views itself in a short Python script."
Mevcut bir oyunda SKILL.md, ajana önce render kodunu (motor, piksel ölçeği, sprite'ların nasıl çizilip sıralandığı) okumasını ve stack'i ona uydurmasını söylüyor; asla ikinci bir canvas ya da ikinci bir render hattı eklememesini.
Hangi girdiye ihtiyaç duyuyor
Dört görünümlü sayfanın katı kuralları var ve kötü sonuçların çoğu bunları çiğnemekten çıkıyor. SKILL.md'den:
- TOP, SIDE, FRONT, BACK sırasıyla tek satır, düz beyaz zemin üzerinde, görünümler arasında belirgin boşluklarla.
- TOP dümdüz aşağı bakar ve nesnenin önü aşağıyı gösterir. SIDE görünümünde ön sola bakar.
- Kesinlikle ortografik: perspektif yok, eğim yok, 3/4 açı yok.
- Dört görünümde aynı ölçek: TOP uzunluğu SIDE uzunluğuna, TOP genişliği FRONT ve BACK genişliğine, SIDE yüksekliği FRONT ve BACK yüksekliğine eşit.
- Düz renk dolguları ve keskin çerçeveler. Yumuşak, airbrush gibi kenarlar ve ince 1px iç çizgiler katmanlar dönünce dağılır; skill bunları kurtarmaya çalışmak yerine yeniden çizmeyi öneriyor.
Üç boyut seviyesi de veriyor:
- Chunky retro: 15–20 katman, yaklaşık 25×48 px, 8–10× ölçekte gösterilir.
- Detailed hi-bit: 26–44 katman, 36×72 ile 46×107 px arası; havalandırma ızgaraları, logolar ve telli jantlar için yeterli.
- Showcase / 1080p video: 36–56 katman, 30×30 ile 148×148 px arası, 4–6× ölçekte gösterilir.
Slicer'ı kendin çalıştırmak
Slicer'ı normalde ajan çalıştırır, ama README'deki komutla depo kök dizininden kendin de çalıştırabilirsin:
python3 skills/sprite-stacking/scripts/views_to_slices.py views.png slices.png \
--slices 36 --preview check.png --html viewer.html
views.png dört görünümlü sayfan, slices.png de yazılan katman şeridi. README'nin listelediği bayraklar:
--slices N: katman sayısı. Kaba görünüm için 15–20, detaylı için 32–48.--order reading: TOP, SIDE, FRONT, BACK sırasını zorlar. Varsayılan olarak betik görünümleri oranlarına göre eşleştirir.--round: kuleleri, balonları ve saksıları kare yerine yuvarlak oyar.--side-nose right: SIDE görünümü sağa bakıyorsa.--colours N: ortak paletin boyutu;0tüm renkleri korur.--normals path.png: buna uyan bir normal map katman şeridini de kaydeder.--emissive path.png: otomatik algılanan bir parlama maskesini de kaydeder (farlar, pencereler, neon).
SKILL.md birkaç tane daha listeliyor; aralarında --top-nose (araç olmayan her şey için down ver), --shade, --bg-tol ve --dark-thresh var.
check.png çıkarılan dört görünümü, dört dönüş açısını ve patlatılmış bir görünümü gösterir. Skill, ajana herhangi bir oyun kodu yazmadan önce buna bakmasını söylüyor.
Görüntüleyici
--html bağımsız bir sayfa yazar. README'ye göre içinde döner tabla, prosedürel nesnelerle Scene modu, katman taraması, patlatılmış görünüm ve WASD ya da ok tuşlarıyla araç sürebildiğin bir Play modu var. Ayrıca gün saati, gölgeli ve sürüklenebilir bir güneş, yağmur ve kar, bir de 16 yönlü PNG sprite sayfası üreten dışa aktarma düğmesi bulunuyor. Sonuncusu, motorun sadece sıradan yönlü sprite'lar istiyorsa işe yarar.
Oyuna aktarmak
Render döngüsü her yerde aynı: zeminden yukarıya her katman için onu merkezi etrafında döndür, y eksenini basıklık değeriyle ölçekle, sırası ile aralık değerinin çarpımı kadar yukarı kaldır, tam piksele hizala ve en yakın komşu filtresiyle çiz. SKILL.md varsayılanları veriyor: eğik üstten kamera için aralık 1.0 ve basıklık 0.75 (1.0 dümdüz aşağı bakar). references/engines.md içinde hazır bir Canvas 2D fonksiyonu, Godot 4 için bir Node2D betiği, Unity için notlar (katman başına bir SpriteRenderer, Point filtresi) ve Phaser ya da Pygame için notlar var.
Skill'den iki ipucu performans ve görüntü için önemli. Stack'leri bütün olarak zemin noktalarına göre sırala ve iki nesnenin katmanlarını asla birbirine karıştırma. Statik stack'leri de oyun yüklenirken sıradan sprite'lara pişir: skill, her biri 30 katmanlı 200 ağacın kare başına 6.000 çizim çağrısı demek olduğunu belirtiyor.
Sınırlar
Bunlar skill'in kendi kontrol listesinden ve geçmiş hatalar tablosundan geliyor:
- Gizli oyuklar dolar. Oyma yalnızca dört siluetin hepsinin kapladığı yeri bırakır; bu yüzden hiçbir görünümde görünmeyen bir kamyonet kasası ya da içi boş bir kemer dolu çıkar. Yan görünümde arasından gün ışığı görünen çıkıntılar, örneğin yükseltilmiş bir arka kanat, korunur. Oyukları oymadan sonra elle düzeltmek gerekir.
- Yuvarlak parçalar kare çıkar; tabii üst görünümde piksel bir daire yoksa ya da yuvarlak parça tabanından darsa
--roundvermediysen. - 1px'lik parçalar stack dönerken yanıp söner. Direkler, ipler ve antenler en az 2px geniş olmalı; slicer bir uyarı yazdırır.
- Çıkıntılar rafa dönüşür. Duvardan dışarı taşan bir şey, örneğin çiçek kutusu ya da tabela, duvar boyunca bir raf oyar. Küçük çıkıntıları düz boya.
- Kapalı boşluklar dolu çıkar. Bir görünümün içinde tamamen çevrelenmiş arka plan (bacaklar, yüzgeçler ya da ipler arasında) nesnenin parçası sayılır. Her boşluğun görünümün dışına açılması gerekir.
- Merkezde olmayan nesneler sallanır. Stack sınırlayıcı kutusunun ortası etrafında döner; o yüzden nesneyi görünümlerde ortala.
- Sadece pixel art. Teknik ve slicer, küçük ve düz gölgelendirilmiş sprite'lar için yapıldı. three.js ya da Unity 3D oyunu için gerçek bir 3D model elde etmenin yolu değil.
Lisans
Depo MIT Lisansı altında (copyright 2026 Daniel White); bu GitHub'da ve LICENSE dosyasında görülüyor. Kodun kopyalarıyla birlikte telif hakkı ve lisans bildirimini koruduğun sürece onu kullanabilir, değiştirebilir ve ticari projelerde dağıtabilirsin. README, onunla yaptığın sprite'ların lisansı hakkında bir şey söylemiyor.
SSS
Sprite stacking nedir?
2D bir oyunda 3D izlenimi yaratmanın bir yolu. Nesne, üstten görülen düz katmanlardan oluşan bir şerit olarak saklanır; oyun bunları aşağıdan yukarıya, her birini aynı açıyla döndürüp 1 piksel kaldırarak çizer. Dönen küçük bir voksel modeli gibi görünür ama keskin pixel art olarak kalır.
sprite-stacking skill'i ücretsiz mi?
Evet. MIT Lisansı altında açık kaynak. Yalnızca Pillow ve NumPy yüklü Python 3'e ve npx skills ile kuruyorsan Node 22.20 veya üstüne ihtiyacın var. Yapay zeka ajanının aboneliği ya da API kullanımı ayrı.
Claude Code ve Codex ile çalışıyor mu?
Evet. İkisi de README'de listeleniyor. npx skills add danielwh2/sprite-stacking ile kur (ajanı seçmek için -a claude-code ya da -a codex ile) veya skills/sprite-stacking klasörünü Claude Code için ~/.claude/skills/ içine, Codex için ~/.agents/skills/ içine kopyala.
Görsel üretme aracına ihtiyacım var mı?
Hayır. Ajanında varsa skill ona dört görünümlü sayfa için bir prompt verir. Yoksa ajan görünümleri kısa bir Python betiğinde kendisi çizer. Ona kendi çizdiğin bir sayfayı, bir katman şeridini ya da bir MagicaVoxel katman dışa aktarımını da verebilirsin.
Sonucu Godot, Unity ya da Phaser'da kullanabilir miyim?
Evet. references/engines.md içinde bir Godot 4 betiği, Unity için notlar, web ve React için bir Canvas 2D fonksiyonu ile Phaser ve Pygame için genel döngü var. Görüntüleyici, sıradan sprite isteyen motorlar için 16 yönlü bir PNG sprite sayfası da dışa aktarabiliyor.
Sprite'ımın bazı parçaları neden dolu ya da kare çıkıyor?
Slicer bir vokseli yalnızca dört görünümün hepsinin kapladığı yerde tutar. Hiçbir görünümde görünmeyen oyuklar dolar, yuvarlak parçalar üst görünümde bir daireye ya da --round bayrağına ihtiyaç duyar ve bir görünümün içinde tamamen kapalı boşluklar dolu çıkar. Düzeltmeler yukarıdaki Sınırlar bölümünde.
İlgili rehberler
- Oyun geliştirme için ajan skill'leri ve MCP sunucuları: Godot, Unity, three.js, pixel art ve sprite'lar için daha fazla skill.
- Blender MCP: sprite stack yerine gerçek bir 3D modele ihtiyacın olduğunda.
- Polyfork ücretsiz 3D modeller: three.js oyunları için ücretsiz low-poly GLB'ler.
Kaynaklar
21 Kasım 2026'da kontrol edildi: danielwh2/sprite-stacking README, SKILL.md, references/engines.md, LICENSE ve GitHub'daki depo bilgileri (oluşturulma 20 Kasım 2026; 21 Kasım 2026'da 187 yıldız).
Sprite stacking ile yapılmış arabalar ya da nesneler içeren bir oyun mu yaptın? VibeGamer'a gönder.



