Sims 4 map replacements: what they change, and how custom content installs differently from a mod

A map replacement is a .package file that swaps the artwork The Sims 4 draws in map view for one world. Put it in Documents\Electronic Arts\The Sims 4\Mods and tick Enable Custom Content and Mods. It needs no script setting, and two replacements for one world conflict.

The folder path, the two settings and the post-patch disabling behaviour come from EA's own help pages. The description of what a map replacement overrides, and of what happens when two packages carry the same resource, is how package overrides work rather than a line read out of the game binary; it is labelled as such on the page.

Custom content is packages only, so the one-folder-deep rule that catches script mods does not apply to it.

Custom content and mods share a folder and nothing else. A map replacement is custom content in its simplest form: it swaps the art the game draws in map view for a world, adds no code, and needs only the master switch. A gameplay mod ships compiled Python, needs a second setting, and has a folder-depth rule that custom content does not.

The three file types and what each one needs

Sortable. This table is the whole difference between installing custom content and installing a mod.

File	What is inside	Needs Enable Custom Content and Mods	Needs Script Mods Allowed	Folder depth	How it breaks
`.package`	Game resources: meshes, textures, tuning overrides, interface and map artwork. No code.	Yes	No	No documented limit. Keep it shallow anyway so you can find things.	A patch reissues a resource the package overrides, or a second package overrides the same resource
`.ts4script`	A zip of compiled Python. The Sims 4 runs Python 3.7.	Yes	Yes	Top level of Mods, or exactly one folder deep	A patch moves the game code the script hooks, which raises and writes a last exception file
`.zip`, `.rar`, `.7z`	Nothing the game can read. It is a wrapper around the two above.	n/a	n/a	n/a	Always. Extract it first.

Two caveats on that table. The Python version is read from the local install of build 1.126.73.1030. The one-folder depth limit for script files is modding-community consensus rather than anything EA publishes; we looked for an EA page stating it and did not find one. It is repeated by every creator's install instructions and it explains the most common script mod failure, so treat it as the rule, but do not attribute it to EA.

What a map replacement actually replaces

The game draws map view from its own art resources. A map replacement is a package carrying those same resource keys with different artwork inside, so the game loads the mod's copy instead of its own. Nothing about the world changes underneath: the same lots sit in the same places with the same households, and no gameplay system is touched.

Two consequences follow from that, and both are how package overrides work rather than anything specific to maps. First, two packages that carry the same resource cannot both win, so two map replacements for one world will fight and you will get whichever the game happened to load, not a blend. Install one per world.

Second, an override is a copy frozen at the moment the creator made it. If a patch reissues the art, the game keeps loading the older copy, and the mod goes stale without ever throwing an error. The same mechanism shows up in the interface layer: UI Cheats Extension ships whole copies of the game's own interface movies, and its creator states directly that missing interface, graphical glitches on panels and freezing menus are always a mismatch between game version and mod version. Map art fails the same way and for the same reason, just less dramatically.

Installing custom content

Download from the creator's own page. Not a mirror, not a re-upload site.
Expected result: an archive, usually named for the set and its version.
Extract it. The game reads .package files. It cannot read a zip, a rar or a 7z.
Expected result: one or more loose .package files.
If it fails: an archive that will not open is normally a truncated download. Fetch it again from the same page.
Put the files in Documents\Electronic Arts\The Sims 4\Mods. Subfolders are fine for packages, and worth using so you can remove a set later.
Expected result: the files sit inside Mods.
If it fails: no Mods folder means the game has never been launched. Launch it once and close it; the game creates the folder itself.
Tick Enable Custom Content and Mods. Game Options, then Other, reachable from the main menu or in game.
Expected result: the box is ticked. Custom content needs only this one.
Restart the game completely. Quit and relaunch; reloading a save is not enough.
Expected result: the set appears in the game's own Custom Content list. A file that is not in that list was never read, which is a different problem from a file that loaded and looks wrong.

What breaks custom content

Symptom	Most likely cause	Fix
Nothing appears anywhere, and the game's custom content list is empty	Master switch off, or the files are still inside an archive	Extract, move into Mods, tick Enable Custom Content and Mods, restart
It worked yesterday and vanished after an update	The patch cleared the settings	Re-tick and restart. The files never moved.
The map is not the one you installed	Two packages overriding the same resource	Keep one map replacement per world. Delete the other and restart.
Artwork loads but looks wrong or partly stale after a patch	The package overrides a resource the patch reissued	Check the creator's page for an updated build. There is nothing to fix in the file yourself.
An item is in the game but its thumbnail is wrong or missing	Stale thumbnail cache	Delete `localthumbcache.package` from `Documents\Electronic Arts\The Sims 4` and restart. The game rebuilds it.
The package half of a mod works and its features do not	That mod also has a `.ts4script`, which needs the second setting and the depth rule	Tick Script Mods Allowed, move the script file to the top of Mods or one folder deep, restart

