This guide covers how to install mods on your The Isle Evrima server, including UE4SS, .pak, and .lua mods.
The Isle Evrima modding scene is extremely niche. Most server-side mods are private, paid, or built and maintained by individual community members for their own communities. There is no standard community modding website, expect to either join a paying modded community, commission a developer, or write the mod yourself. Always back up your save before installing anything!
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.
- 1Login to the Game Host Bros Panel and
Stopyour server. - 2Switch your server to the Windows Server type using our Change Server Type guide.
- 3Download the latest experimental UE4SS release from GitHub. Make sure to grab the experimental build, not the regular release.
- 4Extract the downloaded
.zipfile on your PC. - 5Access your The Isle Evrima server using SFTP.
- 6Upload the extracted UE4SS files to
TheIsle/Binaries/Win64/. - 7Go to
ConsoleandStartyour 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
- 1Obtain the mod files from the mod author (For Evrima, this is usually a private download link, paid product, or a build of your own).
- 2Extract the downloaded
.zipfile on your PC. - 3Access your The Isle Evrima server using SFTP.
- 4Upload 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
- 5Start your server.
TheIsle/Binaries/Win64/ue4ss/Mods and TheIsle/Content/Paks/~mods are the most common folders, however some The Isle Evrima mods may require a different location. Please check the documentation for the mods you're downloading.
Lua Mod Installation Example
Lua mods come in folders and typically contain the following file structure:
Pak Mod Installation Example
Always follow the mod author's instructions. If a .pak mod says it needs to be installed into the LogicMods folder, place it there instead. ~mods is a folder made to keep your mods organized.