explaingit

vitsoonyoung/spritestack2d

Analysis updated 2026-05-18

209GDScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A Godot 4 addon that turns a single sheet of flat pixel art views into a rotatable pseudo 3D sprite, optimized to render efficiently at scale.

Mindmap

mindmap
  root((SpriteStack2D))
    What it does
      Pseudo 3D sprites
      Single spritesheet input
      Rotatable objects
    Tech stack
      GDScript
      Godot 4
    Use cases
      2D game depth
      Efficient rendering
      Rotating props
    Audience
      Game developers
    License
      MIT

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give 2D pixel art games a pseudo 3D look without modeling real 3D objects.

USE CASE 2

Render many identical rotating objects efficiently by sharing cached render output.

USE CASE 3

Add rotatable pixel art props or characters to a Godot 4 project from a single spritesheet.

USE CASE 4

Use the included performance test scene to check how the addon scales with many nodes.

What is it built with?

GDScriptGodot

How does it compare?

vitsoonyoung/spritestack2dlolner95/godotterduolahypercho/gta-vi-caliber
Stars2096563
LanguageGDScriptGDScriptGDScript
Setup difficultyeasymoderatemoderate
Complexity2/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires Godot 4 and a hand drawn 2x2 spritesheet of orthographic views.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

SpriteStack2D is an addon for the Godot 4 game engine that makes 2D pixel art look like it has depth, using a technique called sprite stacking. Instead of modeling a real 3D object, you draw a single sheet of pixel art showing four flat views of the same object, a top view, a front view, a side view, and a back view, and the addon combines them into a node that renders as a pseudo 3D object you can rotate around. To use it, you draw a 2 by 2 grid of images where every frame is the same size: the first frame is the top view, the second is the front, the third is the side, and the fourth is the back, which can be left empty so the front view is mirrored automatically. You then download the addon, place it in your Godot project's addons folder, turn it on in your project settings, add a SpriteStack2D node, and assign your image sheet to it. The node automatically works out the grid layout from the sheet you give it. The project pays attention to performance. When many objects on screen share the same input image and settings, the rendered output for each viewing angle is calculated once and reused across all of them, so a thousand identical spinning objects can still run at around 160 frames per second in the author's test. The processed image data is also shared and automatically cleaned up once nothing is using it anymore. A test scene with live performance numbers is included for anyone who wants to check this themselves, and it was tested on Godot 4.7. The project is released under the MIT license, which allows free use, modification, and commercial use as long as you keep the copyright notice.

Copy-paste prompts

Prompt 1
Show me how to set up a SpriteStack2D node from a 2x2 spritesheet in my Godot project.
Prompt 2
Explain how this addon's caching works and why it improves performance with many identical nodes.
Prompt 3
Help me draw a spritesheet with top, front, side, and back views for use with this addon.
Prompt 4
Walk me through running the included perf_test.tscn stress test scene.

Frequently asked questions

What is spritestack2d?

A Godot 4 addon that turns a single sheet of flat pixel art views into a rotatable pseudo 3D sprite, optimized to render efficiently at scale.

What language is spritestack2d written in?

Mainly GDScript. The stack also includes GDScript, Godot.

What license does spritestack2d use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is spritestack2d to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is spritestack2d for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.