Version: 2021.3
Stable scripting runtime: known limitations
C# compiler

Referencing additional class library assemblies

If your Unity project uses a part of the .NET class library API that Unity doesn’t compile by default, you can provide the C# compiler with a list of additional assemblies to reference during compilation. The behavior depends on which .NET profile the project uses. For more information, see .NET Profile support.

.NET Standard profile

If your project uses the .NET Standard profile, all parts of the .NET class library API are referenced by default. You can’t reference additional assemblies. If part of the API seems to be missing, it might not be included with .NET Standard. Try using the .NET Framework profile instead. To avoid compilation problems when you change profiles, see Switching between profiles.

.NET Framework profile

By default, Unity references the following assemblies when you use the .NET Framework profile:

  • mscorlib.dll
  • System.dll
  • System.Core.dll
  • System.Runtime.Serialization.dll
  • System.Xml.dll
  • System.Xml.Linq.dll

To reference any other class library assemblies, use a csc.rsp file: a response file that contains a list of command line arguments that you can pass to the C# compiler. To use a csc.rsp file, follow the below instructions:

  1. Create a file named csc.rsp in the Assets folder of your Unity project.
  2. Move any assembly files you want to reference into the Assets folder of your project, if they aren’t already in this folder.
  3. Populate the csc.rsp file with command line arguments for the assemblies you want to reference.

For example, if your project uses the HttpClient class, which is defined in the System.Net.Http.dll assembly, the C# compiler might produce this initial error message if the assembly isn’t present:


The type `HttpClient` is defined in an assembly that is not referenced. You must add a reference to assembly 'System.Net.Http, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'.

To resolve this error, add a csc.rsp file that contains the following command line argument to the project:


-r:System.Net.Http.dll

Add a new line with the appropriate command line argument for each assembly you want to reference.

Switching between profiles

When you use a csc.rsp file to reference class library assemblies and you change the .NET profile, you might experience compilation problems.

If you change the .NET profile from .NET Framework to .NET Standard and your csc.rsp file references an assembly that doesn’t exist in the .NET Standard profile, then compilation fails. To solve the issue, edit the csc.rsp file to remove any references to assemblies that are exclusive to the .NET Framework profile before you change the .NET profile to .NET Standard.

Stable scripting runtime: known limitations
C# compiler