Free AI Mod Tool — The Sims 4

Your mods are crashing.
Hypatia fixes that.

hySims scans your entire mod folder, finds version conflicts, broken scripts, and crash-causing files — using AI and a community-built conflict database. Free forever.

⬇ Download Free Read the Docs
10,500+Mods supported
AI-PoweredConflict detection
Free ForeverFor the community
Hypatia Sims 4 AI mod assistant
What hySims Does
Everything your mod folder needs
🔍

AI Conflict Detection

Hypatia reads your mod list against a live database of known conflicts and uses LLM reasoning to flag version mismatches, broken scripts, and incompatible packages.

🧬

Binary Search Mode

Can't find the culprit? Guided binary search splits your mods in half each round — find the crash-causing file in log₂(n) game launches, not days of manual testing.

📚

Known Conflicts Database

Offline-first library of curated conflict pairs built from community discoveries. Works without internet. Updates automatically from GitHub on every launch.

🔄

Auto Updater

Checks GitHub on every launch. New version available? A progress bar appears, it installs, and the app reboots — completely automatic. Always on the latest build.

📋

Exception Log Parser

Reads your lastException.txt and translates Python tracebacks into plain English — including which mod caused it, what version you need, and where to get it.

🦉

Hypatia AI Backend

Connect to Hypatia's server for deep AI analysis — mod version history, community fix suggestions, and natural language explanations of every conflict found.

How It Works
From crash to fixed in minutes
1

Point it at your Mods folder

hySims auto-detects your EA Sims 4 Mods path on Windows. Confirm and hit Scan.

2

AI scans every file

Scripts, packages, and tray items are indexed. Known conflicts flagged instantly from the local database.

3

Review your conflict report

Each conflict shows severity, the conflicting files, what version is needed, and where to get it.

4

Ask Hypatia anything

Paste your error or ask in plain English — the AI provides community-sourced solutions and mod history.

5

Back to playing

Remove or update the flagged mods. Launch Sims 4. Plumbob stays green. 💚

Hypatia scanning mods
Documentation
Everything you need to know

⬇ Installation

Requirements

  • Windows 10/11 — 64-bit. Mac/Linux: run from Python source.
  • The Sims 4 — any patch version. Works with EA App and Origin.
  • Bundled .exe — no Python needed for the standard download.

Download

# Recommended — bundled Windows .exe https://github.com/HuciferX/Sims4ModGuard/releases/latest # Download Sims4ModGuard-vX.X-windows.exe # Run from Python source (all platforms) git clone https://github.com/HuciferX/Sims4ModGuard.git pip install -r requirements.txt python gui_app.py

First Launch

Double-click the .exe. Windows may show a SmartScreen warning. Click "More info" → "Run anyway" — the source is fully public and open source.

💡

On first launch hySims checks for updates and shows a progress bar if a new version is available. It installs and restarts automatically.

🔍 Running Your First Scan

Auto-detected Mods path

C:\Users\YourName\Documents\Electronic Arts\The Sims 4\Mods\

If wrong, click Browse and select your folder manually.

Steps

  1. Launch hySims and confirm the Mods folder path
  2. Click Scan Mods
  3. Wait while hySims indexes every .package, .ts4script, and .tray file
  4. Review the conflict report when complete
⚡

Large collections (5,000+ mods) take 30–90 seconds on first scan. Subsequent scans are faster — unchanged files are cached.

📊 Reading Results

The report shows three severity levels:

BadgeSeverityAction
🔴 CriticalConfirmed crash causeRemove or update immediately
🟡 WarningResource conflictOne mod may override the other
🟢 InfoOutdated modUpdate for best compatibility

What to do with Critical findings

  1. Note the file path shown in the result
  2. Move it to a Disabled Mods folder — don't delete yet
  3. Launch Sims 4 and test
  4. Check the mod author's page for an updated version
⚠️

Always move rather than delete. Most conflicts are fixed by updating the mod to its latest release.

🧬 Binary Search Mode

If no known conflict is found but your game still crashes, Binary Search Mode finds the culprit via guided 50/50 elimination.

How binary search works

Each round cuts your mod collection in half. With 1,000 mods you find the bad file in ~10 game launches maximum instead of testing one by one.

# Example with 1,024 mods: Round 1: Test 512 mods → crashed → eliminate that half Round 2: Test 256 mods → no crash → switch to other half Round 3: Test 128 mods → crashed → eliminate half ... Round 10: Test 1 mod → crashed → FOUND IT ✓

Using it

  1. Click Binary Search in the toolbar
  2. hySims moves half your mods to _disabled/ automatically
  3. Launch Sims 4 — crash or no crash?
  4. Return to hySims and click Yes / No
  5. Repeat until 1 file remains
💡

All mods are fully restored automatically when binary search finishes. Nothing is permanently moved.

📚 Known Conflicts Database

The local database (known_conflicts.json) contains curated community-discovered conflicts. Works fully offline.