Custom content is not a cheat

A large share of searches that land on custom content are really after cheats. Custom content adds files the game draws. Cheats are commands the game itself registers and you type into the console; they need no install and no folder. The two overlap only in that both get called "mods" casually.

The console opens with Ctrl + Shift + C on Windows and on Mac. On a Mac that is the Control key, not Command, which is usually why a Mac player thinks the console is missing. On PlayStation and Xbox, hold all four shoulder buttons together instead, or press Ctrl + Shift + C if you have a keyboard attached. Console players also get a confirmation dialog before cheats switch on that desktop players never see.

testingcheats true Registered at server_commands.cheat_commands:22 in build 1.126.73.1030. Nothing on this page needs it; most cheats elsewhere on the site do.

The build-mode commands that unlock the game's hidden and debug objects, which people often file under custom content, are not registered in the game's Python at all. Their strings live in the game executable, which is a different kind of citation, so they are documented where that citation belongs rather than folded in here under a build stamp they do not qualify for.

Where the files come from

Every download destination on this site is the creator's own page. We describe custom content and link out; we never host a file, and we never link a re-upload site. That policy is not politeness. Of the nine creators studied for this directory, four forbid re-uploading their files in their own published words, and not one of them forbids a page like this one. Lumpinou's terms say not to re-upload on any other site or platform, and separately allow articles and other media with a link back. LittleMsSam's say not to upload those mods on any other site.

What "free" means here is set by EA rather than by us. The mods policy requires mods and custom content to be non-commercial and distributed free of charge; creators may take donations or run advertising on their own site, provided every user can access the file in full without paying. Paid early access to an unreleased build is common and permitted, and the public release is still free.

The 2026 Marketplace does not change that for anything you install by hand. The Sims Maker Program covers Create a Sim and Build/Buy items, which is exactly the custom content category, and content already published elsewhere is not eligible for sale through it. EA's own line is that the Marketplace does not replace free content and that mods and custom content published outside the program stay governed by the existing mods policy. Script mods cannot be sold through it at all.

The folder, both settings and the depth rule are covered in full at how to get mods in the sims 4, and the creator-by-creator download destinations are at sims 4 mods.

Consoles

There is nothing to install. The Sims 4 on PlayStation and Xbox loads no custom content, no packages and no script mods, and there is no folder or setting to change. Console players get the cheat console and the commands the game registers, which is a large set, but a map replacement is not among the things a console build can load.

Common questions

What is a Sims 4 map replacement?

A .package file that replaces the artwork the game draws for a world in map view, so the world you fly out to looks different while the lots, households and gameplay stay exactly as they were. It changes presentation only. It is custom content, not a script mod, so it adds no code and needs no script setting.

Can I install two map replacements at once?

Two replacements for the same world conflict, because both carry the game's own resource under the same key and only one copy can load. Two replacements for different worlds are fine. If a map looks like neither set you installed, you have two files fighting; delete one and restart.

Do map replacements need Script Mods Allowed?

No. Script Mods Allowed is a separate checkbox that exists for .ts4script files, which are compiled Python. A .package carries resources rather than code, so it needs only the master switch, Enable Custom Content and Mods. Ticking the script box does no harm; leaving it unticked will not stop custom content loading.

Why did my custom content vanish after a game update?

Because the update switched it off. EA disables mods and custom content while patching to limit problems, which clears the settings without touching your files. Re-tick Enable Custom Content and Mods, restart the game fully, and look again before concluding a package is broken.

What is the difference between custom content and a mod?

Custom content adds or replaces things the game draws: clothing, hair, furniture, world art. A mod changes how the game behaves, and gameplay mods usually ship a .ts4script alongside their package. The install folder is the same for both. The setting each one needs, and the way each one breaks, are not.

Can I use custom content on PlayStation or Xbox?

No. The console builds of The Sims 4 load no mods and no custom content of any kind, and there is no folder and no setting to change. Any site offering a console version of a Sims 4 map replacement is wrong. Console players get the cheat console and the commands the game itself registers.