Installation (FNA)

Up to date

This page is up to date for MonoGame.Extended 4.0.4. If you find outdated information, please open an issue.

The following article details the steps necessary to get MonoGame.Extended installed and set up in your FNA project. MonoGame.Extended can be used with either MonoGame, KNI, or FNA. This article will detail how to set up and install MonoGame.Extended with an existing FNA project.

note

• If you are using MonoGame, please see the Installation (MonoGame) document.
• If you are using KNI, please see the Installation (KNI) document.

Prerequisites

The following prerequisites are required when using MonoGame.Extended with FNA.

• Ensure your development environment is set up for FNA Development.

  • Windows Setup
  • Linux Setup

• An FNA project

  • Chapter 5: Creating New Projects

Installation

To use MonoGame.Extended with FNA, you will need to clone the MonoGame.Extended repository locally. By default, MonoGame.Extended expects to be in the same directory that you have the FNA source repository cloned to.

Once you have the source repos cloned, add a reference to the /source/MonoGame.Extended/FNA.Extended.csproj project file in your game project.

tip

The requirement for FNA and MonoGame.Extended repositories to be sibling directories is only the default setup. If you would like to adjust this, you can modify the project reference path to the FNA source within the /source/MonoGame.Extended/FNA.Extended.csproj file.

Conclusion

Setting up MonoGame.Extended with an existing FNA project is straightforward and only requires that you clone the source and set up the directories correctly so that the project references can resolve. Once these steps are complete, you can immediately start taking advantage of what MonoGame.Extended has to offer.