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.
Comprehensive asset management tool for duplicate detection, migration (copy + create links), link validation/repair, file delinking/relinking, and asset naming convention enforcement.
Public API (Exports)
| Function | Signature | Description |
|---|---|---|
M.onEditorInitialized | () | Registers window and menu item |
M.onEditorActivated | () | Editor activation callback |
M.onEditorGui | () | Main UI with tabbed interface |
M.onExtensionLoaded | () | Extension loaded callback |
Tabs Overview
| Tab | Description |
|---|---|
| Duplicated Assets | Find duplicates by hash, set target paths, migrate with link creation |
| Link Checker | Scan game folders for invalid .link files, attempt auto-fix |
| Delinker | Copy linked targets next to their .link files (pack level without external refs) |
| Relinker | Delete asset files next to .link files (undo a delink operation) |
| Naming Checker | Scan for filenames with invalid characters, suggest snake_case renames |
Migration Workflow
- Add files manually or search all game folders for duplicates
- Set target paths (under
/assets/) for each unique hash - Start migration - copies first file to target, deletes originals, creates
.linkfiles
Naming Convention
Valid filenames: [a-z0-9_./] only. The tool converts:
CamelCase→camel_case- Special characters →
_
Key Internal Functions
| Function | Description |
|---|---|
checkForDuplicates(searchFolders) | Hash all files in folders, find duplicates |
migrateAssetsJob(job) | Copy + link migration (coroutine job) |
checkForInvalidLinks(searchPaths) | Find .link files pointing to missing targets |
tryFixingInvalidLinks(job) | Match broken links to /assets/ by hash |
delinkerJob(job) | Copy targets next to links |
relinkerJob(job) | Delete assets next to links |
See Also
- assetDeduplicator - Simpler hash-based deduplication
- assetBrowser - Browse and inspect assets
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,
SFX Previewer (Audio Events List)
Editor window for browsing and previewing sound effects (SFX events). Provides a folder-based hierarchical view of all registered audio events, text search, and one-click playback.