MonoGame.Extended is a portable class library (PCL) that makes MonoGame more awesome. It is designed to be referenced from any MonoGame project to add extensions and classes for making games.

The library is distributed as a NuGet package and can be installed using the NuGet Package Manager in Visual Studio or by running the following command in the Package Manager Console.

Install-Package MonoGame.Extended -Pre

Referencing the Pipeline extension

The package comes with 2 DLLs:

  • MonoGame.Extended.dll
  • MonoGame.Extedded.Content.Pipeline.dll

The MonoGame.Extended.dll is referenced by your Game project, but the MonoGame.Extended.Content.Pipeline.dll is intended to be used with the MonoGame Pipeline tool. To reference the DLL in the Pipeline tool you'll need to edit your Content.mgcb file.

Using the MonoGame Pipeline GUI

To add the reference using the Pipeline GUI tool follow these steps:

  1. Click on the Content node in the root of the tree.
  2. In the properties window, modify the References property.
  3. Find and add the MonoGame.Extended.Content.Pipeline.dll. It's usually located in the packages folder of your project.

MonoGame Pipeline References

Note: The user interface has changed a little between MonoGame versions. The screenshot above is from MonoGame 3.4. The dialog is a little easier to use in MonoGame 3.5.

Using a text editor

An alternative way to add the reference is by manually editing the Content.mgcb file in a text editor or Visual Studio. Look for the references section and update it like this:

#-------------------------------- References --------------------------------#

/reference:..\..\packages\MonoGame.Extended.0.2.3-alpha\lib\MonoGame.Extended.Content.Pipeline.dll

Remember: The MonoGame.Extended.dll and the MonoGame.Extended.Content.Pipeline.dll come as a pair. Always make sure the version referenced by your game matches the version referenced by the Pipeline tool.

That's it! Once you've referenced the library you can start using it to make your games even more awesome.