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:
| Path | What it is |
|---|---|
FloppyBird.uproject | The 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.mjs | The build, test, editor and replay commands. |
README.md | Build and play instructions, a source map and three exercises. |
GAMEGEN_START_HERE.md | The setup and reopening instructions from the dialog. |
.unrest/gamegen.json | The 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.