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

Your first model

Ten minutes, start to finish: draw something, give it thickness, and get a .glb your game can load.

1. Start a project

Flatty opens on a chooser. It lists the projects you have opened before — so on a genuinely first run it is empty, where the one below has been used once already.

Press New project. The file browser opens, and it wants one thing: the folder your project will live in.

Browse to wherever you keep your work, then type a name in the row under the listing — fluffy cloud will do — and press Create. That makes a folder of that name inside the one you are standing in, which is the whole of what a project is.

The line at the bottom spells out exactly what is about to be written, so there is never any guessing:

-> /home/you/sprites/fluffy cloud/project.fdraw

The folder is the project. There is no library and no database: a project is any folder containing a project.fdraw file, and it can be anywhere. Move it, copy it, put it on a memory stick — it is still a project. The name in the Project pane is yours to change whenever you like.

2. Draw something

You are looking at the canvas, large and top left, with the tools, the colours and the layer list in a strip beneath it. Down the right are the two views of what you are making: the model above, its line art below. Paint on the canvas with the left mouse button.

Draw a solid blob — a cloud, a face, a shield, whatever. Keep it simple and keep it touching the bottom of the canvas if it is a character; that is where the model’s pivot goes, so a character drawn at the bottom edge stands on the ground in your game.

A few things to try straight away:

Do thisGet this
[ and ]smaller and larger brush
Ctrl+dragpaint with the second colour
Shift+dragerase back to transparent
Alt+clicktake a colour off the canvas
G, then clickflood-fill a region
Ushapes — a line, a box, an ellipse, a polygon
S, or the right button on the canvasthe Swiss Army Knife — colours, tools and layers under the cursor
Ctrl+Zundo
Ctrl+Pask for anything by name — every pane and every command

That last one is worth trying early. Most of what Flatty can do lives in a pane you have not put on screen yet, and the command palette is how you find one without having learnt where it is.

Watch the right-hand pane while you work. The model is rebuilt as you draw — you are never waiting for a preview.

3. Give it depth

The model is currently a flat slab. Change that in the Outliner.

Click the title tab of any pane — the little filled label at its top left, reading 2D Canvas with a chevron after it — and choose Outliner. Above the layer list is a card for whichever layer you are on, and its first slider is Depth. Drag it and watch the shape push out.

The slider under it is the other half of what turns a stack of layers into relief. Z offset moves this layer’s slab forwards or backwards through the volume, so a nose can sit in front of a face rather than inside it.

Two more numbers worth a moment, both in the Project pane:

  • Side walls → Shade darkens the colour of the extruded sides relative to the front face. Lower is darker. This is what stops a model looking like a sticker.
  • World placement → Px / unit sets the scale: at 16, a 64-pixel sprite is 4 world units across.

4. Look at it properly

In the 3D pane, drag with the left button to orbit, use the wheel to move closer, and middle-drag to pan. The chip in the corner labelled Free orbit switches to a fixed angle — front, back, left, right, top or isometric — which is the honest way to check a silhouette.

The third chip along that line is how the model is shaded. Flatty is your colours exactly as you painted them, and it is what you should come back to before deciding a shade is wrong; the three beside it are stylised ways of seeing the same model, and the pictures in this book use one of them.

Whichever you pick, the export is unaffected — see The 3D view.

5. Save and export

Ctrl+S saves the project. Ctrl+E exports the model. Everything that comes out of a drawing has a button of its own in the Export pane, which the setup key at the bottom right of the window will pop out for you.

Your project folder now looks like this:

fluffy cloud/
  project.fdraw                              the drawing — this is your work
  exports/
    2026-08-21_144312_fluffy_cloud.glb       an archive, never overwritten
    2026-08-21_144312_fluffy_cloud.meshes.json
    latest/
      fluffy_cloud.glb                       the one your game loads
      fluffy_cloud.meshes.json

Every export is written twice. Once with a timestamp that is never replaced, so a week of work is still there to go back to. And once into latest/ under a fixed name, because the path in your game’s code cannot change every time you press export.

6. Load it in your game

m := rl.LoadModel("sprites/fluffy cloud/exports/latest/fluffy_cloud.glb")

// The one line you have to add: the file asks for nearest-neighbour filtering,
// but raylib's glTF loader does not apply that request, so your pixels come out
// blurred unless you say it again here.
for _, mat := range m.GetMaterials() {
    if tex := mat.GetMap(rl.MapAlbedo).Texture; tex.ID != 0 {
        rl.SetTextureFilter(tex, rl.FilterPoint)
    }
}

rl.DrawModel(m, playerPos, 1, rl.White)  // the pivot is baked in — no offset needed

That is the whole integration. No conversion step, no import settings, no material to rebuild.

Where to go next

  • Layers and depth — the chapter that makes shapes stop looking like slabs
  • Line art — the same model traced as an SVG, six different ways. Nobody expects this one
  • Colour — the two colours, the wheel, palettes and transparency
  • Exporting to your game — pivots, scale, Blender, and what is actually in the file