Mod AConflicts WithSeverity
NRaas MasterControllerMC Command CenterCritical
Scumbumbo TeleportAnySimPatch 1.100+Critical
TURBODRIVER WickedWhimsBaseGame scripts (old)Warning
Carl's Gameplay OverhaulSome Lumpinou modsWarning
Weerbesu UI CheatsOld patch versionsWarning

Found a new conflict? Submit a GitHub pull request — the community grows the database together.

🔄 Auto Updater

hySims checks GitHub Releases on every launch:

  1. A dialog appears with the new version number and changelog
  2. Click Update Now — progress bar tracks the download
  3. New version installs in place, hySims restarts automatically
# Version file: Sims4ModGuard/VERSION # e.g. "1.2" # Update check endpoint: GET https://api.github.com/repos/HuciferX/Sims4ModGuard/releases/latest
✅

The updater backs up your current install automatically before replacing it. Your conflict database and settings are always preserved.

🦉 Hypatia AI Backend

Connect to Hypatia's server for analysis beyond the local database:

  • Natural language — ask "why does MasterController conflict with MCCC?" and get a plain explanation
  • Version history — knows mod update timelines and what version you need for your patch
  • Community fixes — pulls from known fix threads and mod author release notes
  • Exception analysis — paste a lastException stack trace, get a diagnosis and fix
🌐

AI backend needs internet. The local conflict scanner and binary search work fully offline.

⚠️ Common Error Codes

Error in logLikely CauseFix
lastException: NRaasNRaas script conflictUpdate NRaas or remove MasterController
AttributeError: 'NoneType'Broken CC dependencyBinary search to isolate the broken file
IndexError TeleportAnySimOutdated Scumbumbo modRemove — use modern alternatives
gallery widget hangGallery UI bugSet playflowenabled=0 in Options.ini
Resource.cfg not foundBOM encoding issueSee resource.cfg section below

📄 resource.cfg Issues

A UTF-8 BOM (byte order mark) in Resource.cfg causes the game to silently ignore entire Mods subfolders — you can have 5GB of CC the game never loads.

Detect the BOM

python3 -c "print(open('Resource.cfg','rb').read(3) == b'\\xef\\xbb\\xbf')" # True = BOM found. hySims flags this automatically.

Fix in Notepad++

  1. Open Resource.cfg in Notepad++
  2. Encoding → Convert to UTF-8 (without BOM)
  3. Save. Relaunch Sims 4.
✅

hySims detects and offers to fix BOM encoding automatically — click "Apply Fix" in the scan warning banner.

🔧 Troubleshooting

App won't open

  • Check that antivirus isn't blocking the .exe — add an exception if needed
  • Right-click → Run as administrator on first launch
  • Install Visual C++ Redistributable if you get a DLL error

Scan finds nothing but game still crashes

  • The conflict may not be in the database yet — use Binary Search Mode
  • Enable the AI backend for deep analysis
  • Check lastException.txt and paste it into the Hypatia chat

Get help

Use the Hypatia chat bubble in the bottom-right corner of this page — she knows mod history and common fixes. Or open a GitHub issue with your patch version and lastException.txt.

Powered By
Hypatia AI

Meet 🦉 Hypatia — your AI mod companion

Hypatia is a full-stack AI system built for power users. She brings enterprise-grade analysis to the Sims 4 community — completely free.

The same AI managing research systems, code analysis, and complex data pipelines is here to keep your Plumbob green.

Mod version history — knows release timelines for 500+ popular mods

Natural language — ask in plain English, get plain English answers

Exception analysis — paste a crash log, get a full diagnosis

Community memory — learns from fix reports across the Sims community

FAQ
Common questions
Is hySims really free?▾
Yes — completely free. No paywalls, no subscriptions, no ads. The code is open source on GitHub and the AI backend is powered by Hypatia at no cost to you.
Will it delete my mods?▾
Never. hySims only reads your files during a scan. Binary search mode moves files to a _disabled subfolder inside your Mods folder — it never deletes anything. Everything is restored when finished.
Does it work with 10,000+ mods?▾
Yes — built and tested on a 10,500+ mod collection including TSR archives and the full NRaas suite. Binary search is designed precisely for large collections — more mods means even more time saved.
Which Sims 4 patches are supported?▾
All of them. The conflict database covers patches back to 1.80 and is updated as new patches break mods. The AI backend has knowledge of mod compatibility across patch history.
Can I contribute conflicts I've found?▾
Absolutely — that's how the database grows. Submit a pull request on GitHub with your conflict details in known_conflicts.json. Every contribution helps the whole community find crashes faster.
Does it work on Mac or Linux?▾
The .exe is Windows-only. Running from Python source works cross-platform — the scanner and conflict checker are platform-independent. Mac/Linux packaged builds are on the roadmap.
Hypatia
🦉 Hypatia ● AI Mod Assistant · Online