Installing Mono for Unreal Engine
Building Unreal Engine with the Mono plugins.
To install Mono for Unreal Engine, you'll need to
build the Unreal Editor from source and then add the Mono
extension that enables the use of C# with Unreal Engine.
The current add-in has been tested with version 4.4. This
page describes how to setup Unreal Engine to allow C#
development with Mono, and how to setup your MonoDevelop or
XamarinStudio IDEs to write your C# code.
Building Unreal Engine from Source
- First, clone the Unreal Engine repo using Git. It
- Check out the 4.4 branch. You can do this by
can also use one of the git desktop applications if
git checkout 4.4
- Download the required 4.4 dependencies. There are
- Unzip these dependencies into the directory you
cloned the UrealEngine repo to. Be careful to make
sure the folders are merged together, not overwritten
(on Mac, this can be done by Option->dragging the
folder into the UnrealEngine directory, and clicking
"Keep Newer" when prompted).
- To build the source on Windows, you need Visual Studio
2013 installed. You can use the free version if you do not own
Studio Community 2013.
- Install the June 2010 DirectX runtime. This can be
- In the UnrealEngine folder (the directory you cloned the
repo into), run
should run quickly.
- Now you can open the Visual Studio Solution that you just
generated (it should be called
- Once Visual Studio has opened, set the solution
configuration to Development Editor, and set the platform to
Win64. Build the project by selecting Build from the
dropdown menu. This could take a while (up to 40 minutes,
depending on your system), so go ahead and take a break
here. Grab a coffee or something.
- You can then run the editor from Visual Studio by setting
the UE4 project as your startup project and pressing the green
triangle in toolbar (or pressing F5).
- Finally, you can setup your Windows shell so that you can
interact with .uproject files. Find the file
folder and run it. Now, you'll be able to double-click
.uproject files to load the project, or right click them
to quickly update Visual Studio files.
- Install Xcode 6.1. You can find this in the app
store, or here.
- From the UnrealEngine folder,
GenerateProjectFiles.command (if in
the finder) or
(if in the terminal). It should execute fairly
- Open the
- You can use this project to compule the UE4
Editor. Select the correct target in the top left of
the window (it should be UE4Editor - Mac, targeted for
My Mac). Then, build the project by going
Product -> Build For -> Running in the
menus. This can take a while (up to 40 minutes), so
feel free to take a break and grab a coffee or
- After the project finishes compiling, you can run
the editor by going to
Product -> Run in
Adding Mono for Unreal Engine
After you've successfuly built Unreal Engine 4.4 from the source, you can add the Mono for Unreal Engine plugins. Here's how to do that:
- Download the Mono for Unreal Engine zip
page (if you haven't already). The file should be
- Extract the zip file into the UnrealEngine source
directory, again making sure that the folders are
merged, not overwritten, in the same way as
- You can then run the terminal commands in the
UnrealEngine directory (if using a desktop app, you
can launch a terminal/console window from the app with
the UnrealEngine repo selected):
This should create a new git branch called
"4.4-xamarin" with the Mono for Unreal
Engine patches applied and committed.
git checkout 4.4
git checkout -b 4.4-xamarin
git am Engine/Plugins/XamarinUE4/Patches/*
- You can now rebuild the Unreal Editor the same way
as you did before; the Mono for Unreal Engine
plugins and binding assemblies will be included
Installing the Xamarin Studio Addin
- Install Xamarin Studio (it can be downloaded from
- Switch your Xamarin Studio update channel to
Alpha, then download all updates. Mono for Unreal
Engine requires Xamarin Studio 5.6+ (or MonoDevelop
5.6+), which are both currently in Alpha. After
switching your update channel, allow Xamarin Studio to
download and install all updates.
- Open Xamarin Studio, and open the Add-in Manager.
- Click the "Install from file" button, browse to
select the file
Now that you have Mono for Unreal Engine and all
the dependencies installed, you can see how to get started by creating
a new project or adding C# to an existing project on