Skip to content

Installation

Install Latest .NET SDK

You can get the typical SDK installation from Microsoft's official page

Download SDK

Latest

Install the latest SDK - it can compile patchers targeting any version, including older ones

Restart

It's usually a good idea to restart your computer after installing DotNet SDK to help things settle in.

Avoid SDK 10 if using Mo2

Mo2 is not interacting well with SDK 10 at the moment. Work is being done to help avoid the issue, but in the meantime, grab SDK 9.

Avoid install/uninstalling SDKs repeatedly

If after installing the .NET SDK as instructed above it doesn't work, try following this FAQ first

Runtime Is Not The SDK

  • .NET SDK -> Enables you to compile code (required for Synthesis to build patchers)
  • .NET Runtime -> Enables you to run the resulting exe patcher programs (or the Synthesis UI itself)

Be sure to install the SDK; The Runtime alone is not enough for Synthesis to compile patchers.

Optionally Install Runtimes

You can skip this step and wait to install a missing runtime when you see a patcher fail to run. This usually only happens when running an ancient patcher targeting ancient .NET versions.

Download .NET Runtimes

The Runtime is version-specific. A patcher compiled for .NET 8 requires Runtime 8 installed to run. This is why an ancient patcher might require some older Runtime in order to be executed.

Multiple Runtimes Can Coexist

You can have multiple .NET Runtimes installed simultaneously without conflicts. Install whichever versions your patchers require.

Download Synthesis UI

To download Synthesis itself, go is the GitHub release section

Download Synthesis UI

On the latest release, download just the Synthesis.zip file. The other files are not needed.

Unzip the archive somewhere you like

Unzip All Files

Make sure you bring along ALL the files within the zip, not just Synthesis.exe

Dedicated Folder

The app will create a few files nearby itself, so it is good to put it within its own folder.

Run Synthesis

You're ready to run Synthesis!

Showcase

Are You a User?

Be sure to read the rest of the wiki for how to use the app.

Typical Usage

SDK Problems?

Perhaps the SDK installation had some issues. Check out the FAQ on the topic

Are You a Developer?

There are a lot of resources on how to get started creating a patcher

Create a Patcher