How to Install Sims 4 Mods
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.
| # | Step | Where |
|---|---|---|
| 1 | Check the download before you install it | Creator's page |
| 2 | Open the Mods folder | File Explorer / Finder |
| 3 | Turn on the two settings | Game Options › Other |
| 4 | Extract and drop the files | Mods folder |
| 5 | Launch and confirm the mod loaded | Game 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:
- Game version. Mods built for an older patch may not work on the current one. Creators usually note when a mod is updated or broken.
- Requirements. Some mods need script mods turned on, a particular expansion pack, or another mod installed alongside them.
- Install notes. If the creator gives specific instructions, theirs override any general guide — including this one.
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.
| System | Path |
|---|---|
| Windows | C:\Users\[your name]\Documents\Electronic Arts\The Sims 4\Mods\ |
| macOS | Documents/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.
- Launch The Sims 4 and open Game Options from the main menu.
- Select the Other tab.
- Tick the two boxes in the table below.
- Click Apply Changes, confirm the warning, then fully close and relaunch the game.
| Setting | What it controls | Turn it on when |
|---|---|---|
| Enable Custom Content and Mods | Whether the game loads anything from the Mods folder | Always, if you use any mods or CC |
| Script Mods Allowed | Whether the game runs .ts4script files | When 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 | .ts4script | |
|---|---|---|
| Used for | CC (hair, clothes, objects) and many gameplay changes | Mods that add new code |
| Needs Script Mods Allowed | No | Yes |
| Max folder depth | Five subfolders (default Resource.cfg) | One subfolder |
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.
- 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.
- Are both settings on? Updates switch them off. Re-tick them in Game Options › Other and restart.
- Is a script mod too deep? Move its folder so the
.ts4scriptfile is in Mods or one folder below. - Is it still zipped? An archive sitting in Mods does nothing. Extract it and remove the archive.
- Is it a Tray file? Lots, rooms, and households go in Tray, not Mods.
- 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.
Sources we checked
- EA Help: How to install Mods in The Sims 4 — unzip, Mods folder, Enable Custom Content and Mods, console availability
- EA Help: The Sims 4 — Mods, game updates, and error codes — mods disabled after updates, error codes, 50/50 method, Show at Startup
- EA Help: The Sims 4 Policy on Mods — mods must be free and non-commercial
- CurseForge Support: Downloading and Installing The Sims 4 Mods (PC Manual Guide) — full folder paths, Script Mods Allowed, Tray folder file types
- Deaderpool: MC Command Center installation — script mods are only read one folder deep
- Bank42n: Resource.cfg guide — default Resource.cfg reads .package files up to five folders deep