R.E.P.O. Unity Project Setup

A guide for setting up your Unity Project to create mods for R.E.P.O.

This Unity workflow streamlines custom content creation.
By combining the REPOLib-Sdk Unity Editor package with the core REPOLib DLL, you can build mods entirely without writing code.

While REPOLib isn't strictly mandatory, it is highly recommended, especially if you are new to the R.E.P.O. modding scene.
For experienced developers, REPOLib is fully extensible, meaning you can still seamlessly integrate your own custom C# scripts alongside it.

NOTE

The Unity workflow is primarly needed for creating Enemies, Levels, Valuables and Items!

Setup the Unity Editor

• Unity Hub: Download & Install Unity Hub.
• Unity Editor: Install the Unity Editor version 2022.3.62f3.
• .NET SDK: Version 6.0 or higher. This is required for AssetRipper to Run.
• Git: Download & Install Git. This is required for installing packages via Git URL in Unity.

Unity Project Setup

1. Create a new Unity project with the following configuration (See image below):

   • Editor Version: 2022.3.62f3
   • Project Location: Local Project
   • Template: 3D (Built-In Render Pipeline)

2. In Unity at the Menubar go to Window > Package Manager.

3. Click the + button in the top left and choose Add package from git URL.

4. Paste all of the following Unity Package links one after another here:

   • Unity Project Patcher: Generates a Unity project from a game build so the game can be played in the editor.

     https://github.com/nomnomab/unity-project-patcher.git

   • Unity Project Patcher BepInEx: BepInEx handler for a Unity Project Patcher project.

     https://github.com/Kesomannen/unity-project-patcher-bepinex.git

   • Unity Repo Project Patcher: Game wrapper that generates a Unity project from R.E.P.O. build for in-editor play.

     https://github.com/ZehsTeam/unity-repo-project-patcher.git

Patching the Project

1. After successfully adding the three packages above, navigate to the Unity menu bar and click on Tools > Unity Project Patcher > Configs > UPPatcherUserSettings.

   

2. You will now see new options in the Inspector panel. Leave all the pre-filled fields as they are and only add the games folder path.

   

3. Next, return to the Unity menu bar and click on Tools > Unity Project Patcher > Open Window.

   

4. In the newly opened UPPatcher - RepoWrapper window, click on Enable BepInEx at the Bottom of the window and wait for the process to finish.

   

5. Once enableing BepInEx is complete, click on Run Patcher at the Top of the window to begin patching the project.

   

NOTE

This process WILL take a while and will restart the Unity Editor about 4-6 times.
At the very beginning, you will receive 4 Popups. You can safely click OK on each of them.

6. After the Editor restarts for the final time, a confirmation window will appear indicating the project has been successfully patched. Click OK.

   

Troubleshooting

If you do not see this window, the patching process has failed. Check the Unity Console for more information.

Now that you Unity Project is successfully patched, we recommend adding the REPOLib-Sdk to your project workflow to make the Workflow easier.