A free, cross-platform desktop mod manager for The Sims 1, 2, 3 & 4 and The Sims Medieval.
Visit the website → · Follow on Tumblr
Browse, install, enable/disable, and clean up your mods and custom content for every mainline Sims game (and The Sims Medieval), in one app, with a UI that re-themes itself to match the game you're managing.
The UI re-themes per game. Here's the same library managing The Sims 2:
Every palette comes in a dark version too, following your system or your own pick:
- Per-game themed UI: the whole app re-tints as you switch between The Sims 1, 2, 3, 4 and Medieval, complete with the classic Sims 1 UI sounds, in light or dark.
- Real thumbnails & insights:
.packagefiles are parsed (DBPF) to pull out embedded artwork and a content breakdown (CAS parts, textures, tuning...), so your library looks like a library, not a file list. - Library with search, category filters (Package/Script/Object/...), grid and list layouts, and live Total/Enabled/Disabled/Conflicts stats.
- One-click enable/disable: disabling renames the file with a
.disabledsuffix so the game's loader skips it; nothing is ever deleted. - Conflict warnings: enabled mods are badged when they share a file name, when two versions of the same mod are installed side by side, and when their packages actually share DBPF resource keys (the real thing: the game keeps whichever copy it loads last).
- Finds your folders for you: localized user folders ("Los Sims 3", "Die Sims 2", the Ultimate Collection), every install when a game exists more than once, and you can point at any folder manually.
- Mods-folder scaffolding: if a game has no mods folder yet, the app
creates it with the files the game needs (e.g. the Sims 3
Resource.cfgframework). - Install: pick mod files (filtered to the game's real extensions)
or drop files and folders straight onto the window;
.zip,.rarand.7zarchives are unpacked for you, keeping their folder structure and skipping readmes and screenshots. - The Exchange: a mod shop inside the app. Browse the whole catalog, filter by game, install in one click, and get an Update button when a creator ships a new version of something you already have.
A mod's detail view: what's inside the package, where the file lives, and why it got flagged.
The app has its own mod shop, currently in alpha. Publishing is free at the creator portal, and what you publish shows up on everyone's shelves.
The shelves, filtered by game. Installing puts the file in the folder of the game the listing names, whichever game you're currently looking at.
A listing brings its screenshots and install notes along, and turns into an Update button once the creator publishes a newer version.
Grab the latest version from the Releases page. Free, no account needed.
| Platform | File | Notes |
|---|---|---|
| Windows (installer) | TheSimsModManager-x.y.z-windows-setup.exe |
Recommended. SmartScreen may warn (app isn't code-signed yet); choose More info → Run anyway |
| Windows (portable) | TheSimsModManager-x.y.z-windows-portable.zip |
Extract anywhere, run sims_mod_manager.exe |
| macOS | TheSimsModManager-x.y.z-macos.zip |
Signed & notarized by Apple. Unzip and drag to Applications |
| Linux | TheSimsModManager-x.y.z-linux-x64.tar.gz |
Extract, run sims_mod_manager |
| Game | Default mods location | Notes |
|---|---|---|
| The Sims | <install>\The Sims\Downloads |
Lives in the install folder, not Documents |
| The Sims 2 | Documents\EA Games\The Sims 2\Downloads |
Ultimate Collection uses its own folder name |
| The Sims 3 | Documents\Electronic Arts\The Sims 3\Mods\Packages |
Needs the Resource.cfg framework; the app creates it for you |
| The Sims Medieval | <install>\The Sims Medieval\Mods\Packages |
Lives in the install folder (Documents only holds saves); needs a Resource.cfg in the install root - the app creates it for you |
| The Sims 4 | Documents\Electronic Arts\The Sims 4\Mods |
Created by the game on first launch; enable CC/script mods in game options |
All of these are best-effort defaults: every game's folder can be overridden in Settings, which covers custom drives, localized folder names, OneDrive-relocated Documents, and Wine/CrossOver prefixes on macOS/Linux.
The core is game-agnostic by design: support for the SimCity series (and any other moddable game) can be added without touching the rest of the app. See docs/adding-a-game.md.
Requires the Flutter SDK with desktop support enabled.
flutter pub get
flutter run -d windows # or: -d macos / -d linuxRun the tests and analyzer with flutter test and flutter analyze.
More detail in docs/architecture.md.
The app (and the website) speak ten languages. English and Portuguese are mine; the other eight were done by simmers who actually play in them, which is why they use each scene's own modding slang instead of a dictionary translation:
| Language | Translated by |
|---|---|
| English | rodrifelix99 |
| 简体中文 | xiaoyu_sims |
| Español | marisol_plumbob |
| Português (Brasil) | rodrifelix99 |
| Français | clodesims |
| Deutsch | plumbobjonas |
| Italiano | giuliapixel89 |
| Русский | verasimka |
| Polski | kasia_pxl |
| 日本語 | mochi_simjp |
Spotted something that reads wrong in your language, or want to add one that isn't here? The strings live in lib/l10n (app) and web/src/i18n (website) - open an issue or a PR, credit included.
Bug reports, feature ideas, and pull requests are very welcome; see CONTRIBUTING.md. Good first stops:
- The Wiki: user guide & FAQ
- The Tumblr blog: news & release announcements
- docs/architecture.md: how the app is put together
- docs/adding-a-game.md: add support for a new game
A good chunk of this app exists because someone with more patience than me answered a question at a bad hour:
- bunsenpixel, who figured out that a macOS window keeps the material it was born with, so the blur has to be set inside
waitUntilReadyToShowand not a frame later. Two evenings of staring at a solid white window, fixed in one message. - wanderbyte, for spotting that bsdtar unpacks
.rar/.7zthrough\\?\paths and then leaves behind names the normal Windows API can't reach again, which is why a single deep archive was taking whole installs down with it. - mothcache, for the RefPack notes that got the DBPF parser reading compressed resources instead of shrugging at half the packages in my Mods folder.
- plumbtreemods, who knows exactly where every kind of Sims 1 file is meant to land, mesh-name prefixes for buyable clothing included. The Sims 1 routing rules are theirs, I only wrote them down in Dart.
- hexley_j, for the Inno Setup warning that stopped me changing the
AppIdand shipping an "upgrade" that installs itself a second time next to the old one.
And to everyone who reported a bug with a screenshot and their real folder layout attached: that saves more time than it looks like it does.
SimCity support · more games via the adapter system. See the open issues for what's planned and to suggest more.
The source is available for reading and contributing, but this is not an open-source license: the code may not be reused or redistributed. The app itself is free to download and use. See LICENSE.md.
The Sims Mod Manager is an unofficial fan project. It is not affiliated with, endorsed by, or sponsored by Electronic Arts Inc. or Maxis. The Sims, SimCity, and all related logos, artwork, and sounds are trademarks or copyrighted material of Electronic Arts Inc. and are used here for identification and interoperability only.