Skip to content

A one-click batch script that hunts down and removes leftover Roblox files, folders, and registry entries after you’ve uninstalled the app, leaving your Windows system neat and ready for a fresh start.

Notifications You must be signed in to change notification settings

Zectxr/Roblox-Clean-Sweep

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 

Repository files navigation

Roblox Clean Sweep

Roblox Clean Sweep Banner

Windows macOS Shell License

Clean installs, fast resets, zero leftovers.

Fast, toggleable Roblox removal for Windows and macOS. Use this when you need a truly clean slate (switching accounts, fixing corrupt installs, or prepping a fresh reinstall).

Why Clean Sweep?

  • Deep removal by default: processes, folders, registry/preferences, temp/cache, DNS, and stored credentials are all covered.
  • Every step is deliberate: toggle each step [+] run / [-] skip so you stay in control.
  • Cross-platform ready: run.bat for Windows, cleaner.py for Windows/macOS.
  • Single-pass flow: one run takes you from detection to cleanup, then restart.
  • Forensic-friendly: documents exactly what is removed for auditability.

What’s New (latest)

  • Windows Store/UWP Roblox removal using Get-AppxPackage ... | Remove-AppxPackage.
  • MAC address tools (Windows): list adapters, randomize/set custom MAC, revert to original.
  • Extended cleanup to Bloxstrap/Fishstrap: processes, folders (including %LOCALAPPDATA%, %APPDATA%, %PROGRAMDATA%, %PROGRAMFILES%, %PROGRAMFILES(x86)%, Temp), shortcuts, and registry keys.
  • Uninstall entries cleanup: removes entries with DisplayName matching Roblox/Bloxstrap/Fishstrap (HKLM/HKCU, 32/64-bit roots).
  • CloudStore cleanup: removes current-user CloudStore entries containing Roblox/Bloxstrap/Fishstrap.
  • Extra sweep: deletes Roblox shortcuts, prefetch files, crash dumps, “Recent” items, and %USERPROFILE%\Documents\Roblox*.
  • Network hygiene: removes firewall rules and scheduled tasks matching Roblox/Bloxstrap/Fishstrap; strips hosts entries containing “roblox”.
  • Robust deletion: handles read-only files to avoid failures during removal.
  • Color-coded output: green = removed, yellow = not found, red = error, cyan = info.
  • Cleaner header banner and clearer exit options.

Feature Snapshot

  • Interactive toggle menu with user-controlled steps.
  • Windows-only MAC tools (PowerShell + registry) to spoof/revert adapter MACs.
  • Mirrors best-practice locations on macOS (user and system scopes).
  • Targets credentials (Windows) and DNS cache hygiene on both platforms.
  • Designed for reinstall prep, account switching, or remediation after issues.
  • No external dependencies for Python version (uses standard library only).

Table of Contents

Installation

Option 1: Python Version (Recommended)

Requirements:

  • Python 3.7 or higher

Install Python (if not already installed):

  • Windows: Download from python.org or use winget:
    winget install Python.Python.3.12
  • macOS: Use Homebrew:
    brew install python3

Install dependencies (none required, but to verify):

pip install -r requirements.txt

Option 2: Batch Script (Windows Only)

Requirements:

  • Windows 10/11
  • Administrator access
  • No additional software needed

Quick Start

Python Version (cleaner.py)

Windows:

cd "C:\Users\YourUsername\Desktop\Roblox Clean Sweep"
python cleaner.py

macOS/Linux:

cd ~/Desktop/Roblox\ Clean\ Sweep
python3 cleaner.py

Or make it executable:

chmod +x cleaner.py
./cleaner.py

Batch Script (run.bat)

  1. Right-click run.batRun as administrator
  2. Select mode:
  • 1 = Run everything (all [+])
  • 2 = Configure steps individually
  • 3 = MAC address tools (Windows)
  • 4 = About steps (what they do)
  • 0 = Exit
  1. Answer toggles (if mode 2): enter number to toggle [+]/[-] status
  2. Review and confirm cleanup
  3. Restart your PC before reinstalling Roblox

