# How to Install Mods in The Sims 4

Source: https://bestsims4mods.com/how-to-install

Last updated: 2026-11-11

To install mods in The Sims 4, unzip the download and move the `.package` and `.ts4script` files into `Documents/Electronic Arts/The Sims 4/Mods` (same path on PC and Mac). Start the game, open Game Options > Other, tick **Enable Custom Content and Mods** and **Script Mods Allowed**, apply, and restart. Mods don't work on PlayStation or Xbox.

## Install a mod step by step

- **Download** from the creator's own page or CurseForge, and read the page for required libraries or packs.
- **Unzip.** The game can't read `.zip` or `.rar` files. On Windows right-click and choose Extract All. On a Mac double-click the file. Use 7-Zip for `.7z` or `.rar`.
- **Open the Mods folder.** Windows: `Documents\Electronic Arts\The Sims 4\Mods`, or under `OneDrive\Documents` if OneDrive backs up your Documents. Mac: in Finder press `Cmd` + `Shift` + `G` and paste `~/Documents/Electronic Arts/The Sims 4/Mods`. No Mods folder? Create one.
- **Move the files in**, following the folder rules below.
- **Turn mods on.** In the game: Game Options > Other, tick Enable Custom Content and Mods and, for any `.ts4script`, Script Mods Allowed. Click Apply Changes.
- **Restart the game.** The settings only take effect after a restart.

The folder is the same for the EA app and Steam versions, because it sits in Documents, not where the game is installed.

## Which file goes where

| You find | It goes in | Folder depth allowed |
| --- | --- | --- |
| `.package` | Mods | Up to 5 subfolders |
| `.ts4script` | Mods, next to its `.package` | Directly in Mods or 1 subfolder |
| `.trayitem`, `.bpi`, `.hhi`, `.rmi`, `.sgi` | Tray (households, lots and rooms, not Mods) | Keep an item's files together |
| `.zip`, `.rar`, `.7z` | Nowhere yet. Unzip first and delete the archive | - |
| `.exe` | Nowhere. A Sims 4 mod never needs to be run | - |

CurseForge's own example: LittleMsSam's Go for a Walk with More Pets comes as one `.ts4script` and one `.package`, and both go in Mods. Never unzip a `.ts4script`. The [script mods](/script-mods) page explains why those are different.

## Why the limit is 5 subfolders: Resource.cfg

The game keeps a small file called `Resource.cfg` in your Mods folder. It tells the game where to look for `.package` files. The default text, which we read in the game's program file for version 1.129.39, is `Priority 500` followed by six lines: `PackedFile *.package`, then `PackedFile */*.package`, and so on down to `PackedFile */*/*/*/*/*.package`. That is the Mods folder itself plus five levels of subfolders, and nothing deeper.

Leave `Resource.cfg` where it is, and keep your folders shallow: `Mods\MCCC`, `Mods\CC\Hair` and the like.

## Check that your mods loaded

- With mods on, the game shows a list of the custom content and mods it found when it starts. If your new mod is in the list, the game sees it.
- Not listed? The file is still zipped, too deep, or the settings above aren't ticked.
- Listed but doing nothing? A missing library, such as XML Injector or Lot 51 Core Library, or a version made for an older patch.
- EA says that list slows down loading. Untick **Show at Startup** on it once you trust your setup.

## After every game update

EA turns mods off after each update, because a mod that was fine before can cause problems after. EA's steps:

- Start the game with mods off and play a little in Live Mode to check it works.
- Exit with **Exit Game** and confirm, without saving. EA warns that Save and Exit before you re-enable mods can remove content from that save.
- Check each creator's page for a version made for the new patch, and replace old files.
- Re-tick Enable Custom Content and Mods, restart, and test.

Prefer one-click updates? The [CurseForge app](/curseforge) handles them for mods hosted there.

## FAQ

### Where is the Mods folder on Mac?

In `~/Documents/Electronic Arts/The Sims 4/Mods`. In Finder press `Cmd` + `Shift` + `G` and paste that path.

### Why are my mods not showing up?

Usually one of four things: the settings were not ticked and the game not restarted, the file is still zipped, a `.ts4script` sits more than one folder deep, or the game just updated and turned mods off.

### Can I install mods on PS5, PS4 or Xbox?

No. EA says mods are only available for PC and Mac. Console players can download households, lots and rooms from the Gallery instead.

### How do I uninstall a mod?

Close the game and delete the mod's files from the Mods folder, including its `.ts4script`. Back up your saves first if the mod stored data in them.
