Tools

How to get here: Click the Wrench icon in the sidebar.

The Tools page is a scrollable card-based hub with a responsive layout. Three breakpoints control the grid: small (under 700px, single column), medium (700-1100px, two columns), and large (over 1100px, three to four columns). All cards have 16px border-radius and generous padding (20-24px). Click a card to drill into its detail view; click the back button in the header to return to the hub.

---

Hub Layout

Hero Banner

Art-backed header ("Tools" title, "Manage, protect, and optimize your mods" subtitle) at the top of the page. Height scales by breakpoint: 100px (small), 130px (medium), 160px (large). Dark left-to-right gradient overlay for text readability.

Row 1: Primary Launcher Cards

Two or three large cards side by side (stacked on small). Each has a 3D tilt hover effect — the card tilts toward the cursor with a radial spotlight gradient following your mouse. Border highlights in the card's accent color on hover.

50/50 card — Scissors icon in a warm amber rounded square, "50/50" title, "Find the broken mod" subtitle. Below, four animated bisect progress bars demonstrate the halving concept:

• Round 1: 100% width (amber)
• Round 2: 50% width (amber)
• Round 3: 25% width (amber)
• Found it: 12% width (green)

Each bar animates from 0 to its target width with a staggered 0.15s delay. Footer text: "Isolate a broken mod in under 5 minutes."

Check CC card — Shield icon in a green rounded square, "Check CC" title, "Pre-install safety scan" subtitle. Below, a 6×2 grid of small squares where each cell shows either a green checkmark or a red X, animating in with staggered scale. 10 green (safe) and 2 red (flagged) cells demonstrate the scan concept. Footer text: "Scan files before you install them."

Game Link card (large breakpoint only) — Art-backed card with companion mod promo art, "Game Link" title, "Real-time game monitoring" subtitle. Has 3D tilt hover effect.

Row 2: Storage & Analytics

Storage & Sync card (wider, 3fr) — Archive icon, "STORAGE & SYNC" header. Reclaimable storage amount shown as a large bold number on the right (e.g. "39.9 GB"). Below, three clickable sub-rows separated by border lines:

• Backups — "Automatic mod snapshots"
• Cloud Sync — "Override tier"
• Manifest — "Export full mod list"

Hover lifts with shadow and accent border glow.

Analytics card (narrower, 2fr; appears at medium/large only) — Clock icon, "ANALYTICS" header with Override tier badge. Shows a mini 12-bar chart preview where bars increase in height left to right, the last bar highlighted in accent color. "View trends" link in accent color. At small breakpoint, Analytics appears in the secondary tools row instead.

Row 3: Secondary Tool Cards

Compact pill-style cards in a row (1-4 columns depending on breakpoint). Each has an icon, title, short description, and hover lift (-2px) with shadow and accent border glow.

Row 4: Discovery Cards

Only appears when the viewport is tall enough (over 520px). Three cards in a row at large, two at medium, stacked on small.

Discord card — Real SYVR server icon (48px circle from CDN), "SYVR Community" title, "7,500+ simmers · Get help, share finds" subtitle, "Join" link. Hover lifts with shadow.

Upgrade promo card — Only shows for Free and Decrypt users. "Unlock more tools — Profiles, Analytics, Cloud Sync."

SYVR Mods promo card — Art-backed, "Official mods, hosted on SimSweep", "Coming soon" in accent color. Shows at large breakpoint or when no upgrade card is needed.

---

Auto Sort

SimSweep can organize your Mods folder into a structured folder hierarchy based on what each file actually is.

How it works

After a scan, hit the Sort button. SimSweep classifies every file using its resource data and filename, then moves files into category folders:

• CC/ - CAS custom content, organized by type
  • Hair, Clothing (tops, bottoms, full body, shoes), Makeup (lipstick, eyeshadow, eyeliner, blush, eyebrows, eyelashes, etc.), Accessories, Skin overlays, Tattoos, Nails, Piercings, etc.
• Build Buy/ - Build/buy objects organized by subcategory
  • Furniture, Decor, Lighting, Surfaces, Storage, Rugs, Walls, Floors, Plumbing, Electronics, Outdoor, etc.
• Mods/ - Script mods and gameplay mods
• Animations/ - Pose packs and animation overrides

Smart classification

The sorter is smart about edge cases:

• Word-boundary matching - "Cheatable" won't match the "table" keyword and end up in Surfaces. "Decorator" won't match "deco" and land in Decor.
• CAS override - Files with "skintone" or "CAS_Columns" in the name stay in CAS even if the scanner detected them as Build/Buy.
• Known mod grouping - Multi-file mods that ship as several .package files stay together in their own folder.
• Pinned folders - Folders starting with ! (like !Essentials or !!Overrides) are treated as user-pinned and completely excluded from sorting.
• Script depth safety - .ts4script files never get sorted more than one folder deep. The Sims 4 engine won't load scripts from deeper paths, so the sorter protects against this.

Sort strategies

SimSweep offers multiple sort strategies:

• By Category - The default. Sorts into CC/Hair, CC/Clothing, Build Buy/Furniture, etc.
• By Creator - Groups files under creator folders based on detected creator names.
• Hybrid - Category folders with creator subfolders inside.
• Custom Rules (Override only) - Define your own rules with prefix, contains, regex, or creator match types. Drag-to-reorder priority. Rules persist between sessions.

Custom sort rules

Requires Override tier

Build your own sort rules with prefix, substring, regex, or creator matching. Each rule maps to a target folder. Drag to reorder priority. SimSweep validates rules before applying and saves them between sessions.

