2Shay

★ ★ ★ ★ ★

CLEAN
Mod Remover and Holster • v3.2
By 2Shay

Wrangle Your Mods, Partner


QUICK START

Download & extract → Keep the EXE/config beside RDR2.exe → Open CLEAN → Scan Mods → Holster Mods → Review & confirm.

Use Restore Mods when you want them back.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📜 WHAT IS THIS?

CLEAN helps you disable, restore or permanently delete selected mod files from your Red Dead Redemption 2 installation.

● Holster — move selected mods into a verified recovery session.
● Restore — bring them back when you want them.
● Delete — permanently remove a reviewed selection after a separate typed confirmation.

Automatic folder detection checks common Steam, Epic and Rockstar locations. If your game is elsewhere, use Browse. No path pasting or installer required.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🤠 WHY USE THIS?

● Switch between your modded setup and a Story Mode session with selected mods holstered.
● Temporarily set mods aside before trying a different setup.
● Review recognised mod components and investigate leftover files.
● Manage ReShade and ENB independently through their group controls.
● Keep CLEAN beside RDR2.exe for convenient access.

Holstering does not verify vanilla integrity or reverse changes inside .rpf archives. CLEAN makes no guarantee about online restrictions or bans; do not use Red Dead Online as a test.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ FEATURES

🔒 REVIEW BEFORE ACTION
See the selection before files move. Unknown files start unchecked; protected paths are excluded. Permanent deletion needs a separate typed DELETE confirmation.

🔍 VERIFIED RECOVERY
Journalled sessions and SHA-256 checks track transferred files. Restore reports occupied destinations before changes and never silently overwrites them.

🖱️ SIMPLE CONTROLS
Scan Mods, Holster Mods, Restore Mods and Delete Mods have clear labels and separate review steps. No PowerShell or administrator rights normally required.

📦 PORTABLE
Keep the EXE and matching .exe.config together. No installer. Refreshed Windows interface with checks at 100%, 125%, 150% and 200% scaling.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎯 WHAT IT MANAGES

── MOD FILES AND FOLDERS ──

Examples include:
● .asi plugins and ScriptHookRDR2 files.
● LML files, lml/, RampageFiles/, scripts/ and scripthookrdr2dotnet/.
● dinput8.dll or version.dll when ASI components are detected.
● NLog.dll when LML components are present.

── RESHADE — MANAGED SEPARATELY ──

● ReShade.ini, ReShadePreset.ini and ReShade.log.
● ReShade32.dll, ReShade64.dll and reshade-shaders/.
● dxgi.dll or d3d12.dll when ReShade components are detected.

── ENB — MANAGED SEPARATELY ──

● enblocal.ini, enbseries.ini and recognised ENB effect files.
● enbseries/ and enbcache/.
● d3d11.dll or d3dcompiler_46e.dll when ENB components are detected.

These are recognition examples, not a promise that every file with a particular extension is a mod. Other files appear as unknown and stay unchecked unless you deliberately select them. Review the contents of selected folders, too.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ WHAT IT KEEPS

Protected paths are excluded from CLEAN operations, including:

✓ RDR2.exe and other .exe files.
✓ .rpf game archives.
✓ Recognised game libraries and launcher/platform paths.
✓ CLEAN’s executable, matching runtime config and recovery folders.

Unknown files stay unchecked by default. Filename recognition is not an integrity check: CLEAN does not verify that game files are original or unmodified.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🗺️ HOW TO USE

1. Download v3.2 using Manual Download and extract the ZIP outside your game folder.
2. Copy CLEAN_v3.2.exe and CLEAN_v3.2.exe.config together beside RDR2.exe. Keep the guides, notices and source outside the game folder.
3. Close RDR2 and any mod manager or program changing its files.
4. Open CLEAN and check the detected game folder, or use Browse.
5. Click Scan Mods, then Holster Mods. Review the selection and confirm.
6. Use Restore Mods to choose and restore a session.

Alternatively, keep the EXE/config pair elsewhere and place a shortcut to CLEAN in the game folder. The config stays beside the real EXE.

YOUR SIDEBAR
Scan Mods — find and review candidates.
Holster Mods — set selected mods aside in a verified session.
Restore Mods — recover a saved session.
Delete Mods — holster first, then confirm permanent deletion separately.
ReShade / ENB — manage either group independently.
About / Support — news, support, source and issues.

You can cancel during review. Cancelling the permanent deletion prompt leaves the files holstered; completed permanent deletion cannot be undone.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔄 VERIFYING GAME FILES & RECOVERY

Holstering and launcher verification do different jobs.

You do not need to verify game files just to holster mods. Steam/Epic/Rockstar verification may replace modded base files, and CLEAN cannot restore changes inside .rpf archives.

Before repairing, reinstalling or moving the game, read UPGRADE-RECOVERY.md and preserve your saves and recovery folders independently. Restore holstered files first where possible.

New sessions live in game folder\_RDR2_ModHolster. Earlier _RDR2_ModHolster31 sessions remain readable in place; keep both folders intact while they contain files you want to recover. CLEAN does not move or merge them. Do not use older CLEAN tools against an installation holding v3.2 sessions.

