README.md

Note

Hi MonoGame community, MonoGame.Extended is currently being updated to resolve outstanding bug issues, included those surrounding Tiled, and to update for MonoGame 3.8.1.303. Please bear with me as I work through the backlog. You can follow the progress in the v4.0.0 Milestones page.

• AristurtleDev

MonoGame.Extended

MonoGame.Extended is a set of utilities (in the form of libraries/tools) to MonoGame that makes it easier to make games. Choose what you want, the rest stays out of your way. It makes MonoGame more awesome.

Getting started

Code is distributed as NuGet packages in the form of libraries (.dll files). You can easily install the NuGet packages into your existing MonoGame project using the NuGet Package Manager UI in Visual Studio or by using the command line interface (CLI) in a terminal.

Current Stable Release

Warning

The current stable release is not compatible with MonoGame 3.8.1.303.

dotnet add package MonoGame.Extended --version 3.8.0

Current Prerelease

Note

Prerelease is based on current develop branch snapshot. There it is not considered stable and may contain bugs

dotnet add package MonoGame.Extended --version 3.9.0-prerelease.4

Using the Content Pipeline Extensions

To use the content pipeline extensions, you will need to edit your .mgcb file to reference the .dll. To see an example of how to do this with NuGet see the samples at https://github.com/craftworkgames/MonoGame.Extended-samples. The important pieces are the NuGet.config file and the .mgcb file.

Where to next?

• Check out the samples
• Join our live Discord
• Read the Documentation
• Submit an issue on GitHub
• Ask a question on gamedev stack overflow
• Post on our MonoGame community forum
• Follow development on Patreon

News

We're in the process of developing MonoGame.Extended 4.0! Stay tuned.

Patreon Supporters

The patreon has been removed. If you would like to support the maintainers of this project, please consider using the GitHub sponsors link for one of the maintainers.

As a special thanks to those that supported this project through Patreon in the past, their websites were linked in this readme and have been preserved below:

• PRT Studios
• optimuspi

Special Thanks

• Matthew-Davey for letting us use the Mercury Particle Engine.
• John McDonald for 2D XNA Primitives
• LibGDX for a whole lot of inspiration.
• @prime31 for Nez. Both MonoGame.Extended and Nez are in communication with each other to share ideas.
• All of our contributors!

License

MonoGame.Extended is released under the The MIT License (MIT).