Sort reports

After sorting, SimSweep generates a sort report showing what moved where. Reports are saved and can be submitted to help improve the sorter.

---

50/50 Method

Requires Decrypt tier

The 50/50 method is the classic approach to finding a broken mod: split your mods in half, test, narrow it down, repeat. SimSweep automates the tedious part.

1. SimSweep splits your mods into two groups
2. One group stays active, the other gets temporarily moved aside
3. Test your game
4. Tell SimSweep whether the issue persists
5. It narrows down further based on your answer
6. Repeat until you find the culprit

This is way faster than doing it by hand because SimSweep makes smart splits based on what it knows about your mods (conflict groups, dependencies, risk levels).

---

Mod Profiles

Mod profiles let you save and swap between different mod configurations.

Creating a profile

1. Go to Tools > Profiles
2. Click Create Profile
3. Give it a name
4. Add files from your library (search, filter, and use Select All)

Switching profiles

Activating a profile parks all files that aren't in the profile and activates the ones that are. Deactivating restores everything.

This is useful for:

• Testing - Create a "minimal" profile with just the essentials to test if a problem is mod-related
• Gameplay styles - One profile for realistic gameplay, another for chaotic modded play
• Streaming - A clean profile without NSFW content

Add files modal

The Add Files modal has a search/filter bar and a Select All / Deselect All button. Select All works with the search filter, so you can search for "hair" and select all matching results at once.

---

Backups

SimSweep keeps backups of your script mods so you can roll back if something goes wrong.

Automatic backups

• On game launch (Decrypt) - Backs up script mods when SimSweep detects your game starting
• On save change (Decrypt) - Backs up when save files change
• Scheduled (Decrypt) - Set a recurring backup schedule in settings

Manual backups

Hit the backup button in Tools any time you want to snapshot your current setup.

Backup management

• Maximum 5 backups kept per mod (oldest get replaced)
• Backups older than 30 days are auto-cleaned
• Orphan backup directories get cleaned up on startup
• Restore from any backup point through the restore overlay

Access your backups folder from the Quick Actions section on the Home page or the Open Mods Folder link.

---

Quarantine

When you quarantine files (from My CC's selection bar or diagnostics), they get moved to a separate quarantine folder. The game can't load them, but they're not deleted.

Go to Tools > Quarantine to see everything you've quarantined:

• View all quarantined files with their original locations
• Restore individual files back to your Mods folder
• Delete files permanently from quarantine
• See when each file was quarantined and why

After quarantining from My CC, you get an 8-second undo window in case you change your mind.

---

Download History

Every CC file you've installed through the browser extension gets logged. Go to Tools > Downloads to see:

• Filename and source site
• Install verdict (clean, flagged, duplicate, etc.)
• Action taken (installed, ignored, quarantined)
• Color-coded status badges
• Paginated history with cursor-based loading

Useful for tracing where a problem file came from.

---

Cloud Sync

Requires Override tier

Cloud Sync saves your mod configuration to the cloud so you can restore it on another computer or after a fresh install.

What it syncs

• Your full mods manifest (filenames, hashes, sources, sizes)
• Device information
• Mod configuration

Settings

Go to Tools > Cloud Sync (or Settings > Advanced) to configure:

• Sync toggle - Enable/disable cloud sync
• Status card - Shows sync status and last sync time
• Device list - See all devices linked to your account, with remove confirmation
• Manual sync - Force a sync outside the automatic schedule
• Storage overview - How much cloud storage you're using

Snapshots

Snapshots are point-in-time saves of your mod configuration.

• Browse a timeline view of all snapshots with date, mod count, size, and diff badges showing changes
• Create a snapshot with an optional label
• Restore any snapshot through the Restore Wizard
• Delete snapshots you don't need

Restore Wizard

A four-step flow for restoring from cloud, snapshot, or shared manifest:

1. Source selection - Where to restore from
2. Mod review - See what will be restored, categorized into auto-restorable, manual download, and unavailable. Per-mod checkboxes let you pick and choose.
3. Restore progress - Real-time download bar with speed and ETA. Cancellable.
4. Summary - Success/fail/skip counts and manual download links for anything that couldn't be auto-restored.

Shared Manifests

Share your mod setup with other people.

My Shared Setups tab:

• Publish your manifest with a name, description, and mod selector
• Visibility toggle and privacy preview showing exactly what data gets shared
• Copy a share code to send to others
• Unpublish when you're done

Import a Setup tab:

• Enter a share code to preview someone else's setup
• Review what's included before importing
• Import opens the Restore Wizard at the mod review step

---

Folder Manifest

Requires Override tier

Export your entire mod setup as a .simsweep-manifest file. It's a portable snapshot of your mods folder: filenames, hashes, sources, sizes, and enabled/disabled state.

• Export your manifest to share with friends or keep as a backup reference
• Import someone else's manifest to see what they're running. The import process compares by file path first, then by hash, and shows you what matches and what's different.
• "Show in Explorer" button to open the manifest file location

---

Personal Analytics

Requires Override tier

Track your CC collection over time with charts and stats:

• Folder growth - How your mods folder has grown or shrunk across scans
• Category breakdowns - What types of CC you have the most of
• Top creators - Who made the most CC in your folder
• Health score trends - How your folder health has changed over time

Data comes from SQLite snapshots taken after each scan.

---

Exports

Various export options for your data:

• CSV export from My CC (filtered or selected files)
• Sort report after running auto-sort
• Bug report with automatic diagnostic snapshots (system info, mods folder listing, last scan summary, sort manifest, recent logs)