This guide covers how to install mods on your The Isle Evrima server, including UE4SS, .pak, and .lua mods.
For modding advice, leads on developers, or examples of what's possible when modding The Isle Evrima, your best bet is to search the internet broadly or ask in the Official The Isle Discord. As a disclaimer, certain mods that may require total system access are not expected to be supported in shared hosting environments, and may instead be suited to a VPS or dedicated bare metal machine.
General tips to consider before installing mods:
-
Make sure they're compatible with servers (UE4SS mods, .pak, or .lua). Client mods are NOT the same as server mods.
-
Only install one mod at a time and test to make sure it works. If it doesn't, then remove the files from your server.
-
Make sure the mod is compatible with your current server build and version.
-
While mods are normally server-side only for The Isle Evrima, in the event that a UE4SS mod is required to be installed on the SERVER and CLIENT. This means you would need the mod installed locally on all your players' games (including UE4SS) as well as the server itself.
Installing UE4SS
UE4SS modding is only supported on Windows Servers. The Isle Evrima also requires the experimental build of UE4SS, the stable v3.0.1 release will not load.
- Log in to Bropanel and
Stopyour server. - Switch your server to the Windows Server type using our Change Server Type guide.
- Download the latest experimental UE4SS release from GitHub. Make sure to grab the experimental build, not the regular release.
- Extract the downloaded
.zipfile on your PC. - Upload the extracted UE4SS files to
TheIsle/Binaries/Win64/. - Start your server.
If installed correctly, you should see a UE4SS.log file created in the TheIsle/Binaries/Win64/ue4ss folder after starting your server.
Installing Mods
- Obtain the mod files from the mod author (For Evrima, this is usually a private download link, paid product, or a build of your own).
- Extract the downloaded
.zipfile on your PC. - Upload your extracted mod folder to the location specified by the mod author.
- UE4SS mods go in
TheIsle/Binaries/Win64/ue4ss/Mods. For pak mods, useTheIsle/Content/Paks/LogicModsorTheIsle/Content/Paks/~mods, refer to any documentation from the author.
- UE4SS mods go in
- Restart your server.
Lua Mod Installation Example
Lua mods come in folders and typically contain the following file structure:
