Mono scripting back end
Mono is a stable, mature .NET runtime that provides a managed environment for the just-in-time (JIT) compilation of your C# code.
Read time 4 minutesLast updated 11 days ago
The Mono scripting back end is Unity's fork of the open source Mono project. Mono is a mature, cross-platform .NET runtime that powers Unity's Editor and Players on compatible platforms. It offers fast iteration and good tooling, but has lower runtime performance than IL2CPP and isn't aligned with the newest .NET features.
Mono uses just-in-time (JIT) compilation to convert your C# code into machine code at runtime. Mono manages the lifecycle of managed objects, handles code reload, and performs automatic garbage collection of out-of-scope objects with the Boehm-Demers-Weiser garbage collector. The garbage collector's behavior can be configured to some extent. For more information, refer to Garbage collection modes.
Mono supports the debugging of managed code. For more information, refer to Debugging C# code in Unity.
Building a project with Mono
To start the build process, open the Build Profiles window (Menu: File > Build Profiles) and select Build.
You can change the scripting back end Unity uses to build your application in one of two ways:
-
Through themenu in the Editor. Perform the following steps to change the scripting back end through the Player Settings menu:Player Settings
?
- Go to Edit > .Project Settings
?
- Click on the Player Settings button to open the Player settings for the current platform in the Inspector.
- Navigate to the Configuration section heading under the Other Settings sub-menu.
- Click on the dropdown menu, then select Mono.Scripting Backend
?
You can also open the Player Settings menu from the Build Profiles window; go to File > Build Profiles and click on the Player Settings tab. - Go to Edit >
-
Through the Editor scripting API. Use theproperty to change the scripting back end that Unity uses.
PlayerSettings.SetScriptingBackend
The Configuration section of the Player settings
Both the Mono and IL2CPP scripting back ends require a new build for each platform you want to target. For example, to support both the Android and iOS platforms, you need to build your application twice and produce two binary files, one for Android and one for iOS.
Domain reload
The Unity Editor embeds Mono, so your C# code is managed by Mono and is subject to Mono's constraints when running in the Editor's Play mode. A key aspect of this is that entering and exiting Play mode or recompiling scripts trigger AppDomain reloads, which resets static state. You can configure how Unity enters Play mode and turn off domain reloading to speed up iteration, but then your code must handle the reset of static state. For more information, refer to Enter Play mode without domain reload.
Optimizing Mono builds
Mono and IL2CPP use the same base .NET class library so many performance issues and best practices are applicable to both. However, in the Mono context consider the following:
-
The JIT compilation of Mono means that it can have lower runtime performance and longer startup time in large codebases compared to the AOT compilation of IL2CPP. Always profile with Unity Profiler to spot GC and JIT hotspots. The Project Auditor tool can also help you identify and fix common performance issues. For more information, refer to Optimization.
-
Certain coding practices, such as those that cause a lot of allocation at runtime, can increase the garbage collector overhead and degrade performance. For guidance on writing performant managed code in Unity, refer to Optimizing your code for managed memory. For information on tracking and reducing garbage collector overhead, refer to Managed memory.
-
Unity APIs are generally not thread-safe, which means they need to be called from Unity's main thread. Avoid using .NETwith Unity APIs.
Task- When dealing with inherently asynchronous and long-running operations, Unity provides the class as a more efficient alternative to .NET
Awaitable. For more information refer to Asynchronous programming with the Awaitable class.Task - For shorter-lived but more compuationally-intensive parallelized work, Unity provides the job system, which can be Burst compiled. For more information, refer to Write multithreaded code with the job system.
- When dealing with inherently asynchronous and long-running operations, Unity provides the
-
Mono's implementations of,
DateTime, andTimeZoneInfocan differ from Windows .NET behavior. Make sure to test globalized, culture-specific code on target platforms.CultureInfo
Optimizing runtime performance with Burst
In suitable projects, you can improve the runtime performance of your project by using the Burst compiler alongside Mono to compile compatible sections of your code to highly optimized machine code. For more information, refer to Burst compilation.