Manual / Assets / Filling the gapsiCity 2 · Windows

Filling the gaps

Some library assets arrive unfinished: a prop that is only a picture, a material whose texture maps were never produced. Generate Model and Generate PBR run the step that was skipped, without re-deciding anything else about the asset. Neither applies to assets from your own folders.

What incomplete means

An asset in the library is a folder, and the browser reads what is in that folder. Two gaps are worth a button. A prop can arrive as a picture with no model file next to it, and a material can arrive as a base image whose config asked for texture maps that were never produced.

The browser flags both with a small warning icon in the top-right corner of the card. Red means a prop with no 3D model, amber means a material short of the maps its own config asked for. The picture itself stays at full brightness; the icon is the signal.

filling-the-gaps-warning-icons.png

The asset browser grid (PICK A PROP or PICK A MATERIAL) showing at least one card with the red no-3D-model warning icon in its top-right corner and one card with the amber no-PBR-maps icon. Previews must be lit normally, not dimmed.

/docs-shots/blender/
Cards carrying the two warning icons in the asset browser.

The test for a prop is a file: does the asset folder hold a .blend, .glb, .gltf, .fbx or .obj. The test for a material has two halves, and both must be true.

FlagWhat it means
No 3D modelThe prop folder holds a preview image and no model file in any of the five model formats. It cannot be assigned to anything.
No PBR mapsThe material's config recorded a decision to use maps, and none are on disk. A map is an image named albedo, normal, roughness, height, displacement, metallic, metalness, ao or occlusion.
Note

A material with no maps is not automatically a defect. The pipeline decides per material whether that surface needs any, and a flat sticker legitimately needs none. Only the pair — asked for, absent — raises the amber icon and grows a button. Materials with no maps decision at all stay silent.

Reading the warning

Click the warning icon and a small panel explains the problem; unless you are part way through a multi-selection, the card is selected too, so reading a warning never costs you the set you had built. For a prop the panel says No 3D model — the prop is only an image, generate a 3D model from it or pick a different prop — and its own button is Generate Model. For a material it says No PBR maps and closes with OK; the material button lives in the footer.

filling-the-gaps-problem-popup.png

The asset browser with the small problem panel open over the grid: red title 'No 3D model', the two-line body about the prop being only an image, the 'Generate Model' button and the close control.

/docs-shots/blender/
The problem panel raised by clicking a card's warning icon.

The footer says the same thing in one line, and counts. With one card selected it reads No 3D model; with several it reads 2 of 5 have no 3D model, so you can see how much of a multi-selection is affected before you press anything.

Generate Model

Generate Model sends the prop's existing image to the cloud step that was never run, and a mesh comes back. Nothing about the prop is re-decided: no prompt is sent, no popup opens, and the result lands on the same seed rather than beside it as a new version.

The button acts on every model-less prop in the selection, one job each, and its label counts them — Generate 3 Models for three. Select the whole handful before pressing rather than working through them one at a time.

filling-the-gaps-generate-model-footer.png

The bottom strip of the asset browser in prop-assign mode with three image-only props selected: the info line on the left, the red '3 of 3 have no 3D model' label, and the purple 'Generate 3 Models' button on the right.

/docs-shots/blender/
The footer with several model-less props selected.

A prop with no model cannot be assigned, which is why the button matters. Assign drops model-less picks at commit and says how many it skipped; if everything you picked is model-less, Assign disappears and Generate Model stands in its place.

Note

The footer row lays itself out right to left in a fixed priority: Assign, Generate Model, Generate PBR, Regenerate, Generate with AI, Add to group. On a narrow popup the least important button still standing is hidden rather than pushed off the edge, so widen the popup if a button you expected is not there.

Generate PBR

Generate PBR is the material twin. It builds the missing texture maps from the base colour image the material already has, again with no prompt and onto the same seed. Like Generate Model it reads the whole selection, so six materials short of their maps are six jobs from one press.

filling-the-gaps-generate-pbr-footer.png

The bottom strip of the asset browser in material-assign mode with two map-less materials selected: the amber 'No PBR maps' label and the purple 'Generate PBR' button on the right.

/docs-shots/blender/
The Generate PBR button, shown for materials whose config asked for maps.

Unlike a model-less prop, a material with no maps can still be assigned. The amber flag tells you what you are assigning; it does not block the assignment. That is the practical difference between the two buttons: one unblocks an asset you cannot use, the other improves one you can.

Note

These two buttons appear in the browser when it was opened to fill a slot — from a DESIGN card's Browse… button, a material thumbnail, or a scattering system's +. Which slots exist is covered in What a theme contains.

While the job runs

  1. The card dims under a translucent pane reading Generating…, drops out of the selection, and stops responding to clicks. Its star and warning icon come off while it works.
  2. The log line in CLOUD ACTIVITY reads Missing prop submitted… or Missing material submitted…, and the job is tracked like any other. See Jobs, progress and errors.
  3. When it finishes, the asset is downloaded into the local library and the card comes back with its new model or maps and no warning icon.
filling-the-gaps-generating-card.png

The asset browser grid with one card dimmed under the dark translucent 'Generating…' pane while neighbouring cards stay lit. The dimmed card must show no star and no warning icon.

/docs-shots/blender/
A card with its fill-in job in flight.

The dimming exists because these jobs take minutes and cost credits. A second press would be a second real job against an asset that is already being finished. The card stays inert across the popup closing and reopening, and a failed job hands the button back so you can press it again.

Warning

Job tracking is session-only. A job that finishes while Blender is closed never downloads its result on its own, and there is no way to recover it from the interface. Leave Blender open until the card comes back.

Custom assets cannot be filled in

Both buttons need a cloud identity: an asset_id recorded in the asset's folder, which only assets downloaded from a cloud job have. Assets read from your own Custom Assets Folder have none, so there is nothing for the cloud to finish and the press is refused. The same rule refuses Regenerate on them.

The warning icon and the button still appear on a custom prop with no model, because the flag is about the folder's contents. Pressing it writes a line to Blender's console and does nothing else — no job, no charge, no message in the panel.

text
[iCity2] 'Park Bench' has no cloud identity - only cloud assets can have their Generate Model generated.
filling-the-gaps-custom-source.png

The asset browser footer info line with a custom-folder asset selected, showing the name, category and the word 'Custom' separated by middle dots.

/docs-shots/blender/
The footer info line names the source of the selected asset.

Two ways to tell before you press:

  • The footer info line ends in Library or Custom for the selected asset.
  • The View dropdown at the top of the sidebar has My custom folders, which filters the grid to your own folders. It only appears when a custom folder is configured.

For your own assets the answer is to supply the missing file yourself: put a model file in the prop's folder, or the map images in the material's folder, then press Refresh in the browser. The exact layout is in Using your own assets.

What it costs

Each asset is one cloud job, charged like any other. No estimate is shown before you press, because there is no popup to show it in — pressing with five props selected submits five jobs. Credits are metered on measured cost after the run, so treat the composer's on-screen figures as estimates rather than prices.

For what a credit is, how the allowance works and where to watch it, see Credits and plans. For generating a new asset from a prompt instead of finishing an existing one, see Single materials and props.

Note

Regenerate is a different action and is not a way to fill a gap. It opens the Generate popup, re-renders the asset from a prompt and produces a new seed beside the old one. It is offered only when exactly one asset is selected and nothing in the selection is missing its model.

On this page
What incomplete meansReading the warningGenerate ModelGenerate PBRWhile the job runsCustom assets cannot be filled inWhat it costs
Need help?

The Discord is fastest for anything scene-specific. Email suits licensing, billing and anything needing a file attached.

Contact support →