| name | asset-hunter-pro |
| version | 1.0.0 |
| description | Asset Hunter Pro — unused asset detection, dependency graph, duplicate finder, project cleanup automation for Unity |
| triggers | ["unused assets","project cleanup","asset dependencies","duplicate detection","build size optimization","asset management","dead assets"] |
| origin | theonekit-unity |
| repository | The1Studio/theonekit-unity |
| module | unity-base |
| protected | false |
Asset Hunter Pro
Unity Editor tool for identifying unused assets, tracking dependencies, finding duplicates, and analyzing build reports. Package: com.heurekagames.assethunterpro v2.2.26.
Quick Reference
| Feature | Menu Path | Key Class |
|---|
| Unused Assets | Window/Asset Hunter PRO/Asset Hunter PRO | AH_Window |
| Dependency Graph | Window/Asset Hunter PRO/Dependency Graph | AH_DependencyGraphWindow |
| Duplicate Finder | Window/Asset Hunter PRO/Duplicate Assets | AH_DuplicateWindow |
| Settings | Window/Asset Hunter PRO/Settings | AH_SettingsWindow |
Core Workflow
1. Run a Unity build (auto-logs to .ahbuildinfo)
2. Open Asset Hunter PRO window
3. Load latest report → review unused assets in tree view
4. Exclude false positives (scripts, addressables, plugins)
5. Delete confirmed unused assets
6. Re-verify with dependency graph
Exclusion System (5 Categories)
| Category | Example | Use Case |
|---|
| Paths | Assets/Plugins/ | Third-party folders |
| Types | MonoScript | Scripts (common false positive) |
| Extensions | .shader, .cginc | Shader includes |
| Files | Assets/Resources/config.json | Specific files |
| Folders | Editor, Gizmos | Unity special folders |
Programmatic API
using HeurekaGames.AssetHunterPRO;
var settings = AH_SettingsManager.Instance;
settings.AddPathToExcludeList("Assets/Plugins/");
See references/api-reference.md for full API.
MCP Integration
Use manage_asset_hunter MCP tool for automated queries:
scan_unused — list unused assets from latest report
get_duplicates — find duplicate assets by content hash
get_dependencies — query asset reference graph
get_settings — current exclusion configuration
Critical Gotchas
- Scripts appear unused — MonoScripts referenced only by code show as "unused". Exclude
MonoScript type
- Must run a build first — No
.ahbuildinfo = no unused asset data
- Addressables false positives — Assets loaded via Addressables API won't appear in dependencies
- Large project perf — First scan of >10K assets takes 30-60s, cached after
- Editor-only — All API is
#if UNITY_EDITOR, no runtime
- DOTS entities — ECS entity prefabs baked via SubScene are tracked normally
See references/gotchas.md for workarounds.
References
references/workflow-guide.md — Scan, clean, CI integration steps
references/api-reference.md — Public classes and methods
references/gotchas.md — Known issues and workarounds
Security
- Editor-only, no runtime code, no external data transmission
- Reports contain file paths (project structure visible if shared)
- Delete operations irreversible — verify before bulk delete