R.E.P.O. Unity Project Setup

A guide for setting up your Unity Project to create mods for R.E.P.O.
The Unity workflow is primarily needed for creating Valuables, Shop Items, Enemies, Levels and Cosmetics.

By combining the REPOLib-Sdk Unity Editor package with the core REPOLib DLL, you can build mods entirely without writing code. However, without any coding knowledge, you will be limited on what you can do.

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

OS-SPECIFIC STEPS

Parts of this guide differ between Windows and Linux. Make sure to install and use the correct options for your operating system.

Prerequisites

Download and Install the following:

• Git This is required for installing packages via Git URL in Unity.
• .NET SDK: Required for AssetRipper to run.
  • For Windows: Version 9.0
  • For Linux: Version 10.0
• Unity Hub
• Unity Editor 6000.3.17f1

NOTE

Make sure you have selected the Public branch on Steam!
The R.E.P.O. Project Patcher does not support Beta or other branches.

Unity Project Setup

1. Create a new Unity project with the following configuration:

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

   

2. Once Unity fully opens, navigate to the menubar and click Window > Package Management > Package Manager.
   Click the + button in the top left of the Package Manager, choose Add package from git URL... and install the required Unity Packages by pasting the following links one by one into the text field:

   

   WARNING

   If you had Unity open before installing git, it will complain about git not being installed.
   In this case, close Unity Editor and Unity Hub, and make sure they are actually fully closed.
   If nothing is working, try restarting your PC.

   Unity Project Patcher:

   Windows

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

   Linux

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

   Unity Project Patcher BepInEx:

   Windows

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

   Linux

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

   Unity REPO Project Patcher:

   Windows

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

   Linux

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

   Please make sure to only use these git links when setting up the R.E.P.O. Unity Project Patcher!

Run the Project Patcher

3. In the menu bar, click Tools > Unity Project Patcher > Configs > UPPatcherUserSettings:

   

   You will now see new options in the Inspector panel. Leave all the pre-filled fields as they are and only enter the path to your game folder:

   

4. Back in the menu bar, open the Patcher Window by going to Tools > Unity Project Patcher > Open Window:

   

5. In the newly opened UPPatcher - RepoWrapper window, click Enable BepInEx at the bottom of the window and wait for the process to finish:

   

6. Once BepInEx is enabled, click Run Patcher at the Top of the window to begin patching the project:

   

Expected patch behavior

• Fresh patch time: ~35-45 minutes.
• Unity will restart approximately 5-6 times during the process.
• Simply click OK on the 4 popups when prompted after starting the process.

Important for Linux Modders:

On Linux, you may see a similar "Fatal Error!" popup appear while the Patcher is running: DO NOT PRESS THE "Quit" BUTTON! This error will disappear on its own, so just ignore it.

After Unity restarts for the final time, a confirmation window will appear indicating the project has been successfully patched.

Patching process has failed or got stuck?

First, check the Unity Console for specific errors and verify that you've installed all Prerequisites.
If everything looks correct, join the R.E.P.O. Modding Server, acquire the Modder role from ≣ Channels & Roles, and ask for help in the #development channel.

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