Installing

For C# Solution

As .csproj

Go to the latest release, download the source code, and place it in your project folder. Add SUCC.csproj to your solution.

As .dll

Go to the latest release, download SUCC.dll and SUCC.xml, and place them wherever you keep your dlls. Add SUCC.dll as an assembly reference in your solution.

As Submodule

SUCC works well as a git submodule. Add SUCC as a submodule to your repository, then add SUCC.csproj to your solution. Use the master branch for the latest stable release and the master-dev branch for the latest commit.

For Unity

There are separate SUCC branches which contain a few features specific to the Unity game engine. See Version Differences for details. Please note that SUCC only officially supports Unity 2018.3+, and you must use .NET 4.x - .NET Standard 2.0 is not supported.

As .unitypackage

Go to the latest release, download SUCC.unitypackage, and import it to Unity using Assets -> Import Package -> Custom Package. You can also double click on the .unitypackage file with Unity open.

As Unity Package

SUCC supports the Unity Package Manager.

1. Open the file Your Unity Project/Packages/manifest.json
2. Add the following line to the "dependencies" array: "com.jimmycushnie.succ": "https://github.com/JimmyCushnie/SUCC.git#unity-package-manager",. Make sure you do NOT have a comma at the end of the line if it is the last entry in the list. Unlike SUCC, json is quite picky about file formatting.
3. open Unity and let it download the package.

If SUCC was installed successfully, you will see it in the list of packages when you open the package manager window in the Unity editor.

This will download the latest stable release. Use the unity-package-manager-dev branch if you'd like to download the latest commit.

As Submodule

Add SUCC as a submodule to your repository. The location of the submodule should be in your project's Assets folder. Use the unity branch for the latest stable release and the unity-dev branch for the latest commit.