MonoGame is a simple and powerful .NET framework for creating games for desktop PCs, video game consoles, and mobile devices using the C# programming language. It has been succesfully used to create games such as Streets of Rage 4, Carrion, Celeste, Stardew Valley, and many others.
It is an open-source re-implementation of the discontinued Microsoft's XNA Framework.
We use GitHub Actions to automate builds and packages distribution of the latest MonoGame changes. We also rely on a build server to run tests in order to avoid regressions. The table below shows the current build status for the develop branch.
| Name | Status |
|---|---|
| Builds |  |
| Windows Tests | |
| Mac Tests |
We support a growing list of platforms across the desktop, mobile, and console space. If there is a platform we don't support, please make a request or come help us add it.
- Desktop PCs
- Windows 8.1 and up (OpenGL & DirectX)
- Windows Store Apps (UWP)
- Linux (OpenGL)
- macOS 10.15 and up (OpenGL)
- Mobile/Tablet Devices
- Android 6.0 and up (OpenGL)
- iPhone/iPad 10.0 and up (OpenGL)
- Consoles (for registered developers)
- PlayStation 4
- PlayStation 5
- Xbox One (both UWP and XDK)
- Nintendo Switch
- Google Stadia
If you think you have found a bug or have a feature request, use our issue tracker. Before opening a new issue, please search to see if your problem has already been reported. Try to be as detailed as possible in your issue reports.
If you need help using MonoGame or have other questions we suggest you post on our community forums. Please do not use the GitHub issue tracker for personal support requests.
If you are interested in contributing fixes or features to MonoGame, please read our contributors guide first.
If you'd like to help the project by supporting us financially, consider supporting us via a subscription for the price of a monthly coffee.
Money goes towards hosting, new hardware and if enough people subscribe a dedicated developer.
There are several options on our Donation Page.
The full source code is available here from GitHub:
- Clone the source:
git clone https://github.com/MonoGame/MonoGame.git - Set up the submodules:
git submodule update --init - Open the solution for your target platform to build the game framework.
- Open the Tools solution for your development platform to build the pipeline and content tools.
For the prerequisites for building from source, please look at the Requirements file.
A high level breakdown of the components of the framework:
- The game framework is found in MonoGame.Framework.
- The content pipeline is located in MonoGame.Framework.Content.Pipeline.
- Project templates are in Templates.
- See Tests for the framework unit tests.
- See Tools/Tests for the content pipeline and other tool tests.
- mgcb is the command line tool for content processing.
- mgfxc is the command line effect compiler tool.
- The mgcb-editor tool is a GUI frontend for content processing.
- The official website is monogame.net.
- Our issue tracker is on GitHub.
- Use our community forums for support questions.
- You can join the Discord server and chat live with the core developers and other users.
- The official documentation is on our website.
- Download release and development packages.
- Follow @MonoGameTeam on Twitter.
The MonoGame project is under the Microsoft Public License except for a few portions of the code. See the LICENSE.txt file for more details. Third-party libraries used by MonoGame are under their own licenses. Please refer to those libraries for details on the license they use.