mob-sakai/CSharpCompilerSettingsForUnity is a C# project with 300 stars in the Backend space. Change the C# compiler (csc) used on your Unity project, as you like!
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
A good news! Unity 2020.2.0a12 or later now supports C# 8.0!
Many developers (including you!) have been eagerly awaiting support for C# 8.0.
C# 8.0 includes some features and some useful syntax-sugars:
Readonly members
Default interface methods
Pattern matching enhancements:
Switch expressions
Property patterns
Tuple patterns
Positional patterns
Using declarations
Static local functions
Disposable ref structs
Nullable reference types
Asynchronous streams
Asynchronous disposable
Indices and ranges
Null-coalescing assignment
Unmanaged constructed types
Stackalloc in nested expressions
Enhancement of interpolated verbatim strings
However, unfortunately, there are no plans to backport to Unity 2020.1 or earlier...
This package changes the C# compiler (csc) used on your Unity project, to support C# 8.0, C# 9.0 and more.
Let's enjoy new C# features with your Unity project!
Features
Easy to use.
This package is out of the box!
Change the C# compiler (csc) used on your Unity project.
Change the nuget package name.
Microsoft.Net.Compilers: Official compiler (default in legacy Unity, run on Unity built-in mono)
Microsoft.Net.Compilers.Toolset: Official compiler (default in modern Uniity, run on dotnet)
Resolve the issue #2
OpenSesame.Net.Compilers: Allows access to internals/privates in other assemblies (run on Unity built-in mono)
OpenSesame.Net.Compilers.Toolset: Allows access to internals/privates in other assemblies (run on dotnet)
Resolve the issue #2
Or, your custom nuget package
Change the nuget package version.
3.4.0: C# 8.0 Supported.
3.5.0: C# 8.0 Supported. (default in Unity 2020.2.0)
3.6.0: C# 8.0 Supported.
3.7.0: C# 8.0 Supported.
3.8.0 (preview): C# 9.0 Supported.
3.9.0: C# 9.0 Supported. (default in Unity 2021.2.0)
3.10.0: C# 9.0 Supported.
3.11.0: C# 9.0 Supported.
4.0.1: C# 10.0 Supported.
For other versions, see the nuget package page above.
Change the C# language version.
7.0
7.1
7.2
7.3
8.0 (default in Unity 2020.2.0)
9.0 (default in Unity 2021.2.0)
10.0 (latest)
Add the scripting define symbols based on language version on compiling.
e.g. CSHARP_7_3_OR_LATER, CSHARP_8_OR_LATER, CSHARP_9_OR_LATER ...
Change the C# compiler settings for each *.asmdef file.
Portability: The assembly works even in the projects that do not have this package installed.
The best option when distributing as a package.
Publish as Dll: Published dll works without this package.
Modify the scripting define symbols for each *.asmdef file.
Add/Remove specific symbols separated with semicolons (';') or commas (',').
The symbols starting with '!' will be removed.
e.g. SYMBOL_TO_ADD;!SYMBOL_TO_REMOVE;...
Modify langversion property in *.csproj file.
If dotnet is required, it will be installed automatically.
CompilerType.BuiltIn compiler option to disable this plugin.
Enable Logging option to display compilation log.
Nullable option to enable Nullable reference types (C# 8.0).
enable: The nullable annotation context is enabled. The nullable warning context is enabled.
Variables of a reference type, string for example, are non-nullable. All nullability warnings are enabled.
warnings: The nullable annotation context is disabled. The nullable warning context is enabled.
Variables of a reference type are oblivious. All nullability warnings are enabled.
annotations: The nullable annotation context is enabled. The nullable warning context is disabled.
Variables of a reference type, string for example, are non-nullable. All nullability warnings are disabled.
disable: The nullable annotation context is disabled. The nullable warning context is disabled.
Variables of a reference type are oblivious, just like earlier versions of C#. All nullability warnings are disabled.
Analyzer/Source Generator Packages option to analyze/generate your code on compile.
Unity doesn't support using your own C# compiler.
While this is possible, it is not something I would recommend, as we've not tested customer C# compiler versions with Unity.
Installation
Requirement
Unity 2018.3 or later
via OpenUPM
This package is available on OpenUPM.
After installing openupm-cli, run the following command
openupm add com.coffee.csharp-compiler-settings
via Package Manager
Find the manifest.json file in the Packages directory in your project and edit it to look like this:
To update the package, change suffix #{version} to the target version.
e.g. "com.coffee.csharp-compiler-settings": "https://github.com/mob-sakai/CSharpCompilerSettingsForUnity.git#1.0.0",
Or, use UpmGitExtension to install and update the package.
Usage
Configure C# compiler settings for the project
Open project setting window. (Edit > Project Settings)
Select C# Compiler tab
Set Compiler Type to Custom Package, to use custom compiler package.
Input Package Name, Package Version, Language Version for compilation.
See features section.
Press Apply button to save settings.
It will automatically request a recompilation.
The selected nuget package will be used for compilation.
Enjoy!
The project setting asset for C# Compiler will be saved in ProjectSettings/CSharpCompilerSettings.asset.
Configure C# compiler settings for *.asmodef file
Select a *.asmodef file
Turn on Enable C# Compilier Settings to configure.
Set Compiler Type to Custom Package, to use custom compiler package.
Input Package Name, Package Version, Language Version and Modify Symbols for compilation.
See features section.
Press Apply button to save settings.
Reload: Reload C# compiler settings dll for the assembly. Publish as dll: Publish the assembly as dll to the parent directory.
For C# 8.0 features
C# 8.0 features
samples
If you want to use the C# 8.0 features, set it up as follows:
Package Name: Microsoft.Net.Compilers
Package Version: 3.5.0 or later
Language Version: latest or CSharp_8
Some features required external library.
Async stream -> UniTask v2
Install to project.
Indices and ranges -> IndexRange
Download nuget package and extract it.
Import lib/netstandard2.0/IndexRange.dll to project.
Stackalloc in nested expressions -> System.Memory
Download nuget package and extract it.
Import lib/netstandard2.0/System.Memory.dll to project.
NOTE: Default interface methods feature is not available. It requires .Net Standard 2.1.
For C# 9.0 features
C# 9.0 features
samples
If you want to use the C# 9.0 features, set it up as follows:
Package Name: Microsoft.Net.Compilers
Package Version: 3.9.0 or later
Language Version: latest or CSharp_9
NOTE: Some features is not available. It requires .Net 5.
For C# 10.0 features
C# 10.0 features
samples
If you want to use the C# 10.0 features, set it up as follows:
Package Name: Microsoft.Net.Compilers.Toolset
Package Version: 4.0.1 or later
Language Version: latest or CSharp_10
NOTE: Some features is not available. It requires .Net 6.
Development Notes
How to update CSharpCompilerSettings
See installation section to update package
Click Project Settings > C# Compoler > Reload to reload all CSharpCompilerSettings_*.dll assemblies
For Unity 2021.1 or later
In Unity 2021.1 or later, the compile flow has changed significantly. (#11)
The source code must pass both the built-in compiler and the custom compiler.
Please use the CUSTOM_COMPILE directive as follows:
using System;
using NUnit.Framework;
namespace IgnoreAccessibility
{
public class IgnoreAccessibilityContent
{
private int privateNumber = 999;
}
public class IgnoreAccessibilityTest
{
[Test]
public void GetPrivateField()
{
#if CUSTOM_COMPILE
Assert.AreEqual(new IgnoreAccessibilityContent().privateNumber, 999);
#else
throw new NotImplementedException();
#endif
}
}
}
How to include the asmdef in Packages directory
By default, asmdefs under Packages and Assets/Standard Assets/ are NOT compiled with the custom compiler package.
This is to prevent unintended compiler changes and to minimize the impact of compiler changes.
Packages (and store assets) should essentially be compiled with the default compiler.
If you want to compile an embedded package or your custom package with a custom compiler, set Packages/your_package_name/ instead of !Packages/.
See #12 for details.
Contributing
Issues
Issues are very valuable to this project.
Ideas are a valuable source of contributions others can make
Problems show where this project is lacking
With a question you show where contributors can improve the user experience
Pull Requests
Pull requests are, a great way to get your ideas into this repository.
See CONTRIBUTING.md and sandbox branch.
Support
This is an open source project that I am developing in my spare time.
If you like it, please support me.
With your support, I can spend more time on development. :)
Does mob-sakai/CSharpCompilerSettingsForUnity have a project website?
No homepage URL was recorded for mob-sakai/CSharpCompilerSettingsForUnity in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
Is mob-sakai/CSharpCompilerSettingsForUnity open source?
Yes — mob-sakai/CSharpCompilerSettingsForUnity ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/mob-sakai/CSharpCompilerSettingsForUnity.
What else is in the Backend space?
mob-sakai/CSharpCompilerSettingsForUnity is tracked by TopGit under the Backend category, alongside 9 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is mob-sakai/CSharpCompilerSettingsForUnity?
mob-sakai/CSharpCompilerSettingsForUnity (mob-sakai/CSharpCompilerSettingsForUnity) is a C# project on GitHub. From the project's own README: Change the C# compiler (csc) used on your Unity project, as you like!
What license does mob-sakai/CSharpCompilerSettingsForUnity use?
mob-sakai/CSharpCompilerSettingsForUnity is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about mob-sakai/CSharpCompilerSettingsForUnity?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/mob-sakai/CSharpCompilerSettingsForUnity is the definitive source.
Why is mob-sakai/CSharpCompilerSettingsForUnity categorized under Backend?
TopGit places mob-sakai/CSharpCompilerSettingsForUnity in the Backend category based on its GitHub topics and description (tagged: "csc", "csharp", "csharp8"). Categories are assigned from real repository metadata, not editorial guesswork.
Read full README in the tab above.
Want a second opinion on CSharpCompilerSettingsForUnity?
Ask an AI that can read this page — one click and you get its take on CSharpCompilerSettingsForUnity.
/CSharpCompilerSettingsForUnity
mob-sakai 
