Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

What Flatty is

Flatty turns pixel art into 3D models you can drop straight into a game.

You paint a flat grid, exactly as you would in any pixel editor. Flatty pushes that drawing out into the third dimension — giving it thickness, colouring its sides, welding it into a mesh — and writes a .glb file that rl.LoadModel takes as-is.

The drawing on the left is the only thing you edit. The model on the right is a consequence of it, rebuilt as you paint. It is wearing one of the four ways Flatty can shade a model; the export always carries your own colours.

The one idea

The picture is the shape. There is no separate modelling step and nothing to sculpt. A pixel you paint becomes solid; a pixel you leave transparent is not part of the model at all — not a hollow, not a hidden face, simply absent. Erase a pixel and the shape loses that column of material the moment you let go.

That is why the tool is worth using. A sprite and its model can never disagree, because there is only one of them.

flowchart LR
    A[You paint<br/>a 2D grid] --> B[Each opaque pixel<br/>becomes a column]
    B --> C[Columns weld into<br/>one mesh]
    C --> D[".glb your game loads"]
    style A fill:#66d9ef,stroke:#66d9ef,color:#1a1a1a
    style D fill:#a6e22e,stroke:#a6e22e,color:#1a1a1a

Who it is for

People making 2.5D games — platformers, brawlers, top-down adventures — who want the look of pixel art with real geometry: characters that catch a light, props that cast shadows, a world you can move a camera through.

If you have drawn a sprite before, you already know how to use most of this.

Five things come out of one drawing

The model is the reason the app exists, but it is not the only thing you can ask for. From the same artwork, on their own buttons:

You getWhich is
a .glbthe extruded model, plus a sidecar naming its parts
a .pngthe artwork, flat, at its own pixel size
an .svgthe model traced as line art — six ways of drawing it, from clean outlines to halftone dots
a second .pngthat same line art, rasterised
a third .pngthe 3D view itself, framed and with nothing behind it

The line art is the one nobody expects. Line art is its chapter, and it is worth a look even if you only came for the model.

What you should know before starting

It is not a voxel editor. You cannot carve out an interior, and you cannot give one part of a shape a different thickness from the pixel beside it. Depth is a property of a layer, not of a pixel. That restriction is the whole point: it is what keeps the drawing the single source of truth, and what makes the result reliably cheap to render.

Layers are how shapes gain structure. Give a nose more depth than a face, put one layer in front of another, and you have relief without ever leaving the 2D grid. Layers and depth is the chapter that unlocks the tool.

Nothing is saved automatically. A project is a folder you choose; until you save, your work is only in memory. Projects explains the whole arrangement, which is deliberately simple: no catalogue of your projects, no database, no hidden root folder. Move a folder and it is still a project.

Your materials are the other way round. Palettes and pictures belong to you rather than to any one drawing, so they are kept once, in your libraries, and every project can reach them.

How to read this book

If you want toStart at
get something working in ten minutesYour first model
understand the editor properlyThe workspace, then read forward
look one thing upthe Reference section
get a model into your gameExporting to your game

This book is everything you need. It is the complete manual: what each part of the program is, how to drive it, and what comes out the other end. There is nothing you have to know that is written down somewhere else.

Flatty is free, and the newest version is always at flatty.higreg.pl.