Installing

This page is for players. To write mods, install this first, then see Your first mod in C# or Your first mod in VB.

What you need

• Forza Horizon 2 through Azimuth, the 24 November 2015 build everyone plays.
• The .NET 10 runtime (x64), for hosted mods and scripts. On that page, get .NET Desktop Runtime or .NET Runtime, Windows x64. NativeAOT mods (a single DLL in fh2-mods\) don't need it.

The release zip already includes the FH2 Mod Platform 2.8.0 (DWrite.dll).

Install

1. Download FH2ModPlatform.NET-v<version>.zip from Releases.
2. Close the game.
3. Extract the zip into your Azimuth folder: the one with azimuth.exe. Say yes to replacing DWrite.dll if you already have the platform.

You now have:

azimuth.exe
DWrite.dll                        the FH2 Mod Platform
fh2-mods\FH2DotNet.dll            runs .NET mods
fh2-mods\dotnet\                  the SDK, the script compiler and the console

The examples\, sdk\ and license files in the zip aren't needed to play. You can leave them out.

Installing a .NET mod

The mod comes as	Put it in
A folder with <Name>.dll and other files (a hosted mod)	fh2-mods-dotnet\<Name>\, next to fh2-mods (create it the first time)
A single <Name>.dll (a NativeAOT mod)	fh2-mods\, like any C++ mod
A .cs or .vb file (a script)	fh2-mods-dotnet\scripts\

Don't install the same mod both ways, or it loads twice.

Check it works

Start the game, then open MODS > Installed mods > Platform.NET. Its Hosted .NET mods page lists every .NET mod with its version and status.

Press ~ (the key left of 1) to open the console, which shows fh2-mods\platform.log as it's written.

Turning mods off

• One hosted mod: rename its folder to <Name>.disabled.
• One script: rename it, to MyScript.vb.off say.
• All hosted mods: turn off Platform.NET on the MODS tab.
• A NativeAOT mod: on the MODS tab, like any other mod.

Uninstalling

Delete fh2-mods\FH2DotNet.dll, fh2-mods\dotnet\ and fh2-mods-dotnet\. Keep DWrite.dll if you use other platform mods.

Something wrong? See Troubleshooting.