The Assets panel
Editor docs
The Assets panel shows the project's assets/ folder: browse it, search it, make new folders, scenes
and materials, duplicate, rename, move and delete assets, and drag them into the scene. The editor
is a preview.
Preview: Delete, New Folder, New Scene, New Material, Duplicate, Reveal and Copy Path shipped on 15 November 2026 and have not yet been through an end-to-end test pass or tried in a running editor. The thumbnails of materials, atlases and images also need engine 0.20.0 (below).
Browse#
A folder tree on the left, the folder's assets as tiles on the right, a search field and a type filter above. Select an asset to see its details and import settings; double-click a scene or prefab to open it, a material to edit it, a tilemap or an atlas to open its 2D panel. Drag an asset onto the scene view, the Hierarchy or an Inspector field. Drop files from your file manager onto the panel to import them.
Rename… and Move… in the details pane, or dragging an asset onto a folder, rewrite every scene, prefab and material that refers to it, after a dialog that lists them. They work on files; a folder cannot be renamed in the editor.
File operations#
| Command | Where | What it does |
|---|---|---|
| New Folder…, New Scene…, New Material… | Toolbar, context menu | Asks for a name and creates it in the folder on screen. A name already taken gets 2, 3…; nothing is overwritten. |
| Duplicate | Context menu, Ctrl+D on a tile | Copies the asset to <name> 2.<ext> beside it. |
| Copy Path | Context menu | Copies assets/<path> to the clipboard. Copy Folder Path does the same for the folder on screen. |
| Reveal in Finder (macOS), Show in Explorer (Windows), Show in File Manager (Linux) | Context menu | Opens the file's folder in the system's file manager. The (Folder) item does it for the folder on screen. |
| Delete… | Toolbar, context menu, Delete or Backspace on a tile | Moves the asset to the system Trash, after a confirmation (below). |
| Delete Folder… | Context menu, Delete or Backspace in the folder tree | Moves the folder on screen, and everything in it, to the Trash. The assets/ folder itself cannot be deleted. |
On macOS, ⌘D duplicates and ⌘⌫ also deletes.
New Scene writes an empty scene: no camera and no light. New Material writes a PBR material with the engine's default values; double-click it to edit it in the Material panel.
Duplicate copies the asset's import settings too, under a new id, so the copy is imported on its
own with the same options. A .scene.json or other two-part name is kept whole:
level.scene.json becomes level 2.scene.json.
Delete#
Before anything moves, a dialog lists what goes to the Trash and every file that refers to it ("Used by 3 files: …"). Deleting moves:
- the asset and its
.meta.jsonsidecar; - for an imported source, the outputs its import made, with their sidecars;
- for a folder, the folder and everything in it.
An output another imported asset still reads, such as a sprite atlas two maps share, is not deleted with one of them: the dialog lists it under "Kept (another imported asset reads it and takes it over)", and the map that still uses it becomes its owner. Deleting only an import's output, not its source, is refused, naming the source, since the source would import it again: delete the source, which takes its outputs with it, or change its import settings.
References are not rewritten. Scenes, prefabs and materials that name a deleted asset keep naming it, and the engine reports it as a missing asset when it loads them; the dialog says so. The open scene cannot be deleted, nor a folder that holds it. Edit → Undo does not bring a deleted asset back: restore it from the system Trash.
Thumbnails#
Models (.glb, .gltf) and prefabs get a picture in their tile and in the details pane, rendered by
the scene view while no game is playing.
With engine 0.20.0, materials (.material.json), sprite atlases (.atlas.json) and
images (.png, .jpg, .jpeg and .webp, up to 16 MiB) get one too. A material's thumbnail is
redrawn when a texture it names changes, an atlas's when its image does. These need a project
whose @ignifx/editor-host can draw them: 0.20.0 can, 0.19.0 cannot, and in a project on 0.19.0
their tiles show no picture. A model or prefab shows a generic icon until its picture is ready; these show none.
Thumbnails are cached in the project's private
.ignifx/thumbnails/.
Known limitations#
- Empty folders do not always show. The panel lists folders that hold files. An empty folder made with New Folder… shows until the panel reloads; one made outside the editor, or after a restart, does not show until it holds a file.
- One asset is selected at a time, so Delete and Duplicate take one asset.
- A folder cannot be renamed in the editor, so choose its name in New Folder…; rename it in your file manager otherwise.
- File operations have no undo; deleted files are in the system Trash.
- On a project on ignifx 0.19.0, the editor still reads and hashes the project's images for thumbnails it cannot draw yet, once, when the project opens.
- There are no MCP tools for these file operations; agents work on the files directly. Agents can
list assets and their references with
ignifx_list_assetsandignifx_asset_references.