Asset Deduplicator
Editor tool for finding and removing duplicate asset files in the current level. Compares level files against `/assets/`, `/art/`, stock levels, and mod levels using SHA1 hashes or filename matching,
Editor tool for finding and removing duplicate asset files in the current level. Compares level files against /assets/, /art/, stock levels, and mod levels using SHA1 hashes or filename matching, then replaces duplicates with .link files.
Public API (Exports)
| Function | Signature | Description |
|---|---|---|
M.onEditorGui | () | Renders the deduplicator UI |
M.onWindowMenuItem | () | Shows the tool window from menu |
M.onEditorInitialized | () | Registers window and menu item under "Assets" group |
M.onEditorActivated | () | Editor activation callback |
M.onEditorDeactivated | () | Editor deactivation callback |
Key Features
- Hash-based comparison - Matches files with identical SHA1 content (mode 0)
- Filename-based comparison - Matches files by name only (mode 1, requires manual review)
- Automatic caching - Hashes cached to
/temp/assetdeduplicator.cache.json - Preview window - Side-by-side image comparison before linking
- Selective linking - Checkbox selection per duplicate, with select/clear all
- Mod support - Optional toggle to allow linking with mod level assets
- Cache invalidation - Auto-invalidates on version change or level change
Workflow
- Open the Asset Deduplicator from the editor menu
- Wait for cache generation (scans
/assets/,/art/, stock/mod levels) - Choose comparison mode (hash or filename)
- Click "Run assessment" to find duplicates
- Preview and select which files to link
- Accept to replace duplicates with
.linkfiles
Link File Format
{
"path": "/assets/textures/road_asphalt_d.dds",
"type": "normal"
}See Also
- assetBrowser - Browse and inspect assets
- assetManagementTool - Full asset migration and link management
Asset Browser
Comprehensive asset browser window for the BeamNG editor. Provides tree-view directory navigation, asset filtering/sorting/grouping, mesh 3D previews, image inspection, drag-and-drop placement, materi
Asset Management Tool
Comprehensive asset management tool for duplicate detection, migration (copy + create links), link validation/repair, file delinking/relinking, and asset naming convention enforcement.