Tutorial The Basics of Modding in Zerahypt.

~[The Basics of Modding]~
​

Before we start making the mod, make sure that you've downloaded all the files from the sticky thread [Required Mod Assemblies].

Start Visual Studio & Start a new project.
(File>New>Project)

Make it a Visual C# Class Library file & name it to Mod_<Insert Name> (ex: Mod_DisplayText)
Then remove all the generated code from the class.

Spoiler: step 1

In order to implement any code into the game, we'll need a reference to the game engine's assembly.
These files can be found at ".../Zerahypt/Zerahypt_Data/Managed"

Since we're making a simple mod, we'll only have to add the UnityEngine & Mod Foundation DLL.
Right Click on References in the Solution Explorer>Add Reference

Spoiler: step 2

Remove all the code in ur class & replace it with the following:

PHP:

using System.Collections;
using UnityEngine;

public class <InsertClassName> : MonoBehaviour
{

}

Spoiler: step 3

Now we want to specify to the modloader that we want to run this script.
We do this by adding the [Mod_Instance] attribute from Mod_Foundation.

Spoiler: step 4

Now let's set the correct build settings.
Go to Project>Properties
> Make sure you know where the build location is set.
> Set the target framework to .NET Framework 2.0 (Unity uses this version)
> Save all the scripts
> Press F6 to compile the scripts to ensure that there are no errors.

Spoiler: step 5

Now lets add code to display text!
This goes in between the brackets of the class.

PHP:

    void OnGUI()
    {
        GUI.color = Color.red;
        string text = "Mod Loaded! :D";
        GUI.Label(new Rect(0, 0, Screen.width, Screen.height), text);
    }

Spoiler: step 6

Now rebuild/recompile the code & go to the output folder.
There should be a DLL file with the name of ur Mod.
Move this file into the Zerahypt/Zerahypt_Data/Mods/ folder.
Now run Zerahypt & let the magic happen!

Spoiler: step 7

 

@leddy231 @Gwonam
Thank you guys, I'll gradually make more complex mod tutorials!

 

PHP:

    void Awake() {
        DontDestroyOnLoad(this.gameObject);
    }

 

Yeah, but it's very annoying.
The documentation states that u need to use asset bundles.
But since they are quite outdated, you'd probably be better off using a custom library for it.
I'll see if I can make a tutorial for it =P

Great to see that people are also doing stuff :3

 

Sorry I don't know how you'd go about compiling a unityscript/javascript file.

 

Don't worry, it isn't that much different :o

 

Cool, can't wait to see the progress :3