How to Install Sims 4 Mods

By Nilson Lee Last updated

To install Sims 4 mods, unzip the download, move the .package and .ts4script files into Documents/Electronic Arts/The Sims 4/Mods, then open Game Options › Other and turn on Enable Custom Content and Mods and Script Mods Allowed. Restart the game and your mods load.

That's the whole process. The rest of this guide is the detail that decides whether it works first time: where the folder actually is on your machine, why script mods are fussier than everything else, and what to check when a mod you installed correctly still doesn't show up. Mods work on PC and Mac only; EA doesn't support them on PlayStation or Xbox.

The five steps at a glance
#StepWhere
1Check the download before you install itCreator's page
2Open the Mods folderFile Explorer / Finder
3Turn on the two settingsGame Options › Other
4Extract and drop the filesMods folder
5Launch and confirm the mod loadedGame startup

Before you download

A little checking up front prevents most problems later. EA is clear that Maxis and EA don't pre-screen, endorse, or support any mods, and recommends downloading only from a trusted source or creator. For each mod, look for three things on the creator's page:

Download from the creator's own site, Patreon, or the platform they publish on, rather than a re-upload. Re-uploads are often out of date and you won't see the creator's fix notices. It's also worth copying your Saves folder somewhere safe before you add anything new.

Where the Mods folder is

The Mods folder lives in your user Documents folder, not where the game itself is installed. This trips up a lot of first-time modders who go looking in Program Files or the EA app's library.

Sims 4 Mods folder location
SystemPath
WindowsC:\Users\[your name]\Documents\Electronic Arts\The Sims 4\Mods\
macOSDocuments/Electronic Arts/The Sims 4/Mods/
Downloaded lots, rooms, households (Windows)…\Documents\Electronic Arts\The Sims 4\Tray\
Downloaded lots, rooms, households (macOS)Documents/Electronic Arts/The Sims 4/Tray/

If there's no Mods folder inside The Sims 4, EA says you can create one — name it exactly Mods. Launching the game once and closing it is the other common way to get the game to create the folder for you.

Note the second pair of rows. Lots, rooms, and households you download from other players are Tray files (.trayitem, .bpi, .hhi, .sgi, .rmi) and belong in the Tray folder. Put them in Mods and the game won't find them.

Turn on the two settings

Dropping files in the folder isn't enough on its own; the game also has to be told to load them. Both switches are in the same place.

  1. Launch The Sims 4 and open Game Options from the main menu.
  2. Select the Other tab.
  3. Tick the two boxes in the table below.
  4. Click Apply Changes, confirm the warning, then fully close and relaunch the game.
Settings in Game Options › Other
SettingWhat it controlsTurn it on when
Enable Custom Content and ModsWhether the game loads anything from the Mods folderAlways, if you use any mods or CC
Script Mods AllowedWhether the game runs .ts4script filesWhen any mod you use includes a script file

The game switches mods off again after every update. If your mods vanish after a patch, this screen is the first place to look.

Extract and drop the file

Most mods arrive as a .zip or .rar archive. The game can't read archives, so EA's instructions are to unzip the download first and move the files inside into Mods. On Windows, right-click the file and choose Extract All; on a Mac, double-click it. For .rar files you'll need an extraction tool that supports the format.

After extracting, you should see one or more of these: .package files, .ts4script files, or both. Move all of them into the Mods folder (or a subfolder — see the next section). If the archive contains a readme, keep it somewhere outside Mods so it doesn't clutter the folder. When you're updating a mod, delete the old files first rather than copying the new ones over the top; duplicates of the same mod are a common source of errors.

Script mods vs. package files

The two file types follow different rules, and mixing them up is a common reason a correctly installed mod doesn't run.

.package vs .ts4script
.package.ts4script
Used forCC (hair, clothes, objects) and many gameplay changesMods that add new code
Needs Script Mods AllowedNoYes
Max folder depthFive subfolders (default Resource.cfg)One subfolder
Mods folder depth rules Script mods work directly in Mods or one subfolder down, such as Mods/MCCC. A script mod two folders down, such as Mods/Script Mods/MCCC, is not loaded. Package files can be up to five folders deep. The Sims 4/ Mods/ MCCC/ mod.ts4script loads — 1 folder deep Script Mods/MCCC/ mod.ts4script ignored — 2 folders deep .package files: fine up to 5 folders deep
Script files are only read one folder below Mods. Example paths from Deaderpool's MC Command Center install instructions.

MC Command Center's creator puts it plainly: "The Sims 4 will only go one-level deep when looking for script mods", so The Sims 4\Mods\MCCC is fine but The Sims 4\Mods\Script Mods\MCCC is not. A script mod usually ships with a matching .package; keep the pair together in the same folder so you don't end up with half a mod loaded.

Package-only CC is more forgiving. The game's default Resource.cfg file, which sits in the Mods folder, tells it to look for .package files up to five folders deep, so folders like Mods/CC/Hair/Long work. Don't delete or edit Resource.cfg unless you know what each line does.

When the mod doesn't show up

Work through this list in order. Each check rules out one cause.

  1. Is it in the startup list? When mods are on, the game shows a pop-up at startup listing every mod it loaded (unless you've unticked Show at Startup). If yours isn't there, the game never saw the file — go back to the folder and archive checks.
  2. Are both settings on? Updates switch them off. Re-tick them in Game Options › Other and restart.
  3. Is a script mod too deep? Move its folder so the .ts4script file is in Mods or one folder below.
  4. Is it still zipped? An archive sitting in Mods does nothing. Extract it and remove the archive.
  5. Is it a Tray file? Lots, rooms, and households go in Tray, not Mods.
  6. Is it outdated? EA says error code 110 usually means outdated mods after an update, and codes 102, 123, 125, 127, 129, or 131 point to a script problem — often a script mod. Check the creator's page for a new version.

If you have a lot of mods and can't tell which one is at fault, EA recommends the 50/50 method: remove everything, add mods back in batches, and launch after each batch. When the problem reappears, halve that batch and repeat until you've found the file. Remove gameplay and script mods before custom content, because EA notes they're more likely to cause issues.

FAQ

Do I need to unzip Sims 4 mods?

Yes. EA's install instructions say that if a mod comes as a .zip or .rar file, you need to unzip it first. The game loads .package and .ts4script files, so extract the archive and move what's inside into the Mods folder. Deaderpool's MC Command Center instructions say the same thing in capitals: unzip all zip files.

Can I use subfolders in the Mods folder?

Yes, with a depth limit that depends on the file type. Script mods are only read one level deep: Mods\MCCC works, Mods\Script Mods\MCCC doesn't. Plain .package files can go deeper — the default Resource.cfg file the game uses reads them up to five folders down.

What should I do when mods stop working after an update?

Re-enable them only after they're confirmed compatible. EA turns mods off on every update. Launch the game with mods still off to make sure it runs, exit without saving (EA warns that saving before re-enabling can remove content from your save), update any mod whose creator has posted a new version, then tick Enable Custom Content and Mods again and restart.

Can installing mods get my account banned?

EA's published mods policy doesn't list any penalty for players who install mods. The policy says EA "make[s] it easy for you to install and use Mods in The Sims 4", and its rules are aimed at creators: mods must be free, can't use EA trademarks, and EA can act against mods that are harmful or break the User Agreement. The bigger practical risk is a broken save, so back up your Saves folder first.

← Back to the Sims 4 mods hub

Sources we checked