Robert WallisandDylan Wilson
eb7148af48
* [Docs] Packages root page, overview of packages. * [Docs] BitmapFonts ported from Wiki, includes images from archive.org because dylanwilson.net is down. * [Docs] Collections * [Docs] Added Community-and-Support page. * [Docs] ported wiki About page. * [Docs] ported Pre-Release page into Installation. * [Docs] ported Development pages from wiki. * [Docs] reorg top nav * [Docs] Moved Pre-Release page back into it's own page. * [Docs] ported Object Pool docs. * [Docs] Linking Object-Pooling in Collections and updating links. * [Docs] ported Animated-Sprites from wiki * [Docs] linking from index.md to existing pages. * [Docs] ported Showcase from Wiki * [Docs] ported Camera2D from wiki * [Docs] Camera2D changed Tutorial section to h1 * [Docs] ported Screens namespace from wiki * [Docs] linked to Camera2D from index
2.7 KiB
Installation
MonoGame.Extended is a collection of portable class libraries (PCL) designed to be referenced from any MonoGame project to add common extensions and classes for making your games more awesome.
The libraries are distributed as NuGet packages and can be installed using the NuGet Package Manager in Visual Studio, Xamarin Studio, or MonoDevelop. They can also be installed by running the following command (or the equivilant command for the package you want to install) in the Package Manager Console.
Install-Package MonoGame.Extended
Note that MonoGame 3.6 will need to be installed to properly use MonoGame.Extended in your game project.
Referencing the Content Pipeline extension
To get the full experience you'll also want to install the Content Pipeline extension:
Install-Package MonoGame.Extended.Content.Pipeline
This package won't add any references to your project. Instead it will download a DLL that's intended to be referenced from the MonoGame Content Pipeline tool.
You'll need to manually add the reference to your content file (usually Content.mgcb) using one of the following methods.
Using the MonoGame Pipeline GUI
To add the reference using the Pipeline GUI tool follow these steps:
- Click on the Content node in the root of the tree.
- In the properties window, modify the References property.
- Find and add the
MonoGame.Extended.Content.Pipeline.dll. It's usually located in the packages folder of your solution.
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.Content.Pipeline.0.6.372\tools\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.