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
.zipor.rarfiles. On Windows right-click and choose Extract All. On a Mac double-click the file. Use 7-Zip for.7zor.rar. - Open the Mods folder. Windows:
Documents\Electronic Arts\The Sims 4\Mods, or underOneDrive\Documentsif 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 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.
Skip the Mods folder. Start the life now.
Free in your browserPlay in my browserCheck 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 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.
