Getting Started

Getting Started

1. Download

Get the latest version from the Releases page:

Platform	File	How to run
Windows	…-windows-setup.exe	Run the installer. SmartScreen may warn (the app isn't code-signed yet) — click More info → Run anyway.
Windows (portable)	…-windows-portable.zip	Extract anywhere, run sims_mod_manager.exe.
macOS	…-macos.zip	Unzip, move to Applications. Not notarized yet — right-click → Open the first time, or run xattr -cr "/path/to/sims_mod_manager.app".
Linux	…-linux-x64.tar.gz	Extract, run sims_mod_manager.

2. First launch

Pick a game in the sidebar. The app tries to find that game's mods folder automatically — including localized folder names ("Los Sims 3", "Die Sims 2"), the Ultimate Collection, and multiple installs.

Three things can happen:

1. Folder found → your mods appear immediately.
2. Several candidates found → pick the right one from the list.
3. Nothing found → you get a setup screen where you can either point at a folder manually or let the app create the default folder for you — including framework files the game needs (e.g. the Sims 3 Resource.cfg).

You can change the folder any time in Settings → Mods folder → Change… This covers custom drives, OneDrive-relocated Documents folders, and Wine/CrossOver prefixes on macOS/Linux.

3. Game-side setup

• The Sims 4: enable mods in game options — Game Options → Other → Enable Custom Content and Mods (and Script Mods Allowed for script mods), then restart the game.
• The Sims 3: the Resource.cfg framework must exist — the app creates it if you use the "create folder" button.
• The Sims 1 & 2: no in-game switches needed.