Reinstalled LML while mods were holstered?
Restore reports the conflicts. After review, you can move the reinstalled files into a separate recoverable session before restoring the originals. Displaced files appear as Files moved aside and can also be restored.

Supported schema 3.1/3.2 sessions and older disabled-folder backups are recognised. See the recovery guide for interrupted sessions, moved folders and supported formats.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 REQUIREMENTS

● Windows with .NET Framework 4.8 installed.
● Red Dead Redemption 2 and permission to modify its game folder.
● Both CLEAN_v3.2.exe and CLEAN_v3.2.exe.config kept together.

The .NET 8 SDK is needed only to build the source, not to run CLEAN. CLEAN does not install mods.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔧 TROUBLESHOOTING

“File in use” or another operation is running
Close RDR2, LML’s manager and other CLEAN windows. Check Task Manager for lingering processes, then retry.

Game not found
Use Browse to select the folder containing RDR2.exe.

Restore conflict
Read the named destinations. Review the move-aside option if you want to preserve the current files before restoring the old set; do not delete files just to dismiss a conflict.

Windows warning on first run
The executable is unsigned. Check the download source and supplied SHA-256 checksum before deciding whether to run it.

Interrupted operation or disk error
Keep the session folder and detailed log. Read UPGRADE-RECOVERY.md before changing recovery files; do not edit manifests to bypass a warning.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🧪 TESTED FOR v3.2

The exact packaged executable completed a Steam / Vulkan Story Mode cycle with LML Beta 11, Script Hook/Native Trainer and ReShade 6.8.0:

Modded launch → Holster → Story launch with mods inactive → Restore → Modded launch.

All 34 restored mod/ReShade payload files matched their independent pre-holster SHA-256 hashes before the final gameplay launch. LML reinstall conflicts preserved both versions, including recovery after restarting CLEAN.

Windows CI passed: 38 engine, 22 release, 21 extended and 17 native checks; four Linux-only skips. The final extracted package also passed 17 native safety and 17 portable-placement checks. UI and gameplay results are recorded separately in VALIDATION.md.

This covers the controlled test set. Epic/standalone Rockstar editions, every mod combination, mixed monitors and real redirected Documents remain untested. Long paths may be safely refused depending on Windows settings. Physical power-loss durability and historical crash causes are unverified.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🛠 SOURCE & PERMISSIONS

v3.2 — publicly readable source, source-available licence

The CLEAN Source-Available Noncommercial Licence 1.0 allows inspection, private noncommercial builds/modifications and free noncommercial forks under its conditions. Covered commercial use needs permission from 2Shay. Modified binary distributions must include corresponding modified source and retain notices. This is not an open-source licence.

v2.3 BAT framework — MIT

The previously published v2.3 framework was released under MIT. Those permissions, including commercial rights, survive; the v3.2 licence does not revoke them. Earlier MIT grants and separately licensed components keep their own terms.

Source & Issues on GitHub

Read LICENSE.txt, THIRD-PARTY-NOTICES.txt and ARTWORK-NOTICE.txt. Official RDR2 artwork is separate third-party material; no written redistribution clearance or Rockstar/Take-Two endorsement is claimed. Nexus Donation Points is disabled for CLEAN.

Development disclosure: mostly AI-generated code, with author-directed implementation and testing. The supplied app icon has AI-generation provenance.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🤝 COMMUNITY THANKS

ITsEMEt
CinematicTactics
Yakuzer24
PrinceArthur2708
Godfrey152
angel_reign
1RuggedGamer
R3ddslayer
Ronin823
Chen111111333
MurlkeTink
IkariBrendo

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💛 SUPPORT 2SHAY

News & Support on Ko-fi

Support is voluntary and does not buy access, updates, assistance or promised features.

CLEAN for GTA VI is planned, targeting day-one support for the PC release, subject to compatibility testing. Follow development on Ko-fi.

“You keep ridin’, partner.”


📷 WALKTHROUGH SCREENSHOTS
01 — Open CLEAN: place the EXE and matching config beside RDR2.exe.
02 — Click Scan Mods and check the selected game folder. Disposable example files shown.
03 — Click Holster Mods and review the selection. Unknown files stay unchecked; protected files cannot be selected. Disposable examples.
04 — Check the final list, then Continue to holster the selected items. Disposable examples.
05 — Holster complete. Keep the _RDR2_ModHolster session folder so you can restore these files. Disposable example session.
06 — Click Restore Mods, check the session, then Continue. With multiple sessions, choose the one you want to restore.
07 — Restore complete. Both example files restored with matching SHA-256 hashes and no overwriting.
08 — Manage ReShade and ENB separately using their group controls. ReShade actions shown.
09 — Optional permanent deletion: type DELETE, then Permanently delete. Cancel keeps files holstered. This demonstration was cancelled.
10 — About / Support: Ko-fi news and support; GitHub source and issues. Donations do not buy access, updates or promised features.