Skip to Content
GameGenGetting startedYour first game

Your first game

The Floppy Bird tutorial is a small, finished C++ game for Unreal Engine. You create it from New game, build it, play it, and then ask GameGen to change it. Creating the project only writes files. It does not install the engine, compile the game or check your toolchain.

Before you start

  • Install Unreal Engine and a C++ toolchain. See Requirements.
  • Connect a model provider in Settings.

Create the project

Choose New game

On the welcome screen, choose New game.

Pick the engine

Under Engine, keep Unreal Engine selected. Roblox is shown as Coming soon.

Pick the tutorial

Under Start with, keep Floppy Bird tutorial selected. It is described as “Playable C++ example, tests and exercises.” The other choice, Blank project, starts with the engine starter.

Name the game

Type a name under Game name. The name can have up to 80 characters and cannot contain path separators or two dots in a row.

Choose where to put it

Under Location, choose Choose folder… and pick a parent folder. GameGen shows the folder it will create, named after your game in lower case with hyphens.

Review and create

Choose Continue. The dialog changes to Ready to create your game and lists what to do before you start. Choose Create project.

Open the project

The dialog changes to Project created. Choose Open project.

If the dialog shows Created with warnings, read the list. A common warning is that git init could not run because git is not installed.

What you get

GameGen opens the project. The sidebar now shows the Unreal view, because the folder has a .uproject file.

The new folder contains:

PathWhat it is
FloppyBird.uprojectThe Unreal project. The module and target keep the name FloppyBird. Your game name sets the folder name.
Source/The C++ game and its automation tests.
Scripts/ue.mjsThe build, test, editor and replay commands.
README.mdBuild and play instructions, a source map and three exercises.
GAMEGEN_START_HERE.mdThe setup and reopening instructions from the dialog.
.unrest/gamegen.jsonThe GameGen settings for this project.

See The tutorial project for the full layout.

Build and play

Check the engine

Open the Unreal view. Under Engine install, the Engine row shows the engine GameGen found. If it shows Not found, see Engine setup.

Build

Under Actions, choose Build. A build takes minutes. The output appears under the buttons.

Open the editor

Choose Open editor. Unreal Editor starts on this project with Remote Control on.

Play

In Unreal Editor, follow the project’s README.md to pick the level, then press Play. Click the viewport to give it focus. Space or a left click flaps. After GameOver, the next input starts a new run.

Ask for a first change

Type a small change in the chat, for example one of the three exercises in the project’s README.md. GameGen asks “Want me to ask a few questions first, or just build it?” Choose Just build it for a small change.

The work appears as cards in the Tasks view and moves through the columns. See Describe and plan.

Reopen the project later

Choose the game under Recent projects on the welcome screen, or choose Open project and select the game folder. Select the folder itself, not its parent and not a single file.

Next steps

Last updated on