Skip to content
One framework for creating powerful cross-platform games.
C# XSLT HLSL Rich Text Format Smalltalk NSIS Other
Branch: develop
Clone or download
cra0zy Merge pull request #6863 from Jjagg/external-tool-fix
Fix path to ExternalTool for content pipeline on .NET Core
Latest commit 2c4bace Aug 17, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add Subscription Jul 4, 2019
Build Upgrade Tools target and add SDK-style test projects (#6824) Aug 13, 2019
Cake [CAKE] Rename tools folder to Cake Jun 26, 2019
Documentation Merge pull request #6492 from Jjagg/mgcb-wd Aug 9, 2019
IDE Fill up dotnet template info (#6226) Mar 4, 2018
Installers Run MakeNSIS from Cake for the Windows installer (#6798) Aug 13, 2019
MonoGame.Framework.Content.Pipeline Fix path to ExternalTool for content pipeline Aug 17, 2019
MonoGame.Framework.Net Move MonoGame.Framework.Net to seperate directory (#6775) Jun 26, 2019
MonoGame.Framework Upgrade Tools target and add SDK-style test projects (#6824) Aug 13, 2019
NuGetPackages Disable Piranha portable build Aug 11, 2019
ProjectTemplates Update Android template (#6797) Jul 1, 2019
Test Upgrade Tools target and add SDK-style test projects (#6824) Aug 13, 2019
ThirdParty Upgrade Tools target and add SDK-style test projects (#6824) Aug 13, 2019
Tools Upgrade Tools target and add SDK-style test projects (#6824) Aug 13, 2019
.editorconfig Add a newline to the end of .editorconfig. Sep 28, 2013
.gitignore [CAKE] Rename tools folder to Cake Jun 26, 2019
.gitmodules Upgrade Tools target and add SDK-style test projects (#6824) Aug 13, 2019
CHANGELOG.md Added change log for 3.7.1. Dec 8, 2018
CODESTYLE.md Removed non-ASCII characters and other changes Nov 14, 2018
CONTRIBUTING.md Minor syntax and grammatical changes to CONTRIBUTING.md Nov 14, 2018
Directory.Build.props Upgrade Tools target and add SDK-style test projects (#6824) Aug 13, 2019
ISSUE_TEMPLATE.md Fix unclosed comment and typos in issue template Apr 15, 2018
LICENSE.txt Update copyright year to 2019 in LICENSE.txt Jan 6, 2019
MonoGame.Framework.DesktopGL.sln Upgrade Tools target and add SDK-style test projects (#6824) Aug 13, 2019
MonoGame.Framework.WindowsDX.sln Upgrade Tools target and add SDK-style test projects (#6824) Aug 13, 2019
Protobuild.exe Upgrade Tools target and add SDK-style test projects (#6824) Aug 13, 2019
README.md Add Subscription Jul 4, 2019
REQUIREMENTS.md Updated README Jan 25, 2016
build.cake Run MakeNSIS from Cake for the Windows installer (#6798) Aug 13, 2019
build.ps1 CAKE General Improvements Jun 29, 2019
build.sh CAKE General Improvements Jun 29, 2019
default.build Upgrade Tools target and add SDK-style test projects (#6824) Aug 13, 2019

README.md

MonoGame

One framework for creating powerful cross-platform games. The spiritual successor to XNA with thousands of titles shipped across desktop, mobile, and console platforms. MonoGame is a fully managed .NET open source game framework without any black boxes. Create, develop and distribute your games your way.

Join the chat at https://gitter.im/MonoGame/MonoGame

Build Status

Our build server builds, tests, and packages the latest MonoGame changes. The table below shows the current build status for the develop branch.

Name Status
Build Windows, Web, and Android Build Status
Build Mac, iOS, and Linux Build Status
Generate Documentation Build Status
Windows Tests Build Status
Package NuGet Build Status
Package Mac and Linux Build Status
Package Windows Build Status

Supported Platforms

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 10 Store Apps (UWP)
    • Windows Win32 (OpenGL & DirectX)
    • Linux (OpenGL)
    • Mac OS X (OpenGL)
  • Mobile/Tablet Devices
    • Android (OpenGL)
    • iPhone/iPad (OpenGL)
    • Windows Phone 10 (UWP)
  • Consoles (for registered developers)
    • PlayStation 4
    • PlayStation Vita
    • Xbox One (both UWP and XDK)
    • Nintendo Switch
  • Other
    • tvOS (OpenGL)

Support and Contributions

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.

Subscription

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.

Source Code

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
  • Run Protobuild.exe to generate project files and solutions.
    • If on Linux or Mac, run it with mono: mono Protobuild.exe
  • You can generate solutions for platforms that are not buildable from the current OS with:
    • Windows: .\Protobuild.exe --generate $PLATFORM
    • Linux or Mac: mono Protobuild.exe --generate $PLATFORM
  • Open the solution for your target platform to build the game framework.
  • Open the solution for your development platform for building 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:

Helpful Links

License

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.

You can’t perform that action at this time.