What It Cleans (Windows)

  • Processes (stop locks): Roblox player/studio/installer/crash handler/launcher; plus tooling and launchers including Bloxstrap/Fishstrap and RbxFpsUnlocker.
  • Folders & shortcuts:
    • Roblox: %LOCALAPPDATA%\Roblox, %APPDATA%\Roblox, %PROGRAMDATA%\Roblox, %ProgramFiles%\Roblox, %ProgramFiles(x86)%\Roblox, %USERPROFILE%\AppData\LocalLow\Roblox.
    • Bloxstrap: matching folders in %LOCALAPPDATA%, %APPDATA%, %PROGRAMDATA%, %ProgramFiles%, %ProgramFiles(x86)%.
    • Fishstrap: matching folders in %LOCALAPPDATA%, %APPDATA%, %PROGRAMDATA%, %ProgramFiles%, %ProgramFiles(x86)%.
    • Temp & Docs: %LOCALAPPDATA%\Temp\Roblox|Bloxstrap|Fishstrap, %USERPROFILE%\Documents\Roblox*.
    • Shortcuts: removes desktop (user and public) and Start Menu entries for Roblox/Bloxstrap/Fishstrap.
  • Registry & associations:
    • HKCU/HKLM Software\Roblox and ROBLOX Corporation, including WOW6432Node.
    • Protocol/file handlers: roblox, roblox-player, roblox-player-1, roblox-studio, roblox-studio-auth; file ext: .rbxl, .rbxlx; IE ProtocolExecute entries.
    • Bloxstrap/Fishstrap keys and protocol classes.
  • Uninstall entries: removes entries with DisplayName matching Roblox/Bloxstrap/Fishstrap across HKLM/HKCU (32/64-bit roots).
  • Microsoft Store/UWP: removes ROBLOXCORPORATION* package if present.
  • Temp, Prefetch, Crash dumps, Recent: %TEMP%\Roblox*, C:\Windows\Prefetch\ROBLOX*.pf, %LOCALAPPDATA%\CrashDumps\Roblox*.dmp, Recent entries containing “roblox”.
  • Network hygiene: flush DNS; remove firewall rules and scheduled tasks matching Roblox/Bloxstrap/Fishstrap; strip hosts lines containing “roblox”.
  • Credentials: deletes Windows Credential Manager entries matching Roblox/Bloxstrap/Fishstrap.

What It Cleans (macOS)

  • Processes: kills Roblox app and related helpers before removal.
  • Folders: ~/Library/Application Support/Roblox, ~/Library/Caches/com.roblox.Roblox, ~/Library/Preferences/com.roblox.Roblox.plist, ~/Library/Logs/Roblox, ~/Library/Saved Application State/com.roblox.Roblox.savedState.
  • System-wide traces (if present): /Library/Application Support/Roblox, /Library/Logs/Roblox.
  • Temp/cache: /tmp Roblox artifacts and cache folders under ~/Library/Caches.
  • Network hygiene: optional DNS cache flush (dscacheutil -flushcache and sudo killall -HUP mDNSResponder).

Safety & Notes

  • Always run as admin (Windows) or with sudo (macOS) for full cleanup.
  • Backup anything important before running; this is meant to remove all Roblox traces.
  • Restart after the script completes.
  • Scripts are text-based; review before running if you need to audit.
  • Both Python and Batch versions will show warnings for skipped/failed operations and continue instead of crashing.

MAC Tools Safety

  • MAC spoofing is Windows-only and requires admin. Some NIC drivers/brands may ignore NetworkAddress overrides or reset them after updates.
  • Connectivity can briefly drop while the adapter is disabled/enabled to apply the change.
  • You can revert any override via the MAC tools menu (option “Revert to original”).

Hosts and Firewall

  • The script removes hosts entries that contain “roblox” (case-insensitive). If you rely on custom host mappings, review before/after.
  • Firewall rules and scheduled tasks with names/paths containing Roblox, Bloxstrap, or Fishstrap are deleted.

Usage Examples

Windows - Python (Quick Run All)

python cleaner.py
# Select: 1

Windows - Batch (Configure Steps)

run.bat
# Select: 2
# Toggle steps as needed
# Select: S to start

macOS - Python (Configure Steps)

python3 cleaner.py
# Select: 2
# Toggle steps as needed (A for all, S to start)

Windows - MAC Address Tools

python cleaner.py
# Select: 3 (MAC address tools)
# Pick adapter → choose:
#  1) Randomize MAC
#  2) Set custom MAC (12 hex chars, no colons)
#  3) Revert to original

Color legend in output:

  • Green = removed/updated successfully
  • Yellow = item not found (already clean)
  • Red = error (operation failed)
  • Cyan = informational

Contributing

Issues and PRs welcome—especially for:

  • Adding detections for new Roblox paths
  • Platform-specific tweaks
  • Bug reports or stability improvements
  • Documentation improvements

Inspiration

  • Clean, auditable resets for players and creators.
  • Fast troubleshooting when reinstalling or switching accounts.
  • Reduce support noise by ensuring no leftover state remains.

Credits & Sources

This project does not copy code verbatim; the above resources were used as references to validate approach and coverage.

Files Included

  • cleaner.py - Python version (cross-platform, recommended)
  • run.bat - Windows batch version (no dependencies)
  • requirements.txt - Python dependencies (none required; for documentation)
  • README.md - This file

About

A one-click batch script that hunts down and removes leftover Roblox files, folders, and registry entries after you’ve uninstalled the app, leaving your Windows system neat and ready for a fresh start.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published