Sims 4 Mods Manager ✨

A lightweight desktop tool for organizing, enabling, and disabling your Sims 4 mod collection — without touching any game files manually.

---

Why This Exists

The Sims 4 Mods folder gets out of hand fast. Finding which mod broke your save, toggling CC packs for specific playthroughs, or keeping track of what you actually have installed — none of that has a built-in solution. This tool fills that gap.

---

Features

Mod Library

• Visual list of all installed .package and .ts4script files
• Sort by name, size, date added, or type
• Search and filter in real time

Enable / Disable

• Toggle individual mods or entire folders on and off
• Disabled mods move to a quarantine folder — no deletions, ever
• Batch toggle: disable all, enable selected, restore last session

Conflict Detection

• Flags duplicate tuning IDs across multiple packages
• Highlights mods that override the same game resource
• Export conflict report as .txt

Profiles

• Save your current mod loadout as a named profile
• Switch between profiles instantly (e.g. "Gameplay only", "Full CC", "Vanilla")
• Import/export profiles as .json

Metadata

• Reads mod descriptions embedded in package files where available
• Shows file size, last modified date, and load order index

---

Getting Started

Requirements:

• Windows 10 or 11
• The Sims 4 installed (any version — EA App or Origin)
• .NET Runtime 8.0 (download here)

Installation:

1. Download the latest release from the Releases page
2. Extract to any folder (do not place inside the Mods directory)
3. Run Sims4ModsManager.exe
4. On first launch, point the app at your Mods folder:

   Documents\Electronic Arts\The Sims 4\Mods\
   

---

Managing Your Mods

Adding mods:
Drop .package or .ts4script files into your Mods folder as usual — the app scans for changes automatically.

Disabling a mod:
Click the toggle next to any mod. It moves to Mods\_disabled\ and is ignored by the game.

Creating a profile:
File → Save Profile → Enter a name → OK
Profiles store exactly which mods are active at the time of saving.

Switching profiles:
Profiles → Load → Select profile
The app will enable/disable mods automatically to match the saved state.

---

Conflict Report Example

[CONFLICT] cas_top_shirt_v2.package
  Overrides resource: 0x034AEECB:00000000:000000001234ABCD
  Also overridden by: cas_tops_megapack.package

[CONFLICT] gameplay_pregnancy.package
  Overrides tuning: pregnancy_trimester_buffs
  Also overridden by: wicked_whims_core.package

---

Folder Structure After Install

Mods/
├── _disabled/       ← toggled-off mods live here
├── CC/              ← your existing subfolders stay untouched
├── Gameplay/
└── ...

The app never modifies .package files themselves — only moves them between Mods/ and Mods/_disabled/.

---

License

MIT — free to use, fork, and redistribute.