Unity Project Hygiene Tool

Reusable Unity Editor tooling for:

• analyzing content that is not protected by enabled Build Settings scenes or user-selected protected scenes
• previewing safe organization moves into a standard Assets/_Project/... layout
• exporting high-confidence unused assets to an external backup folder together with their .meta files
• restoring exported assets later from a generated restore report

Install

Copy the Assets/Editor/ProjectHygiene folder into any Unity project.

Open the tool from:

• Tools/Project Hygiene/Unused Content & Organizer

Safety Model

The tool is intentionally conservative.

• It protects enabled build scenes automatically.
• It lets you add extra protected scenes that are not in Build Settings.
• It protects dynamic roots such as Resources, StreamingAssets, Addressables, AssetBundles, and detected code-known asset paths.
• It protects dependencies referenced by prefabs, ScriptableObjects, materials, animation assets, VFX assets, and shaders.
• It does not hard-delete assets.
• It only enables external backup export for high-confidence items.
• It marks uncertain items for manual review instead of moving them.

Backup / Restore Workflow

When exporting unused assets:

• choose a backup folder outside the Unity project
• the tool moves both the asset file and its .meta file
• the tool writes a restore report that maps original Unity path to exported backup path

To restore safely, both files must return together.

Important Limitations

• Package removal is advisory only and always manual review.
• Scenes, scripts, compile-critical assets, shaders, localization assets, input assets, NavMesh data, and special-folder assets are not auto-exported.
• The analysis prefers false negatives over false positives.