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.
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.
The most common approach to making FlatRedBall games is to use Glue. Glue can be downloaded from a pre-built .zip file, or it can be built from source. New users should expand Downloading Pre-Built Glue.
[+]Downloading Pre-Built Glue
Downloading and Running Glue
- 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 Glue 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.
To build 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
At the time of this writing, the NewProjectCreator is a separate project from Glue with All.sln (this may change in the future).
You must build the NewProjectCreator if you want to create new projects using Glue. To do this:
- Open <Location where you downloaded FlatRedBall/FRBDK/NewProjectCreator/NewProjectCreator.sln
- Make sure NewProjectCreator is set as the startup project
- Build and run the app
- The New Project Creator tool should 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.
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)