Install the Layer addon in Godot
Last updated: November 19, 2026
Install the Layer addon in a Godot project and sign in, to generate sprites, sprite sheets, tiles and 9-slice UI into the scene you have open.
Before you start
Godot 4.5 or later on macOS, Windows or Linux. The addon is GDScript only, so it needs no C# build of Godot. It does not run in Godot 3.
A Layer account. The addon is free with every plan, including the free one; runs use your workspace's Creative Units, as they do in the browser.
If your company signs in to Layer with single sign-on (Okta, Microsoft Entra ID, Google Workspace or another provider), first sign in to Layer in your default browser through your identity provider. Signing in from Godot then completes without asking for a password.
Steps
Go to layer.ai/integrations/godot and download the zip. One zip covers macOS, Windows and Linux.
Extract the zip into your Godot project's folder. It holds a single
addons/layerfolder, so it lands next to any other addons and touches nothing else.Open the project in Godot, go to Project, Project Settings, Plugins and turn on Layer AI. The Layer dock opens on the right. No restart is needed.
Click Sign in in the dock. Your browser opens Layer's sign-in page with a code filled in: check that it matches the code the dock shows, then sign in as you do on layer.ai. If the browser is on another device, open the address the dock shows there and enter the code.
Pick the workspace the project's work is filed under.
Pick a tool in the dock, describe what you want and click Generate. When the run shows Ready, click Place to put the result into the open scene.
Result
Each tool places its result as Godot nodes in the open scene, as one undo step: an image as a Sprite2D at the center of the 2D view, a sprite sheet as an AnimatedSprite2D playing its SpriteFrames, a 9-slice element as a NinePatchRect with its patch margins set, and a game tile painted into a TileMapLayer from a generated TileSet. An edit of an image is saved beside the original as a new version, and the original is never changed.
Files are saved under res://layer/ in the project. The project remembers its Layer session in res://layer/session.json, and that session is the same one you see at layer.ai, so work started in Godot can be reviewed in the browser and by the rest of the team.
Production tips
Commit the addon and the session file. Commit
addons/layerandres://layer/session.json, and a teammate who pulls the project has the addon and works in the same Layer session. Commit the images underres://layer/with their.layer.jsonand.tresfiles beside them, or none of them: aTileSetorSpriteFrameswithout its image does not load.Set a per-run limit. The dock shows what a run costs before it starts and does not send a run above your limit. Change the limit under Editor Settings, Layer, Max Creative Units Per Run.
Make tiles and kits in the browser, place them in Godot. Tiles and sprite sheets made at layer.ai, by you or the agent, arrive in the dock's session files with their grid. Place turns them into a
TileSetorSpriteFrameswithout any slicing by hand.Rebuild after a hand edit. If you repaint a generated sheet or tile image, click Rebuild on it in the dock to rebuild its
TileSet,StyleBoxTextureorSpriteFrames. Cells already painted with a tile stay painted.Keep one editor open per project. Two editors open on the same project each file the session's downloads on their own.
If something goes wrong
There is no Layer AI plugin in the list. Check that the zip was extracted into the project folder itself, so the path is
<project>/addons/layer/plugin.cfg, not one folder deeper. Then check that the project runs in Godot 4.5 or later.The run says it is above your limit and nothing was sent. Raise Max Creative Units Per Run under Editor Settings, Layer, or pick a cheaper model.
Placing a Sprite2D needs a 2D scene. Open or create a 2D scene, then click Place again. Images, sprite sheets, 9-slice elements and tiles are placed in 2D scenes.
The sign-in page asks for a password, and your company uses single sign-on. Sign in to Layer in your browser through your identity provider, then click Sign in in the dock again. You can't sign in to a Layer plugin covers the other sign-in messages.
The dock says it is signed in with an API key. The
LAYER_API_KEYenvironment variable is set on this machine, and it wins over your login. Unset it and restart Godot to sign in as yourself.