How to Install Mods on Your Windrose Server

Install UE4SS mods on your Windrose server by uploading the mod folder to the correct directory, registering the mod in mods.json, and restarting.

Upload the Mod Folder

1. Stop your server in the Game Panel
2. Download your mod from Nexus Mods or CurseForge and extract the .zip file on your computer
3. Open the File Manager in the Game Panel, or connect to your server via SFTP
4. Navigate to R5/Binaries/Win64/ue4ss/Mods
5. Upload the extracted mod folder. Upload the folder itself, not the contents or the original .zip file. If you do upload the zip though you’ll be able to extract it in the file manager.

Before moving on, open the uploaded mod folder and confirm it contains at least one of the following:

• A Scripts directory (Lua mods)
• A dlls directory and an enabled.txt file (C++ DLL mods)

If neither is present, the mod was likely extracted incorrectly or the folder structure is wrong.

Register the Mod in mods.json

1. In the File Manager, navigate to R5/Binaries/Win64/ue4ss/Mods
2. Open mods.json
3. Add a new entry for your mod inside the JSON array. Each entry follows this format:

{
    "mod_name": "<mod folder name>",
    "mod_enabled": true
}

The mod_name value must exactly match the folder name you uploaded. For example, if you uploaded a folder called BellLimits_Uncapped, the entry looks like this:

[
    {
        "mod_name": "BellLimits_Uncapped",
        "mod_enabled": true
    },
    {
        "mod_name": "CheatManagerEnablerMod",
        "mod_enabled": true
    },
    {
        "mod_name": "ConsoleCommandsMod",
        "mod_enabled": true
    }
]

4. Click Save

Restart and Verify

1. Restart your server from the Game Panel
2. Once the server is back online, open mods.txt in the same R5/Binaries/Win64/ue4ss/Mods directory
3. Find your mod in the list and confirm its value is 1 (enabled):

SplitScreenMod : 0
LineTraceMod : 0
BPML_GenericFunctions : 1
BPModLoaderMod : 1
BellLimits_Uncapped : 1

A value of 1 means the mod is active. A value of 0 means it’s disabled. If your mod doesn’t appear in mods.txt, double-check that the mod_name in mods.json exactly matches the uploaded folder name.