The Mods folder for The Sims 4 sits inside your Documents folder, not inside the game’s install directory. On a standard PC setup you’ll find it at DocumentsElectronic ArtsThe Sims 4Mods. Everything you place there, whether it’s a simple hair recolor or a full gameplay mod, gets scanned by the game each time it launches.
Two kinds of files live in that folder, and they don’t behave the same way: .package files and .ts4script files. Knowing the difference, along with a couple of rules about folder depth, will save you a lot of “why isn’t this working” moments.
Where the folder lives and what Resource.cfg does
If the Mods folder doesn’t exist yet, the game creates it the first time you launch with custom content turned on. Inside that folder sits a small text file called Resource.cfg. You didn’t create this file and you don’t need to edit it. It tells the game engine how to scan the folder tree underneath Mods, including how many levels deep to look. Leave it alone. If it ever goes missing or gets deleted by accident, the game writes a fresh copy the next time it starts, so there’s no need to back it up or hunt for a replacement online.
Package files vs script mods
A .package file is the format used for most custom content and most mods: new hairstyles, clothing, furniture recolors, tuning overrides, and so on. The game reads these as resources and swaps or adds content based on what’s inside. This covers the overwhelming majority of what people download.
A .ts4script file is different. It contains actual code, usually Python, that changes how the game behaves rather than just adding content. Mods that add new interactions, menus, or systems (big gameplay overhaul mods, command tools, that sort of thing) rely on this format. Many script mods ship with both a .ts4script file and a matching .package file in the same download, and you need both for the mod to work. The package often holds tuning data the script reads, so one without the other usually means broken or missing features.
How deep subfolders can go
This is the part people trip over most. Package files will load from subfolders up to five levels deep inside Mods. So something like ModsCCHairFemaleLongStylesfile.package is fine, that’s five folders down from Mods itself.
Script files are stricter. A .ts4script file only loads if it sits one folder deep inside Mods. That means ModsScriptModNamefile.ts4script works, but ModsScriptModNameCorefile.ts4script will not load, even though the game won’t throw an obvious error telling you why. The mod just quietly fails to do anything.
This single rule is behind a lot of “I installed it correctly but nothing happens” posts. If you like to nest everything by creator and category, keep script mods as the exception and pull them up to that first level.
Organizing your Mods folder without breaking things
There’s no official folder structure the game expects beyond the depth limits above, so you’re free to organize however makes sense to you. Two common approaches work well:
- By type: separate folders for
Hair,Clothing,Build Mode,Objects, andScript Mods. - By creator: a folder per creator, so updating or removing their content later is a one-step job.
Either way, the goal is being able to find and remove things quickly without digging through hundreds of loose files. This matters most when you’re troubleshooting: if the game won’t load or something’s acting strange, moving half your Mods folder out to a temporary location and testing in batches is far easier when things are grouped logically rather than dumped flat.
Keep packages within the five-folder limit and script mods within the one-folder limit, and the rest is just personal preference.
Script mods: keep the pair together, never unzip the ts4script
When a script mod comes as a zip file, it often contains both the .ts4script and a matching .package, sometimes inside their own subfolder. Extract that zip and drop the contents into Mods, but don’t go further and try to open or unzip the .ts4script file itself. It’s technically a zipped bundle of code internally, but the game expects it as a single, untouched file. Unzipping it apart breaks the mod and can also break version checks some mods use to warn you about outdated installs.
Just as important: don’t separate the script file from its package by sorting them into different folders during cleanup. If a mod ships both, they need to sit together, ideally in the same folder, so the game can match them up.
After adding or removing CC: clear the thumbnail cache and check your settings
Whenever you add or remove a batch of custom content, delete the file called localthumbcache.package, found at DocumentsElectronic ArtsThe Sims 4localthumbcache.package. This forces the game to rebuild thumbnails for Create a Sim and Build Mode. Skipping this step is a common cause of black, pink, or blank-looking swatches even when the content itself loads fine.
Finally, check two settings any time mods stop appearing after a patch or reinstall. In Game Options, under the Other tab, make sure both Enable Custom Content and Mods and Script Mods Allowed are switched on. These can get reset by game updates. Without both ticked, nothing in your Mods folder loads at all, packages or scripts, no matter how well-organized your folders are.
Questions people ask
Why isn’t my mod showing up in game even though it’s in the Mods folder?
Check that both “Enable Custom Content and Mods” and “Script Mods Allowed” are turned on in Game Options under Other, then check folder depth: packages can go five folders deep, script files only one.
Can I put all my custom content in one big folder?
For package files, yes, as long as you stay within five folder levels under Mods. Script mod files need to sit no deeper than one folder in, so keep those separate from deeply nested CC.
Is it safe to delete Resource.cfg from the Mods folder?
There’s no real reason to delete it, and you shouldn’t need to edit it either. If it ever disappears, the game writes a new one automatically the next time it launches.
What happens if I unzip a .ts4script file to see what’s inside?
The mod will stop working. The game expects that file untouched as a single .ts4script, and extracting it apart from its matching package breaks how the mod loads.
Browse all The Sims 4 mods on CrashMods