Scanning

Scanning

The Scan tab finds eligible Static Mesh sources and groups repeated meshes/material setups into build candidates.

Scanning is the read-only stage of the workflow. It does not build generated components and does not modify source actors.

Choose scan scope

Scan scope selection

InstanceForge can scan different source areas:

ScopeUse case
Selected ActorsSafest first pass. Only selected level actors are scanned.
Current LevelScans eligible sources in the current level.
InstanceForge VolumesScans sources inside InstanceForge include/exclude volumes.

Use Selected Actors when testing a new scene or asset pack.

Set filters and source options

Scan filters and source options

Tags control which actors/components are allowed into the scan.

Recommended setup:

Required Tag: IF_Instance
Exclude Tags: IF_NoInstance
SettingPurpose
Required Actor/Component TagOnly matching sources are considered. If empty, all eligible sources can be considered.
Exclude TagsMatching sources are skipped even if they match the required tag.
Include StaticMeshActorsAllows simple AStaticMeshActor sources.
Include StaticMeshComponents inside Blueprint actorsAllows UStaticMeshComponent sources inside Blueprint actors.

Blueprint Static Mesh Components may need component tags unless actor tag inheritance is enabled.

Run Scan Sources

Scan results

Click Scan Sources, then check the result text.

A useful scan should show ready candidates and groups.

If the scan returns 0 ready candidates or 0 groups, open Troubleshooting.

Grouping rules

InstanceForge groups compatible sources before build.

A build group is based on:

  • Static Mesh.
  • Exact material slot assignments.
  • Mobility.
  • Collision profile name.
  • Collision enabled mode.
  • Cast Shadow.

This keeps generated ISM/HISM component defaults representative for the whole group.

Tag examples

Use one broad production tag for normal work:

IF_Instance

Use an exclude tag for objects that must never be converted:

IF_NoInstance

Use manual-pass tags only when you intentionally want separate scan/build passes:

IF_Build_ISM
IF_Build_HISM

Next steps

Continue to Plan and Build.