Bulk Asset Ops
Every Bulk Asset Ops command in CodeFizz Editor Agent, with parameters and examples.
Every Bulk Asset Ops command in CodeFizz Editor Agent, with parameters and examples.
5 commands. Each shows its parameters and an example, and has a copyable deep link, so you (or an AI agent) can jump straight to one.
move_assetsBatch move/rename assets (auto-fixes references and redirectors)
Moves or renames many assets in one call using AssetTools::RenameAssets, repointing every in-editor reference. Each move is {source_path, dest_path, new_name?}; omit new_name to keep the original name (pure move). By default the redirectors left at the old locations are fixed up and deleted (fixup=true), matching the Content Browser's move behavior.
| Parameter | Type | Required | Description |
|---|---|---|---|
| moves | json | Yes | JSON array of {source_path, dest_path, new_name?}. dest_path is the destination folder; new_name optional (defaults to original) |
| fixup | bool | No | Fix up and delete the redirectors left at old locations after moving |
cfa move_assets --json '{"moves":[{"source_path":"/Game/Old/T_Rock","dest_path":"/Game/Textures"}]}'
cfa move_assets --json '{"moves":[{"source_path":"/Game/M_A","dest_path":"/Game/Mats","new_name":"M_A_Renamed"}],"fixup":true}'delete_assetsBatch delete assets (reference-checked unless forced)
Deletes many assets in one call. By default refuses any asset still referenced from outside the batch and lists those referencers (references between batch members never block). Use force=true to delete regardless via ForceDeleteObjects, nulling out external references.
| Parameter | Type | Required | Description |
|---|---|---|---|
| asset_paths | json | Yes | JSON array of full content paths to delete |
| force | bool | No | Delete even when referenced (force-delete, nulls external references) |
cfa delete_assets --json '{"asset_paths":["/Game/Old/M_A","/Game/Old/M_B"]}'
cfa delete_assets --json '{"asset_paths":["/Game/Old/M_A"],"force":true}'fixup_redirectorsFix up and delete redirectors under a content path
Scans a content path for UObjectRedirector objects (left behind by earlier moves/renames), repoints every referencer to the real asset, and deletes the redirectors. Run this after manual moves or to clean a folder.
| Parameter | Type | Required | Description |
|---|---|---|---|
| path | string | No | Content path to scan for redirectors |
| recursive | bool | No | Scan subdirectories |
cfa fixup_redirectors --path /Game
cfa fixup_redirectors --path /Game/Textures --recursive falsefind_replacement_candidatesFind same-class assets that can replace a given asset (ranked, top-N)
Before replace_references, find what you can swap an asset for. References can only be repointed to an asset of the EXACT same class, so this searches for that one class, ranks matches by name, and returns the top-N {name, path, match_score}. Give a name_filter (e.g. the kind of material you want) and verify the path before calling replace_references.
| Parameter | Type | Required | Description |
|---|---|---|---|
| asset_path | string | Yes | The asset you intend to replace (its class defines what candidates are compatible) |
| name_filter | string | No | Case-insensitive name match to rank candidates |
| path | string | No | Content path to search within |
| recursive | bool | No | Search subdirectories |
| max_results | int | No | Maximum candidates to return (top matches) |
cfa find_replacement_candidates --asset-path /Game/Mats/M_Old --name-filter Floor --max-results 5
cfa find_replacement_candidates --asset-path /Game/Tex/T_Old --path /Game/Texturesreplace_referencesReplace all references to source assets with a target asset (consolidate)
Repoints every reference from one or more source assets to a single target asset via ObjectTools::ConsolidateObjects, the same operation as the editor's 'replace references' in the Delete dialog. All sources must be the EXACT same class as the target (use find_replacement_candidates to pick a valid target); if any mismatch, nothing changes and the incompatible list is returned. By default the sources are deleted after consolidation.
| Parameter | Type | Required | Description |
|---|---|---|---|
| source_paths | json | Yes | JSON array of asset paths whose references are replaced |
| target_path | string | Yes | Asset that references are repointed TO (must match the sources' class) |
| delete_after | bool | No | Delete the source assets after their references are replaced |
cfa replace_references --json '{"source_paths":["/Game/Mats/M_Old"],"target_path":"/Game/Mats/M_New"}'
cfa replace_references --json '{"source_paths":["/Game/M_A","/Game/M_B"],"target_path":"/Game/M_Keep","delete_after":false}'