Skip to main content

foliage kit

184 tools. Generated from the plugin source; do not edit by hand.

Guide​

The foliage kit manages foliage type assets, the instances of the current editor level, headless surface placement, procedural foliage volumes and folder-wide audits. Everything goes through the public Foliage runtime APIs (AInstancedFoliageActor, FFoliageInfo, UProceduralFoliageComponent); the editor's paint brushes live in the private FoliageEdit module and are replaced by the trace-based tools below. Instance tools work on the current level's instanced foliage actor.

1. Types​

  • foliage.create_type (static mesh) / create_actor_type (actor class) create the asset; duplicate_type, rename_type, delete_type, save_type, list_types, get_type.
  • Typed setters, all returning the stored values: placement (set_density, set_radius, set_z_offset, set_align_to_normal, set_align_max_angle, set_random_yaw, set_random_pitch, set_average_normal 5.0+), filters (set_ground_slope_filter, set_height_filter, set_type_filters for landscape layers), scaling (set_type_scaling), culling and scalability (set_cull_distance, set_scalability, set_cull_distance_scaling 5.2+), rendering (set_mobility, set_lighting_channels, set_custom_depth, set_translucency_sort_priority, set_lightmap_resolution, shadows incl. set_shadow_two_sided, set_contact_shadow 5.0+, set_shadow_cache_invalidation 5.3+, set_visible_in_ray_tracing, set_wpo_disable_distance 5.1+, set_virtual_texture), collision (set_collision_enabled, set_collision_profile, set_collision_scale), mesh (set_mesh, set_material_override, set_nanite_material_override 5.1+, set_component_class), procedural growth (set_collision_radius, set_shade_radius, set_num_steps, set_seeds_per_step, set_shade_growth, set_procedural_distribution, ...) and actor foliage (set_actor_type_settings).
  • Readbacks: get_placement, get_scaling, get_culling, get_lighting, get_collision, get_procedural_settings, get_rendering. set_type remains for a reviewed property without a typed tool; an unknown property is an error.

2. Level instances​

  • Register with add_type_to_level (optional, insertion registers automatically), inspect with list_level_types, count, get_bounds.
  • Explicit placement: add_instances / add_instance with transforms; scatter_grid and scatter_random place at a fixed z without tracing.
  • Query: get_instances, get_instance, nearest_instance, get_instances_in_box, get_instances_in_sphere, find_instances (box AND sphere AND z range AND scale range).
  • Edit: set_instance_transform (one transform, many indices), set_instance_transforms (one per index), move_instances, scale_instances, rotate_instances, transform_region (every instance in a box), randomize_instances (seeded yaw/uniform scale), duplicate_instances, move_instances_to_type, replace_type (all instances to another type).
  • Remove: remove_indices, remove_in_box, remove_in_sphere, remove_filtered, remove_by_type; foliage.remove_all clears every type of the current level (or all levels).
  • Selection: select_instances, clear_selection, get_selected_instances.
  • Custom data: set_custom_data_channels (5.3+), set_custom_data (5.0+), get_custom_data. Custom data lives on the foliage component and is rebuilt when the type changes; re-apply it after type edits.
  • Files: export_instances writes Saved/UEAMCP/Foliage/<file>.json (layout x,y,z,pitch,yaw,roll,scaleX,scaleY,scaleZ per type); import_instances validates the whole file first, then inserts (replace:true clears each target type first, type redirects every record).

3. Headless placement (tracing)​

