1 – Visual Studio 2019 or Newer
Although it is possible to make games without Visual Studio, doing so without Visual Studio requires advanced knowledge of MSBuild. We recommend downloading and installing Visual Studio.
At a minimum you will need to install .NET desktop development.
2 – .NET Framework 4.7.1 Developer Pack
.NET 4.7.1 is required to build FlatRedBall DesktopGL games, which is the default (and recommended) platform.
3 – MonoGame 3.7.1
Install MonoGame 3.7.1 for Visual Studio. It is possible to create games without installing MonoGame, but you will need to install MonoGame if you are going to use audio files (such as .ogg or .wav) in your game.
4. XNA 4.0 Redistributable
Although this is not required to build and run FlatRedBall games, it is required to use Gum, which is the preferred FlatRedBall UI tool.
The most common approach to making FlatRedBall games is to use the FlatRedBall Editor. The Editor can be downloaded from a pre-built .zip file, or it can be built from source. New users should expand Downloading Pre-Built FlatRedBall.
[+]Downloading Pre-Built FlatRedBall
Downloading and Running FlatRedBall
- Download the latest zip file from https://files.flatredball.com/content/FrbXnaTemplates/DailyBuild/FRBDK.zip
- Unzip the file after downloading
- Go to the folder where the .zip file unzipped to (by default called FRBDK)
- Open Xna 4 Tools folder
- Run GlueFormsCore.exe
[+]Building and Running FlatRedBall From Source
1 – Install .Net Core 3.0.1 x86
You must have this exact version installed to build FlatRedBall, even if you have a newer version. You must install the x86 version even if you have the 64 bit version.
2 – FlatRedBall NetStandard branch
- If you simply want to get the latest source, you can download the .zip file from Github. Be sure to use the NetStandard branch
- If you would rather always be connected to source, you can clone the source to your machine using command line or any Git client
3 – Gum (master branch)
- Just as above, download the Gum zip or clone the source to your machine.
Building FlatRedBall (Glue)
To build the FlatRedBall Editor (also referred to as Glue):
- Open Glue at <Git Root Directory>/FlatRedBall/FRBDK/Glue/Glue with All.sln. Note that this includes all plugins as well, so building this will give you a fully-featured Glue.
- To rebuild Glue with all plugins, select Build -> Build Solution in Visual Studio. Simply building the Glue project or running Glue will not build all plugins.
- Set GlueFormsCore as the StartUp Project
- Launch Glue from Visual Studio
- Glue should now be running
Gum Project References Broken
The Glue project references Gum projects, so the two project folders must be in the same root folder. To verify:
- Open Glue with All.sln
- Open the Solution Explorer
- Expand the GumProjects folder
If the references are correct, your window should look similar to the following image:
If your references are broken, then you may see something similar to the following image:
Notice that the projects are marked as unloaded.
To solve this make sure that both of the projects (FlatRedBall and Gum) are in the same root folder. If you unzipped the files, then they may need to be moved up one folder.
Review Project and Solution Changes
A message about the project not being supported can occur if .NET Core is not installed.
If you see this message, verify that you have installed .NET Core as indicated above.
Having problems opening or running FlatRedBall projects? Check out the Troubleshooting Page.
Here’s some more options on getting or updating FlatRedBall:
- Setup for FlatRedBall Android
- Building FlatRedBall from source
- FlatRedBall DLLs (binaries)
- Installing XNA (for AnimationEditor, Gum, and older projects)