Assets Cleaner - Project Cleaning Tool

Clearing Asset Bloat After Long Prototyping Phases

When a project has been in development for an extended period, or after a heavy round of prototyping, projects accumulate assets that are no longer referenced or used. This accumulation happens naturally as iterations proceed, mechanics change, and older visual tests are abandoned. The unused files remain in the project directory, quietly consuming disk space.

Beyond just storage footprint, leftover assets introduce tangible friction into the development pipeline. They slow down the editor by forcing the engine to process content that is never actually called during runtime. Compile and build times increase because the project size is artificially inflated with dead data.

The traditional manual workaround involves migrating needed assets to a brand new project to leave the dead files behind. This is a tedious and error-prone process. Assets Cleaner automates the cleanup phase entirely from within the editor environment.

Scanning and Inventorying Unused Assets

The core function of Assets Cleaner is to scan the active project and generate a comprehensive list of unused assets. Instead of manually hunting through folders to guess what might be safe to remove, the tool surfaces exactly what is taking up space without contributing to the current project state.

The scan results are presented in a column view mode. This layout is critical because it exposes the disk size of each individual asset directly within the list. Developers can immediately see the file weight of every unused item, allowing them to prioritize the removal of bulky textures, heavy meshes, or large sequences over smaller, insignificant files.

Filtering Behavior and Plugin Content Integration

Working with a long list of unused files requires robust navigation. The tool allows users to view, filter, and search through the listed unused assets using the same interaction logic found in the standard Unreal Engine Content Browser. This means filtering by asset type, searching by name, or sorting by the provided disk size columns functions exactly as a developer would expect from the native editor environment.

The scan functionality also now includes content from plugins. Previous iterations might have missed or ignored plugin-associated files, leaving blind spots in the cleanup process. By pulling plugin content into the scanning scope, the tool ensures a much more thorough audit of what is actually sitting in the project.

Direct Asset Management and Empty Folder Handling

Finding unused files is only half the workflow; safely removing them is the other half. Assets Cleaner enables direct management of the listed items straight from the tool interface. Users do not have to jump back and forth between the custom panel and the standard browser windows.

The available direct actions include:

• Find in Content Browser: Highlights the asset in the native Content Browser to verify its location.
• Find on Disk: Opens the operating system file explorer directly to the asset's physical location.
• Edit Assets: Opens the asset for direct modification without leaving the tool's context.
• Delete Assets: Triggers the editor's native Delete Assets window to ensure standard engine safety checks and dependency warnings are respected during removal.
• Move Assets: Relocates unused items to organized holding folders if immediate deletion is not desired.

When deletions are finalized, the tool automatically deletes the empty folders left behind. This prevents the common issue where removing files manually leaves a scattered web of blank directories in the project tree, keeping the folder structure as lean as the asset inventory.

Leveraging Native Editor Inspection Tools

Before deleting an asset, developers often need to verify its dependencies or understand why it exists. Assets Cleaner provides quick access buttons to the Unreal Engine editor's built-in asset inspection tools directly from its interface.

The Reference Viewer can be launched to visually map which other assets an item uses, and conversely, what might be referencing it. This is a crucial step before deletion to ensure a seemingly unused file is not quietly feeding into an active Material or Blueprint node. The Size Map tool is also accessible, providing a quick visual representation of asset sizes throughout the project tree.

A newly integrated option is the Audit Tool. This feature provides more detailed information specific to individual asset types. Instead of just seeing a file name and a byte count, the Audit Tool breaks down the deeper metadata or configuration details relevant to the specific asset class being inspected.

Version Support and Workflow Positioning

Assets Cleaner operates through Blueprints and integrates into the recent editor menus. It was highlighted as the Monthly Unreal Engine Sponsored Content product for November 2021, cementing its position as a recognized utility within the engine's ecosystem.

Due to marketplace policies restricting developers from updating files for Unreal Engine versions older than the three most recent releases, updates for version 4.25 and older have ceased. These older engine versions will continue to use the legacy Assets Cleaner 1.0 files. The creator notes that updated files are prepared for these older engines but cannot be deployed due to the platform's update limitations.

For developers working on long-term Unreal Engine projects, maintaining a clean directory structure is an ongoing battle. This tool serves teams and solo developers who want to automate the tedious process of auditing, filtering, and purging surplus content, ensuring editor responsiveness and build efficiency remain high across the development lifecycle.