paint_circle, paint_box, paint_line, paint_actor and scatter_poisson sample points, trace down with AInstancedFoliageActor::FoliageTrace (same hit rules as the editor: no volumes, no hidden actors, no NoCollision components, never on the same type), then apply the type's slope, height and landscape-layer filters, build the instance with a seeded version of the editor's manual placement (scale mode and ranges, z offset, random yaw/pitch, align to normal), run the world-collision test when CollisionWithWorld is set, reject samples closer than the type radius, and insert with FFoliageInfo::AddInstance on the hit component (instances follow their base).

  • count fixes the sample count; count:0 derives it from the type density (instances per 1000x1000 cm).
  • The reply reports attempts, placed, noHit, slope, height, layer, collision, overlap; dryRun:true reports without inserting. Use preview_trace to see what one sample would hit and which filter rejects it.
  • paint_actor only accepts hits on the named actor (exact label). scatter_poisson uses Bridson sampling with minDistance; trace:false inserts at min.z without filters.
  • Follow-ups: snap_to_ground (drop instances onto the surface, optional normal alignment), reapply_settings (re-roll scale/yaw/pitch from the type's current ranges), thin_instances (greedy spacing enforcement, dryRun available).
  • create_ground spawns (or reuses by label) a 10 cm collision slab from /Engine/BasicShapes/Cube when a blockout needs a surface.

Recipe: forest floor on a landscape layer

  1. foliage.create_type → set_type_filters {landscapeLayers:['Grass'], minimumLayerWeight:'0.5'} → set_ground_slope_filter {min:0,max:30}.
  2. foliage.paint_box {min,max, count:0, seed:1, dryRun:true} and read the rejection counters.
  3. Run it again without dryRun; foliage.thin_instances if the radius was raised afterwards.

4. Procedural foliage​

  • Spawner assets: create_spawner, get_spawner, set_spawner, set_spawner_seed, set_spawner_tile_size, set_spawner_unique_tiles, validate_spawner, list_spawners, add_spawner_type, remove_spawner_type, list_spawner_types. The type's own procedural fields (collision/shade radius, steps, seeds, spread, ages, overlap priority) drive the growth.
  • Volumes: add_volume (box brush + spawner), set_volume (spawner, location, extent, tile overlap), set_volume_filters (landscape/BSP/static mesh/translucent/foliage surfaces), get_volume, list_volumes, add_blocking_volume, remove_volume (also clears its instances).
  • simulate runs UProceduralFoliageComponent::GenerateProceduralContent, removes the volume's previous instances, traces every desired instance with the volume's surface flags, applies the type filters and inserts through FPotentialInstance::PlaceInstance + FFoliageInfo, stamping the volume's procedural GUID. resimulate_all does it for every volume; volume_stats counts the stamped instances per type; clear_volume removes them. Simulation shows the engine's progress slow task while it waits for the tile workers. Same spawner seed + same surfaces = same result.

5. Audits and batches​

  • audit, validate, stats, find_types_by_mesh, audit_density, audit_cull_distance, audit_shadows, audit_collision, find_unused_types: per-type items with warning, value and world instance counts.
  • batch_set_* (cull distance, shadows, collision profile, density, radius, mobility, scale, ...) and replace_type_mesh accept dryRun:true and report before -> after per type.
  • Level hygiene: list_foliage_actors, cleanup_invalid (non-finite or non-positive-scale instances and registrations of deleted type assets), remove_unused_level_types, rebuild_all (cluster rebuild), move_to_level (current level → another loaded level; same level is a reported no-op), to_static_mesh_actors / from_static_mesh_actors (the actor mesh must equal the type mesh).

Gates​

  • 5.0+: set_average_normal, set_contact_shadow, set_include_in_hlod, batch_set_hlod, batch_set_contact_shadow, set_custom_data; 5.1+: set_wpo_disable_distance, set_nanite_material_override; 5.2+: set_cull_distance_scaling; 5.3+: set_shadow_cache_invalidation, set_custom_data_channels. set_actor_type_settings rejects staticMeshOnly:true on 4.27.
  • Not available: the interactive paint/erase/lasso brushes of the Foliage editor mode (FoliageEdit is private). The tools above cover the same outcomes headlessly.

Tools​

Legend. risk 0 = read-only, 1 = harmless editor op, 2 = modifies asset, 3 = deletes/replaces asset, 4 = project/config/build op, 5 = potentially destructive (calls above MaxAutoRisk need "_confirm": true). mutates = runs in a transaction (edit.undo reverts). requires PIE / requires world = refused without a PIE session / an open level. requires plugin = unavailable while the plugin is disabled. dryRun = honours the dryRun argument. smoke = covered by edit.self_test.

foliage.add_blocking_volume (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
labelstringrequired. Actor label (must be unused).
volumestringProcedural volume it blocks; empty blocks every procedural volume.
location{x,y,z}Volume centre.
extent{x,y,z}Box half size (cm). Default FUeaVec3(200,200,500).

Returns: volume.

foliage.add_instance (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
transformsarray of UeaFoliageTransformrequired.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.add_instances (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
transformsarray of UeaFoliageTransformrequired.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.add_spawner_type (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
spawnerstringrequired. Procedural foliage spawner asset.
typestringrequired. Foliage type asset.

Returns: spawner.

foliage.add_type_to_level (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.

Returns: types, count.

foliage.add_volume (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
labelstringrequired. Actor label (must be unused).
spawnerstringrequired. Procedural foliage spawner asset.
location{x,y,z}Volume centre.
extent{x,y,z}Box half size (cm). Default FUeaVec3(1000,1000,500).
tileOverlapnumberOverlap between simulation tiles (cm). Default 0.

Returns: volume.

foliage.audit (risk 0, smoke)​

No description.

ArgumentTypeDescription
folderstringDefault TEXT("/Game").

Returns: items, count, changed, warnings, dryRun.

foliage.audit_collision (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
minInstancesintegerOnly flag types with at least this many instances in the editor world. Default 0.

Returns: items, count, changed, warnings, dryRun.

foliage.audit_cull_distance (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
maxEndDistanceintegerFlag end distances above this value (0 flags only never-culled types). Default 0.

Returns: items, count, changed, warnings, dryRun.

foliage.audit_density (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
maxDensitynumberDensity (instances per 1000x1000 cm) above which a type is flagged. Default 100.

Returns: items, count, changed, warnings, dryRun.

foliage.audit_shadows (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
minInstancesintegerOnly flag types with at least this many instances in the editor world. Default 0.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_align_to_normal (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuebooleanValue applied to every type. Default true.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_collision (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
profilestringrequired. Collision profile name.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_contact_shadow (risk 2, mutates, UE 5.0+, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuebooleanValue applied to every type. Default true.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_cull_distance (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
startDistanceintegerCull start distance (cm). Default 0.
endDistanceintegerCull end distance (cm). Default 10000.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_decals (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuebooleanValue applied to every type. Default true.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_density (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuenumberValue applied to every matching foliage type. Default 0.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_density_scaling (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuebooleanValue applied to every type. Default true.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_distance_field (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuebooleanValue applied to every type. Default true.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_dynamic_shadow (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuebooleanValue applied to every type. Default true.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_hlod (risk 2, mutates, UE 5.0+, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuebooleanValue applied to every type. Default true.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_indirect_lighting (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuebooleanValue applied to every type. Default true.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_mobility (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
mobilitystringrequired. Static, Stationary or Movable.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_occluder (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuebooleanValue applied to every type. Default true.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_radius (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuenumberValue applied to every matching foliage type. Default 0.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_random_yaw (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuebooleanValue applied to every type. Default true.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_scale (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
minnumberMinimum uniform scale. Default 1.
maxnumberMaximum uniform scale. Default 1.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_shadows (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuebooleanValue applied to every type. Default true.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_static_shadow (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuebooleanValue applied to every type. Default true.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.batch_set_wpo (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
valuebooleanValue applied to every type. Default true.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.cleanup_invalid (risk 2, mutates, requires world, dryRun, smoke)​

No description.

ArgumentTypeDescription
allLevelsbooleanEvery loaded level instead of only the current level. Default false.
dryRunbooleanReport without applying (clean-up tools). Default false.

Returns: types, actors, removed, deletedTypes, dryRun.

foliage.clear_selection (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
offsetintegerDefault 0.
limitintegerDefault 100.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.clear_volume (risk 3, mutates, destructive, requires world, smoke)​

No description.

ArgumentTypeDescription
volumestringrequired. Exact label of a ProceduralFoliageVolume.

Returns: volumes, desired, placed, noHit, slope, height, layer, collision, removed, instances, types, dryRun.

foliage.count (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
offsetintegerDefault 0.
limitintegerDefault 100.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.create_actor_type (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
folderstringrequired.
namestringrequired.
actorClassstringrequired.

Returns: type.

foliage.create_ground (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
labelstringActor label; an existing static-mesh actor with this label is reused and resized. Default TEXT("FoliageGround").
center{x,y,z}World-space centre of the top surface.
extent{x,y,z}Half size in centimetres (x, y); z is ignored, the slab is 10 cm thick. Default FUeaVec3(1000,1000,0).

Returns: label, path, reused, boundsMin, boundsMax.

foliage.create_spawner (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
folderstringrequired.
namestringrequired.
randomSeedintegerDefault 0.
tileSizenumberDefault 10000.
numUniqueTilesintegerDefault 1.

Returns: spawner.

foliage.create_type (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
folderstringrequired.
namestringrequired.
meshstringrequired.

Returns: type.

foliage.delete_type (risk 3, mutates, destructive, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.

foliage.duplicate_instances (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
indicesarray of integerrequired. Source instance indices.
offset{x,y,z}World offset of the copies.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.duplicate_type (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
folderstringrequired.
namestringrequired.

Returns: type.

foliage.export_instances (risk 1, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringRegistered foliage type; empty exports every type of the current level.
filestringrequired. Bare file name (letters, digits, _ and -), without extension.

Returns: path, instances, types.

foliage.find_instances (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
inBoxbooleanRestrict to the min/max box. Default false.
min{x,y,z}Box minimum (with inBox).
max{x,y,z}Box maximum (with inBox).
center{x,y,z}Sphere centre (with radius > 0).
radiusnumberSphere radius in centimetres; 0 disables the sphere test. Default 0.
minZnumberMinimum instance Z. Default -1.0e9.
maxZnumberMaximum instance Z. Default 1.0e9.
minScalenumberMinimum of the largest scale axis. Default 0.
maxScalenumberMaximum of the largest scale axis. Default 1.0e9.
limitintegerMaximum returned records. Default 100.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.find_types_by_mesh (risk 0, smoke)​

No description.

ArgumentTypeDescription
meshstringrequired.
folderstringDefault TEXT("/Game").

Returns: items, count, changed, warnings, dryRun.

foliage.find_unused_types (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
folderstringDefault TEXT("/Game").

Returns: items, count, changed, warnings, dryRun.

foliage.from_static_mesh_actors (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
actorsarray of stringrequired. Exact labels of StaticMeshActors whose mesh equals the type mesh.
typestringrequired. Instanced-static-mesh foliage type receiving the instances.
deleteActorsbooleanDelete the actors after conversion. Default false.

Returns: actors, count, removed, total.

foliage.get_bounds (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
offsetintegerDefault 0.
limitintegerDefault 100.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.get_collision (risk 0, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.

Returns: type, settings.

foliage.get_culling (risk 0, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.

Returns: type, settings.

foliage.get_custom_data (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
indexintegerDefault -1.

Returns: index, channels, values, component.

foliage.get_instance (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
indexintegerDefault -1.

Returns: instance, count.

foliage.get_instances (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
offsetintegerDefault 0.
limitintegerDefault 100.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.get_instances_in_box (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
min{x,y,z}World-space inclusive minimum bound.
max{x,y,z}World-space inclusive maximum bound.
limitintegerMaximum returned records. Default 100.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.get_instances_in_sphere (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
center{x,y,z}World-space centre.
radiusnumberSphere radius in centimetres. Default 100.
limitintegerMaximum returned records. Default 100.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.get_lighting (risk 0, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.

Returns: type, settings.

foliage.get_placement (risk 0, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.

Returns: type, settings.

foliage.get_procedural_settings (risk 0, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.

Returns: type, settings.

foliage.get_rendering (risk 0, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.

Returns: type, settings.

foliage.get_scaling (risk 0, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.

Returns: type, settings.

foliage.get_selected_instances (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
offsetintegerDefault 0.
limitintegerDefault 100.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.get_spawner (risk 0, smoke)​

No description.

ArgumentTypeDescription
spawnerstringrequired.

Returns: spawner.

foliage.get_type (risk 0, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.

Returns: type.

foliage.get_volume (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
volumestringrequired. Exact label of a ProceduralFoliageVolume.

Returns: volume.

foliage.import_instances (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
filestringrequired. Bare file name written by foliage.export_instances.
typestringImport every record into this type instead of the recorded ones.
replacebooleanRemove the existing instances of each target type first. Default false.

Returns: path, instances, types.

foliage.list_foliage_actors (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
allLevelsbooleanEvery loaded level instead of only the current level. Default false.
dryRunbooleanReport without applying (clean-up tools). Default false.

Returns: actors, count, instances.

foliage.list_level_types (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
folderstringDefault TEXT("/Game").
limitintegerDefault 100.

Returns: types, count.

foliage.list_spawner_types (risk 0, smoke)​

No description.

ArgumentTypeDescription
spawnerstringrequired.

Returns: spawner.

foliage.list_spawners (risk 0, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan recursively. Default TEXT("/Game").

Returns: spawners, count.

foliage.list_types (risk 0, smoke)​

No description.

ArgumentTypeDescription
folderstringDefault TEXT("/Game").
limitintegerDefault 100.

Returns: types, count.

foliage.list_volumes (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
includeBlockingbooleanInclude procedural blocking volumes. Default true.

Returns: volumes, count, removedInstances.

foliage.move_instances (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
indicesarray of integerrequired.
offset{x,y,z}

Returns: instances, count, total, boundsMin, boundsMax.

foliage.move_instances_to_type (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered source foliage type.
indicesarray of integerrequired. Instance indices.
targetTypestringrequired. Destination foliage type asset.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.move_to_level (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringRegistered foliage type; empty moves every type.
indicesarray of integerInstance indices (with type); empty moves every instance.
levelstringrequired. Target level: "persistent", the package short name or the full package name of a loaded level.

Returns: sourceLevel, targetLevel, moved, note.

foliage.nearest_instance (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
location{x,y,z}required.

Returns: instance, count.

foliage.paint_actor (risk 2, mutates, requires world, dryRun, smoke)​

No description.

ArgumentTypeDescription
actorstringrequired. Actor label or name whose surfaces receive instances.

Returns: type, attempts, placed, noHit, slope, height, layer, collision, overlap, removed, total, dryRun, instances.

foliage.paint_box (risk 2, mutates, requires world, dryRun, smoke)​

No description.

ArgumentTypeDescription
min{x,y,z}Box minimum (x, y; z averaged with max as the trace mid-height).
max{x,y,z}Box maximum.

Returns: type, attempts, placed, noHit, slope, height, layer, collision, overlap, removed, total, dryRun, instances.

foliage.paint_circle (risk 2, mutates, requires world, dryRun, smoke)​

No description.

ArgumentTypeDescription
center{x,y,z}Circle centre; z is the trace mid-height.
radiusnumberCircle radius (cm). Default 500.

Returns: type, attempts, placed, noHit, slope, height, layer, collision, overlap, removed, total, dryRun, instances.

foliage.paint_line (risk 2, mutates, requires world, dryRun, smoke)​

No description.

ArgumentTypeDescription
start{x,y,z}Segment start.
end{x,y,z}Segment end.
spacingnumberDistance between samples (cm). Default 100.
jitternumberRandom XY offset of each sample (cm). Default 0.

Returns: type, attempts, placed, noHit, slope, height, layer, collision, overlap, removed, total, dryRun, instances.

foliage.preview_trace (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type whose filters are evaluated.
location{x,y,z}Sample position; z is the trace mid-height.
traceHalfHeightnumberTrace half height (cm). Default 5000.

Returns: hit, location, normal, slopeDegrees, actor, component, landscape, rejection.

foliage.randomize_instances (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
indicesarray of integerInstance indices; empty means every instance.
seedintegerRandom seed. Default 0.
randomYawbooleanReplace yaw with a random value. Default true.
scaleMinnumberMinimum uniform scale. Default 1.
scaleMaxnumberMaximum uniform scale. Default 1.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.reapply_settings (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type.
indicesarray of integerInstance indices; empty means every instance.
seedintegerRandom seed. Default 0.
scalebooleanRe-roll scale from the scaling mode and ranges. Default true.
yawbooleanRe-roll yaw (0..360). Default true.
pitchbooleanRe-roll pitch within RandomPitchAngle. Default false.

Returns: type, attempts, placed, noHit, slope, height, layer, collision, overlap, removed, total, dryRun, instances.

foliage.rebuild (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
offsetintegerDefault 0.
limitintegerDefault 100.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.rebuild_all (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
allLevelsbooleanEvery loaded level instead of only the current level. Default false.
dryRunbooleanReport without applying (clean-up tools). Default false.

Returns: types, actors, removed, deletedTypes, dryRun.

foliage.remove_all (risk 3, mutates, destructive, requires world, dryRun, smoke)​

No description.

ArgumentTypeDescription
allLevelsbooleanEvery loaded level instead of only the current level. Default false.
dryRunbooleanReport without applying (clean-up tools). Default false.

Returns: types, actors, removed, deletedTypes, dryRun.

foliage.remove_by_type (risk 3, mutates, destructive, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
offsetintegerDefault 0.
limitintegerDefault 100.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.remove_filtered (risk 3, mutates, destructive, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
inBoxbooleanRestrict to the min/max box. Default false.
min{x,y,z}Box minimum (with inBox).
max{x,y,z}Box maximum (with inBox).
center{x,y,z}Sphere centre (with radius > 0).
radiusnumberSphere radius in centimetres; 0 disables the sphere test. Default 0.
minZnumberMinimum instance Z. Default -1.0e9.
maxZnumberMaximum instance Z. Default 1.0e9.
minScalenumberMinimum of the largest scale axis. Default 0.
maxScalenumberMaximum of the largest scale axis. Default 1.0e9.
limitintegerMaximum returned records. Default 100.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.remove_in_box (risk 3, mutates, destructive, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
min{x,y,z}World-space inclusive minimum bound.
max{x,y,z}World-space inclusive maximum bound.
limitintegerMaximum returned records. Default 100.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.remove_in_sphere (risk 3, mutates, destructive, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
center{x,y,z}World-space centre.
radiusnumberSphere radius in centimetres. Default 100.
limitintegerMaximum returned records. Default 100.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.remove_indices (risk 3, mutates, destructive, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
indicesarray of integerrequired.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.remove_spawner_type (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
spawnerstringrequired. Procedural foliage spawner asset.
typestringrequired. Foliage type asset.

Returns: spawner.

foliage.remove_type_from_level (risk 3, mutates, destructive, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.

Returns: types, count.

foliage.remove_unused_level_types (risk 3, mutates, destructive, requires world, dryRun, smoke)​

No description.

ArgumentTypeDescription
dryRunbooleanReport without applying. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.remove_volume (risk 3, mutates, destructive, requires world, smoke)​

No description.

ArgumentTypeDescription
volumesarray of stringrequired. Exact labels of ProceduralFoliageVolume or ProceduralFoliageBlockingVolume actors.
clearInstancesbooleanRemove the instances spawned by each procedural volume first. Default true.

Returns: volumes, count, removedInstances.

foliage.rename_type (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
namestringrequired.

Returns: type.

foliage.replace_type (risk 3, mutates, destructive, requires world, smoke)​

No description.

ArgumentTypeDescription
sourceTypestringrequired. Existing registered foliage type.
targetTypestringrequired. Destination foliage type asset.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.replace_type_mesh (risk 2, mutates, dryRun, smoke)​

No description.

ArgumentTypeDescription
folderstringContent folder to scan. Default TEXT("/Game").
fromMeshstringrequired. Static mesh currently used by the types.
toMeshstringrequired. Static mesh assigned instead.
dryRunbooleanReport the per-type changes without applying them. Default false.

Returns: items, count, changed, warnings, dryRun.

foliage.resimulate_all (risk 2, mutates, requires world, dryRun, smoke)​

No description.

ArgumentTypeDescription
respectFiltersbooleanApply the type slope, height and landscape-layer filters to the traced hits. Default true.
dryRunbooleanRun the simulations and traces without replacing instances. Default false.

Returns: volumes, desired, placed, noHit, slope, height, layer, collision, removed, instances, types, dryRun.

foliage.rotate_instances (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
indicesarray of integerrequired.
delta{x,y,z}

Returns: instances, count, total, boundsMin, boundsMax.

foliage.save_type (risk 2)​

No description.

ArgumentTypeDescription
typestringrequired.

Returns: type.

foliage.scale_instances (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
indicesarray of integerrequired.
multiplier{x,y,z}Default FUeaVec3(1,1,1).

Returns: instances, count, total, boundsMin, boundsMax.

foliage.scatter_grid (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
min{x,y,z}World-space minimum corner.
max{x,y,z}World-space maximum corner.
spacingnumberGrid spacing in centimetres. Default 100.
znumberPlacement height in centimetres. Default 0.
maxInstancesintegerMaximum instances to add. Default 1000.
seedintegerDeterministic yaw seed. Default 0.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.scatter_poisson (risk 2, mutates, requires world, dryRun, smoke)​

No description.

ArgumentTypeDescription
min{x,y,z}Rectangle minimum.
max{x,y,z}Rectangle maximum.
minDistancenumberMinimum distance between samples (cm). Default 100.
tracebooleanTrace to the surface; false places at z (Min.z) without filters. Default true.

Returns: type, attempts, placed, noHit, slope, height, layer, collision, overlap, removed, total, dryRun, instances.

foliage.scatter_random (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
min{x,y,z}World-space minimum corner.
max{x,y,z}World-space maximum corner.
spacingnumberGrid spacing in centimetres. Default 100.
znumberPlacement height in centimetres. Default 0.
maxInstancesintegerMaximum instances to add. Default 1000.
seedintegerDeterministic yaw seed. Default 0.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.select_instances (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
indicesarray of integerInstance indices.
replacebooleanReplace selection when true; otherwise add. Default true.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.set_actor_type_settings (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Actor foliage type asset (FoliageType_Actor).
attachToBasebooleanAttach spawned actors to the component they were placed on. Default true.
staticMeshOnlyboolean5.0+: render the actor's static meshes as instances instead of spawning actors (ignored with a note on 4.27). Default false.

Returns: type, settings.

foliage.set_affect_distance_field (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested setting state. Default true.

Returns: type.

foliage.set_affect_dynamic_indirect_lighting (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested setting state. Default true.

Returns: type.

foliage.set_align_max_angle (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberValue in degrees. Default 0.

Returns: type, settings.

foliage.set_align_to_normal (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested setting state. Default true.

Returns: type.

foliage.set_average_normal (risk 2, mutates, UE 5.0+, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanAverage the surface normal over several traces. Default true.
singleComponentbooleanOnly sample the component that was hit first. Default true.
sampleCountintegerNumber of normal samples (1..64). Default 10.

Returns: type, settings.

foliage.set_average_spread_distance (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberNumeric value. Default 0.

Returns: type.

foliage.set_cast_shadow (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested setting state. Default true.

Returns: type.

foliage.set_collision_enabled (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested setting state. Default true.

Returns: type.

foliage.set_collision_profile (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
profilestringrequired. Engine collision profile name.

Returns: type.

foliage.set_collision_radius (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberNumeric value. Default 0.

Returns: type.

foliage.set_collision_scale (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
scale{x,y,z}Scale applied to the mesh bounds in the world-collision test. Default FUeaVec3(0.9,0.9,0.9).

Returns: type, settings.

foliage.set_component_class (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Instanced-static-mesh foliage type asset.
componentClassstringrequired. Class deriving from FoliageInstancedStaticMeshComponent.

Returns: type, settings.

foliage.set_contact_shadow (risk 2, mutates, UE 5.0+, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested state. Default true.

Returns: type, settings.

foliage.set_cull_distance (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
minnumberInclusive lower value. Default 0.
maxnumberInclusive upper value. Default 0.

Returns: type.

foliage.set_cull_distance_scaling (risk 2, mutates, UE 5.2+, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested state. Default true.

Returns: type, settings.

foliage.set_custom_data (risk 2, mutates, UE 5.3+, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
indicesarray of integerrequired. Instance indices.
channelintegerCustom-data channel. Default 0.
valuenumberValue for the channel. Default 0.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.set_custom_data_channels (risk 2, mutates, UE 5.3+, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered instanced-static-mesh foliage type.
countintegerCustom data floats per instance (0..32). Default 1.

Returns: index, channels, values, component.

foliage.set_custom_depth (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRender into the custom depth pass. Default true.
stencilValueintegerStencil value 0..255. Default 0.

Returns: type, settings.

foliage.set_density (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberNumeric value. Default 0.

Returns: type.

foliage.set_dynamic_shadow (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested setting state. Default true.

Returns: type.

foliage.set_evaluate_world_position_offset (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested setting state. Default true.

Returns: type.

foliage.set_ground_slope_filter (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
minnumberInclusive lower value. Default 0.
maxnumberInclusive upper value. Default 0.

Returns: type.

foliage.set_height_filter (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
minnumberInclusive lower value. Default 0.
maxnumberInclusive upper value. Default 0.

Returns: type.

foliage.set_include_in_hlod (risk 2, mutates, UE 5.0+, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested setting state. Default true.

Returns: type.

foliage.set_initial_seed_density (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberNumeric value. Default 0.

Returns: type.

foliage.set_instance_transform (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
indicesarray of integerrequired.
transformUeaFoliageTransformrequired.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.set_instance_transforms (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
indicesarray of integerrequired. Instance indices.
transformsarray of UeaFoliageTransformrequired. One transform per index.

Returns: instances, count, total, boundsMin, boundsMax.

foliage.set_lighting_channels (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
channel0booleanLighting channel 0. Default true.
channel1booleanLighting channel 1. Default false.
channel2booleanLighting channel 2. Default false.

Returns: type, settings.

foliage.set_lightmap_resolution (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
overridebooleanOverride the mesh lightmap resolution. Default true.
resolutionintegerLightmap resolution (4..4096) used when overriding. Default 64.

Returns: type, settings.

foliage.set_material_override (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
slotintegerZero-based mesh material slot. Default 0.
materialstringrequired. Material-interface asset path.

Returns: type.

foliage.set_max_age (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberNumeric value. Default 0.

Returns: type.

foliage.set_max_initial_age (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberNumeric value. Default 0.

Returns: type.

foliage.set_max_initial_seed_offset (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberNumeric value. Default 0.

Returns: type.

foliage.set_mesh (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
meshstringrequired. Static mesh asset path.

Returns: type.

foliage.set_minimum_layer_weight (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberNumeric value. Default 0.

Returns: type.

foliage.set_mobility (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
mobilitystringrequired. Static, Stationary or Movable.

Returns: type, settings.

foliage.set_nanite_material_override (risk 2, mutates, UE 5.1+, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Instanced-static-mesh foliage type asset.
slotintegerZero-based slot. Default 0.
materialstringrequired. Material interface asset path.

Returns: type, settings.

foliage.set_num_steps (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberNumeric value. Default 0.

Returns: type.

foliage.set_overlap_priority (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberNumeric value. Default 0.

Returns: type.

foliage.set_procedural_distribution (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
spreadVariancenumberVariance of the spread distance (centimetres). Default 150.
distributionSeedintegerSeed of the distribution. Default 0.
proceduralScaleMinnumberScale of the youngest instance. Default 1.
proceduralScaleMaxnumberScale of the oldest instance. Default 3.

Returns: type, settings.

foliage.set_radius (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberNumeric value. Default 0.

Returns: type.

foliage.set_random_pitch (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberValue in degrees. Default 0.

Returns: type, settings.

foliage.set_random_yaw (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested setting state. Default true.

Returns: type.

foliage.set_receive_decals (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested setting state. Default true.

Returns: type.

foliage.set_runtime_virtual_texture (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested setting state. Default true.

Returns: type.

foliage.set_scalability (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
densityScalingbooleanScale instance density with foliage.DensityScale / scalability. Default false.
discardOnLoadbooleanDiscard instances on load when density scaling culls them. Default false.

Returns: type, settings.

foliage.set_seeds_per_step (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberNumeric value. Default 0.

Returns: type.

foliage.set_shade_growth (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
canGrowInShadebooleanInstances may grow in the shade of others. Default false.
spawnsInShadebooleanNew seeds may only spawn in shade. Default false.

Returns: type, settings.

foliage.set_shade_radius (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuenumberNumeric value. Default 0.

Returns: type.

foliage.set_shadow_cache_invalidation (risk 2, mutates, UE 5.3+, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valuestringrequired. Enum entry name (e.g. Auto, Always, Rigid, Static).

Returns: type, settings.

foliage.set_shadow_two_sided (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested state. Default true.

Returns: type, settings.

foliage.set_spawner (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
spawnerstringrequired.
propertystringrequired.
valuestringrequired.

Returns: spawner.

foliage.set_spawner_seed (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
spawnerstringrequired. Procedural foliage spawner asset.
valueintegerInteger seed/count or centimetre tile size. Default 0.
assetUeaAssetInfo
randomSeedintegerDefault 0.
tileSizenumberDefault 0.
numUniqueTilesintegerDefault 0.
typeCountintegerDefault 0.
typesarray of stringFoliage type assets simulated by the spawner.

Returns: spawner.

foliage.set_spawner_tile_size (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
spawnerstringrequired. Procedural foliage spawner asset.
valueintegerInteger seed/count or centimetre tile size. Default 0.
assetUeaAssetInfo
randomSeedintegerDefault 0.
tileSizenumberDefault 0.
numUniqueTilesintegerDefault 0.
typeCountintegerDefault 0.
typesarray of stringFoliage type assets simulated by the spawner.

Returns: spawner.

foliage.set_spawner_unique_tiles (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
spawnerstringrequired. Procedural foliage spawner asset.
valueintegerInteger seed/count or centimetre tile size. Default 0.
assetUeaAssetInfo
randomSeedintegerDefault 0.
tileSizenumberDefault 0.
numUniqueTilesintegerDefault 0.
typeCountintegerDefault 0.
typesarray of stringFoliage type assets simulated by the spawner.

Returns: spawner.

foliage.set_static_shadow (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested setting state. Default true.

Returns: type.

foliage.set_translucency_sort_priority (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valueintegerInteger value. Default 0.

Returns: type, settings.

foliage.set_type (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
propertystringrequired.
valuestringrequired.

Returns: type.

foliage.set_type_filters (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
landscapeLayersarray of string
exclusionLandscapeLayersarray of string
minimumLayerWeightstring
collisionWithWorldstring

Returns: type.

foliage.set_type_instance_settings (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
propertystringrequired.
valuestringrequired.

Returns: type.

foliage.set_type_placement (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
densitystring
radiusstring
zOffsetMinstring
zOffsetMaxstring
alignToNormalstring
randomYawstring
randomPitchAnglestring
groundSlopeMinstring
groundSlopeMaxstring

Returns: type.

foliage.set_type_procedural (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
propertystringrequired.
valuestringrequired.

Returns: type.

foliage.set_type_scaling (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired.
scalingstring
scaleXMinstring
scaleXMaxstring
scaleYMinstring
scaleYMaxstring
scaleZMinstring
scaleZMaxstring

Returns: type.

foliage.set_use_as_occluder (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested setting state. Default true.

Returns: type.

foliage.set_virtual_texture (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
texturesarray of stringRuntime virtual texture asset paths written to (replaces the list; empty clears it).
cullMipsintegerMips culled from the virtual texture pass (0..7). Default 0.
passTypestringMain-pass rendering: Never, Exclusive or Always. Default TEXT("Exclusive").

Returns: type, settings.

foliage.set_visible_in_ray_tracing (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
enabledbooleanRequested state. Default true.

Returns: type, settings.

foliage.set_volume (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
volumestringrequired. Exact label of a ProceduralFoliageVolume.
spawnerstringNew spawner asset; empty keeps the current one.
setLocationbooleanMove the volume to location. Default false.
location{x,y,z}New centre (with setLocation).
extent{x,y,z}New box half size; all zero keeps the brush.
tileOverlapnumberNew tile overlap (cm); negative keeps the current value. Default -1.

Returns: volume.

foliage.set_volume_filters (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
volumestringrequired. Exact label of a ProceduralFoliageVolume.
allowLandscapebooleanSpawn on landscapes. Default true.
allowBSPbooleanSpawn on BSP. Default true.
allowStaticMeshbooleanSpawn on static meshes. Default true.
allowTranslucentbooleanSpawn on translucent geometry. Default false.
allowFoliagebooleanSpawn on other foliage. Default false.

Returns: volume.

foliage.set_wpo_disable_distance (risk 2, mutates, UE 5.1+, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
valueintegerInteger value. Default 0.

Returns: type, settings.

foliage.set_z_offset (risk 2, mutates, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Foliage type asset.
minnumberInclusive lower value. Default 0.
maxnumberInclusive upper value. Default 0.

Returns: type.

foliage.simulate (risk 2, mutates, requires world, dryRun, smoke)​

No description.

ArgumentTypeDescription
volumestringrequired. Exact label of a ProceduralFoliageVolume.
respectFiltersbooleanApply the type slope, height and landscape-layer filters to the traced hits. Default true.
dryRunbooleanRun the simulation and traces without replacing the volume's instances. Default false.

Returns: volumes, desired, placed, noHit, slope, height, layer, collision, removed, instances, types, dryRun.

foliage.snap_to_ground (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type.
indicesarray of integerInstance indices; empty means every instance.
alignToNormalbooleanAlign to the surface normal (keeps yaw). Default false.
traceHalfHeightnumberTrace half height (cm). Default 5000.

Returns: type, attempts, placed, noHit, slope, height, layer, collision, overlap, removed, total, dryRun, instances.

foliage.stats (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
folderstringDefault TEXT("/Game").

Returns: items, count, changed, warnings, dryRun.

foliage.thin_instances (risk 3, mutates, destructive, requires world, dryRun, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type.
minDistancenumberMinimum distance (cm); 0 uses the type radius. Default 0.
dryRunbooleanReport without removing. Default false.

Returns: type, attempts, placed, noHit, slope, height, layer, collision, overlap, removed, total, dryRun, instances.

foliage.to_static_mesh_actors (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered instanced-static-mesh foliage type.
indicesarray of integerInstance indices; empty converts every instance (max 1000).
labelPrefixstringLabel prefix; actors are labelled _. Default TEXT("FoliageActor").
removeInstancesbooleanRemove the converted instances. Default false.

Returns: actors, count, removed, total.

foliage.transform_region (risk 2, mutates, requires world, smoke)​

No description.

ArgumentTypeDescription
typestringrequired. Registered foliage type asset.
min{x,y,z}Box minimum.
max{x,y,z}Box maximum.
offset{x,y,z}World offset added to each instance.
rotationDelta{x,y,z}Rotation delta (pitch, yaw, roll) applied to each instance.
scaleMultiplier{x,y,z}Per-axis scale multiplier. Default FUeaVec3(1,1,1).

Returns: instances, count, total, boundsMin, boundsMax.

foliage.validate (risk 0, smoke)​

No description.

ArgumentTypeDescription
folderstringDefault TEXT("/Game").

Returns: items, count, changed, warnings, dryRun.

foliage.validate_spawner (risk 0, smoke)​

No description.

ArgumentTypeDescription
spawnerstringrequired.

Returns: spawner.

foliage.volume_stats (risk 0, requires world, smoke)​

No description.

ArgumentTypeDescription
volumestringrequired. Exact label of a ProceduralFoliageVolume.

Returns: volumes, desired, placed, noHit, slope, height, layer, collision, removed, instances, types, dryRun.