# 🧹 SimpleAssetCleaner Plugin
SimpleAssetCleaner automatically cleans unreferenced assets from your Unreal Engine project, keeping your repository clean and organized.
⚠️ Important: This plugin integrates with source control systems to manage assets. Please read the documentation carefully before use.
## 🎯 Core Problem Solved
Traditional Asset Management Pain Points:
- Unreferenced assets accumulate in the repository over time
- Manual cleanup is time-consuming and error-prone
- Difficult to identify which assets are actually unused
- Source control submissions include unnecessary files
SimpleAssetCleaner Solution:
- Automatically detects unreferenced assets before submission
- Intelligent reference chain analysis from root assets
- Safe cleanup with configurable root asset types
- Integrates seamlessly with Perforce, Git, SVN, and other VCS
- Safe for newly added files: Reverts unreferenced added files without deleting local copies
## ✨ Key Features
- Auto-Clean on Submit: Automatically checks and removes unreferenced assets when opening the submit dialog
- Safe Revert for New Files: Newly added unreferenced files are reverted from source control while keeping local copies intact
- Manual Full Clean: One-click cleanup of all unreferenced assets in the project via settings
- Smart Reference Analysis: DFS-based reference chain tracking from configurable root assets (Maps, Blueprints, etc.)
- Content Folder Only: Only analyzes and cleans assets in `/Content/` folder - external plugins and engine assets are never touched
- Performance Optimized: Memoization caching for analyzed reference paths
- VCS Integration: Works with Perforce, Git, SVN through Unreal's source control API
- Configurable: Full control over root asset types, custom root assets, and exclusion paths
- Verbose Logging: Optional detailed logging for debugging and monitoring
## 🚀 Quick Start
1. Install the plugin in your project's `Plugins` folder
2. Enable the plugin in Project Settings > Plugins
3. Configure root assets in Project Settings > General > Simple Asset Cleaner
4. Enable Auto Clean to automatically check assets on submission
5. Use "Clean All Source Control Assets" for manual full project cleanup
## 📖 Documentation
Complete tutorial and usage guide available in `/Docs/README.md`
## ⚙️ System Requirements
- Source Control: Perforce, Git, SVN, or any VCS supported by Unreal Engine
- Build Type: Editor-only plugin (does not affect packaged builds)
## 📬 Support
For technical support or questions: mengzhishanghun@outlook.com