How to add mods to a Satisfactory server

Satisfactory mods come from ficsit.app, the community mod repository, and run on the Satisfactory Mod Loader (SML). Coffee Stain doesn’t make or support them, but the modding community keeps them working with each update. On your server, install mods from the Mods tab in one tap. Every player then needs the same mods on their PC.

How Satisfactory mods work on a server

• The server needs the mod loader and the server version of each mod.
• Not every mod supports dedicated servers. On ficsit.app, a mod that does has a check mark under Server in its latest version.
• Every player needs the same mods, at the same versions, or they can’t join.
• Some mods only matter on one side. A mod that changes your own screen may only be needed on players’ PCs.

Install mods from the Mods tab

1. Open your server in the panel and go to Mods.
2. Search for a mod by name. Only mods that work on a dedicated server are offered.
3. Tap install. The panel shows what it will add, including any mods it depends on.
4. Confirm. We make a backup first, then install it. The first mod also installs the mod loader.
5. Restart the server when the panel asks, so the mod turns on.

You can install mods while the server sleeps. They turn on the next time it starts.

Mods never update on their own, because updates can break saves. When an update is out, the Mods tab shows it with its changelog. Update when your whole group is ready.

What your friends need

Each player installs the same mods on their PC with Satisfactory Mod Manager (SMM), which you can get from smm.ficsit.app.

1. In SMM, make a profile for your server, like assembly.
2. Add the same mods your server has. The What your friends need card in Mods lists them.
3. Export the profile and send the file to your friends.
4. Each friend imports it in SMM, then starts the game from SMM.

When the mods and versions match, friends join the usual way from the Server Manager.

Install with Satisfactory Mod Manager over SFTP

If you already use SMM, it can manage your server too. It connects with SFTP (a safe way to send files).

1. Stop the server from Overview. A running server locks its mod files.
2. Open Files and find the SFTP card. It shows the host, port 2022, your username and password.
3. In SMM, open Manage Servers under Other and add a server with those details.
4. For the path, use the folder that holds FactoryServer.sh.
5. Pick the server from SMM’s game list, then install mods as usual.
6. Start the server from Overview.

Install mods by hand

The modding team doesn’t support manual installs, and we don’t recommend them. If you must:

• Mods go in FactoryGame/Mods/ on the server.
• Use the Linux server build of each mod from ficsit.app, plus every mod it depends on, plus SML.
• Never copy the Mods folder from your PC. PC builds don’t run on the server.

Upload the files in Files or over SFTP while the server is stopped.

Mod settings and new saves

• Mod settings. Some mods keep settings in a config file. Set them up in your own game first, then copy the file to the same place on the server. Mismatched settings can cause odd problems.
• Options chosen at save creation. Some mods ask for choices when you make a new game. Make the save on your PC, then upload it. See Satisfactory backups and saves.

Game updates and mods

After a big Satisfactory update, many mods stop working until their authors catch up. A broken mod can stop the server from starting.

• Before a big update, pin your game version in Settings. Your server then stays on the version your mods support.
• Unpin it once the mods you use show the new version on ficsit.app.
• Update the mods from Mods and your friends’ SMM profiles at the same time.

If the server won’t start after a mod change

1. Open the Console. If the crash helper recognises the problem, follow its fix.
2. Remove the mod you added last from Mods, then start again.
3. Still stuck? Restore the backup we made before the install, from Backups.

More fixes are in Fix common Satisfactory server errors. Mods also use more RAM, so check performance tips before adding big ones.