# AI metroidvania maker: building one when the map is the design

A metroidvania is a map with locks in it. Flockbay builds the map from a brief and writes the ability code, the gates and the save state, and the map stays open to your hand. Free AI to start: Flockbay's AI and your own Claude, ChatGPT, agent or API key are free for your first build; after that, a plan keeps you building. It runs on Windows, macOS and Linux, on the official Godot engine.

Source: https://flockbay.com/ai-metroidvania-maker/ · Updated 2026-10-18

## Why this genre is hard to start

Metroidvanias are the genre where the structure comes before the content. Before a single room is fun you need a movement system worth exploring with, a way to gate progress, a way to remember what the player has unlocked, and a map that folds back on itself in a way that rewards a second look.

That is a lot of scaffolding for something that will change completely the first time you play it. Most attempts die there. The double jump exists, the wall cling exists, and the map is still a rectangle because laying out a good one was the third job on a list of three.

The order that works is the opposite: get movement roughly right, then spend almost all your time on the map, because the map is the game.

## Movement first, and it belongs to Flockbay

Jump height. Air control. Coyote time. The dash that cancels into a jump and the one that does not. This is code, and it is the code that determines whether your game feels good, so it deserves more iterations than anything else in the project.

You describe what you want and Flockbay writes the GDScript. Then you play it and say the jump feels floaty, and it gets less floaty. This loop is fast in a way that hand-writing [a character controller](/blog/why-does-celeste-feel-so-good-to-play/) is not, and it means you can afford to be picky about a value you would otherwise have set once and left alone.

In a flat project some of that is not code at all. Walk and run speed, how long the body takes to reach a speed and how long it takes to lose it, air control, gravity, jump apex, body size and step length are values on the player controller, so "make it heavier" is a handful of numbers moving rather than a rewrite. A walk cycle can have its playback speed tied to the body's velocity, which keeps the legs with the speed instead of skating out from under it. The wall cling and the dash that cancels into a jump are still Flockbay's job.

You never have to open the script. You do have to play it, repeatedly, and have an opinion. That is the deal.

## The map is the design, and it stays in your hands

Placement is judgement. Which corridor loops back to the elevator, where the player first sees a door they cannot open, how far the shortcut cuts once it is unlocked: a sentence gets you close, and close is not good enough in this genre. So the brief settles the structure first (the abilities, the regions, the order they unlock in), Flockbay builds the map to it, and then you walk it and move things: say what is wrong, or drag it yourself in Godot's own editor.

Metroid and Castlevania both arrived flat in 1986, and the genre never really left. So the choice comes early: Flockbay reads 2D or 3D from your description of the game and settles it with you before a project exists. In 2D the first build is something you can play at once, a player controller who walks, falls and jumps over ground with a ledge in it, and the map grows by a sentence or a drag. Ground is a TileMapLayer, and its TileSet's terrains give the edges and the collision, so a corridor is walkable the moment it is painted.

Go 3D and terrain, water and weather can come from Godot plugins, which suits the branch of the genre that goes outdoors (cliffs, caverns, a coastline you return to with a swimming ability). Neither is the compromise. [A side-on pixel metroidvania](/ai-side-scroller-game-maker/) has Godot's own 2D tools behind it rather than a shrug and a note about the engine.

Ability gates are where the map and the code meet. The gate stands in the world, placed by Flockbay or by you; Flockbay writes the check that decides whether it opens.

## Saving, backtracking and the boring parts

A metroidvania needs persistence. Which doors are open, which items are collected, where the last save point was, what the map screen has revealed. It is tedious code with no creative content in it at all, and it is exactly what to hand off.

Same for [the map screen itself](/templates/godot-metroidvania-template/), fast travel, and the item log. Describe the behaviour, get the implementation, play it, correct it.

## What you are actually downloading

A desktop app for Windows, macOS and Linux with Godot inside it. Your project is a real Godot project on your disk. The game runs locally when you press play, at your machine's framerate, with no streaming and no browser tab in the way.

Building needs [an internet connection](/answers/does-flockbay-work-offline/) because the chat and asset generation come over the network. Playing what you have built does not. There is no way to build offline and it would be dishonest to imply otherwise.

## Combat, enemies and the parts that fill the space

Between the map and the abilities sits the moment-to-moment: enemies that make a corridor worth traversing, a hit that feels like it connected, a boss whose pattern you learn. This is the content that makes the map feel inhabited rather than empty.

Enemy behaviour is code. Describe [the pattern, the tells, the recovery window](/blog/what-makes-a-good-combat-system/), and Flockbay writes it into your project. Then play it and say the wind-up is too fast to react to, because that is a judgement only made with a controller in your hands.

The one design warning worth stating: a metroidvania becomes tedious when backtracking has nothing new in it. Enemies that change with progression, shortcuts that unlock, or a reason to revisit are all things to plan while the map is still soft.

## Questions

### Can I make a 2D metroidvania?

Yes. 2D or 3D is settled with you before anything is created. In a flat project the map is a TileMapLayer, movement feel is values on the player controller, and Flockbay writes the same abilities, gates and save code either way.

### Who writes the ability and gate code?

Flockbay, in GDScript, inside your project. You describe the ability and the condition, then play it and say whether it is right.

### Does it handle save games?

Save state is code like anything else. Describe what has to persist and it gets written.

### What does it cost?

Free to download. Free AI to start: Flockbay's AI and your own Claude, ChatGPT, agent or API key are free for your first build; after that, a plan keeps you building.

### Is my project locked into the tool?

No. It is a Godot project. Godot is open source and the project opens there like any other.

Download Flockbay free: Free for Windows, macOS and Linux. Get movement feeling right, then walk the map. https://flockbay.com/

Related: [AI platformer maker](/ai-platformer-maker/), [AI puzzle platformer maker](/ai-puzzle-platformer-maker/), [AI dungeon crawler maker](/ai-dungeon-crawler-maker/), [AI open world game maker](/ai-open-world-game-maker/)
