.NET Core vs .NET Framework
Windows only

by Brian Gillespie (Last updated: Wednesday, March 5, 2025)

Rhino 8 uses .NET Core 7 by default.

On Windows, some older plug-ins will not run when .NET Core is active, and requires the legacy .NET Framework, instead.

To change Rhino to always use .NET Framework:

  1. Start Rhino for Windows
  2. Type the command SetDotNetRuntime
  3. Select the Runtime option
  4. Set the NETFramework option
  5. Close Rhino

To change Rhino to always use .NET Framework using the Registry:

  1. Run RegEdit
  2. Browse to HKEY_CURRENT_USER\Software\McNeel\Rhinoceros\8.0\Global Options
  3. Create a REG_SZ value named DotNetRuntime and set its data to netfx

To start Rhino in .NET Framework once:

Caution: only recommended if you have a plug-in that doesn’t run in .NET Core.

  1. Create a new shortcut for Rhino in Windows
  2. Edit the shortcut
  3. Add command line argument /netfx

To start Rhino in .NET Core once:

  1. Create a new shortcut for Rhino in Windows
  2. Edit the shortcut
  3. Add command line argument /netcore

.NET Core 8

Starting with version 8.12, Rhino can also optionally run using the .NET 8 Runtime. If .NET 7 is not available, Rhino will automatically attempt to use .NET 8 if installed.

Additionally, you can force Rhino to use .NET 8 with the steps below.

Please note that Rhino 8 does not currently support running on the .NET 9 (or later) Runtime.

Installing the .NET 8 Desktop Runtime:

In order to use .NET 8, you must first install the .NET 8 Desktop Runtime.

  1. Open your browser to https://dotnet.microsoft.com/en-us/download/dotnet/8.0
  2. Download the .NET Desktop Runtime for x64
  3. Run the downloaded installer to install the runtime.

To set the .NET Core version once:

  1. Create a new shortcut for Rhino in Windows
  2. Edit the shortcut
  3. Add command line argument /netcore-8

To set the .NET Core version using the Registry:

  1. Run RegEdit
  2. Browse to HKEY_CURRENT_USER\Software\McNeel\Rhinoceros\8.0\Global Options
  3. Create a REG_SZ value named DotNetCoreVersion and set its data to 8

For more details:

For more details, visit our developer documentation for .NET 7.