The Sims Mod Manager

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:}

Features

• 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: .package files 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 .disabled suffix 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.cfg framework).
• Install: pick mod files (filtered to the game's real extensions) or drop files and folders straight onto the window; .zip, .rar and .7z archives 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 Exchange

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.}

Download

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

Supported games

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.

Building from source

Requires the Flutter SDK with desktop support enabled.

flutter pub get
flutter run -d windows   # or: -d macos / -d linux

Run the tests and analyzer with flutter test and flutter analyze. More detail in docs/architecture.md.

Languages

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.

Contributing

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

Thanks

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 waitUntilReadyToShow and not a frame later. Two evenings of staring at a solid white window, fixed in one message.
• wanderbyte, for spotting that bsdtar unpacks .rar/.7z through \\?\ 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 AppId and 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.

Roadmap

SimCity support · more games via the adapter system. See the open issues for what's planned and to suggest more.

License & disclaimer

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.