A free, cross-platform desktop mod manager for The Sims 1, 2, 3 & 4 and The Sims Medieval.
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 1:
- 🎨 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.
- 🖼️ 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 sharing a file name are badged (duplicate installs are the most common real-world conflict).- 🧭 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) and they're copied into the right place.
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.
Bug reports, feature ideas, and pull requests are very welcome; see CONTRIBUTING.md. Good first stops:
- 📚 The Wiki: user guide & FAQ
- 🏛️ docs/architecture.md: how the app is put together
- 🎮 docs/adding-a-game.md: add support for a new game
Drag-and-drop install · .zip extraction · deep (resource-level) conflict
detection · SimCity support. 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.