Pular para o conteúdo principal

Kit landscape

149 ferramentas. Gerado a partir do código-fonte do plugin; não edite manualmente.

As descrições das ferramentas e dos argumentos são exibidas em inglês porque espelham o schema das ferramentas (o mesmo texto que o agente recebe em tools/list).

Guia​

The landscape kit creates and edits ALandscape actors of the editor world without opening Landscape Mode: heights, paint layers and weights, holes, edit layers, splines and grass types. Everything goes through public engine APIs (ALandscapeProxy::Import, FLandscapeEditDataInterface, ULandscapeInfo, ALandscape edit-layer calls, ULandscapeSplinesComponent). Water bodies are in the separate water kit (Water plugin).

Conventions:

  • landscape is the actor label, object name or path; read-only calls may omit it when the level has exactly one landscape. Start with landscape.list / landscape.get.
  • Region and brush coordinates are landscape vertex coordinates (0..N, inclusive regions), not world centimetres. landscape.get returns the vertex bounds; regions outside them are rejected.
  • Heights are landscape uint16 values (32768 = zero); weights are 0..255.
  • On a landscape with edit layers, height and weight tools write the active edit layer (landscape.set_active_edit_layer), or the first edit layer when none is active — never the merged result, so edits survive the next layer merge.

1. Create, inspect and sculpt​

Coordinates: sculpt tools use landscape vertex coordinates and uint16 heights (32768 = actor Z; one unit = scale.Z/128 cm). Convert with landscape.world_to_vertex / vertex_to_world, or query in world units with landscape.sample_world (up to 1024 XY points → surface Z, normal, slope) and landscape.line_trace (this landscape's collision only; call update_collision after edits).

Building terrain from data: landscape.create_from_height_array takes a row-major height array of exactly (componentsX·sectionsPerComponent·sectionSizeQuads+1)² values; pass replace to rebuild an existing landscape in place, keeping its label, transform, material and settings. landscape.resample changes resolution but keeps the footprint (heights and paint weights resampled, X/Y scale adjusted). landscape.resize changes the component count (anchor corner|center, fillHeight or edge extension). landscape.duplicate copies heights, weights, material and settings to a new actor at offset. All four refuse world-partition landscapes (see list_proxies) and read only the first edit layer.

Shaping: stamp_shape (hill/cone/plateau/crater), flatten_path (road bed along a polyline; point z = target height or -1 to follow the terrain), stamp_height_region (set/add/max/min a block), noise_region (Perlin noise with seed/octaves/frequency), erode_region (thermal), scale_region, clamp_region, copy_region (also between landscapes), mirror_region (symmetric maps). Finish with recalc_normals, update_collision, rebuild_bounds.

Analysis: slope_map (degrees grid plus steep fraction), height_histogram, find_flat_spots (flattest vertices within slope/height limits, with world positions), get_bounds.

Settings: typed setters for LOD, lighting, collision (profile/overlap), navigation, rendering, virtual textures, bounds extension, physical material and hole material. Negative numbers and empty strings leave a value unchanged. Per-component: get_component_settings and set_component_{lod,lighting,collision_mip,bounds_extension,material_override} with sectionBaseX/Y or allComponents.

2. Paint layers and layer infos​

A paint layer is a name backed by a ULandscapeLayerInfoObject asset. The landscape material decides which layer names it blends (Landscape Layer Blend nodes); the layer infos store the weights.

  • landscape.create_layer_info {folder, name, weightBlended} creates the asset; its paint-layer name is the asset name. landscape.add_paint_layer {landscape, layerInfo} assigns it (target layer on 5.5+, editor layer settings before).
  • landscape.auto_create_layer_infos {landscape, folder, names} creates <Layer>_LayerInfo assets and assigns them — for the given names, or for every layer of the landscape material when names is empty. Layers that already have an info are listed in skipped.
  • landscape.list_layers lists names, assets and blend mode; landscape.validate_layers warns about layers without an info and material layers that are not assigned.
  • landscape.replace_layer_info {landscape, layer, layerInfo} swaps the asset behind a layer; the painted weights move to the new info (it must not already be assigned).
  • landscape.remove_layer_info {landscape, layer} deletes the layer's weights and unassigns it (the asset stays).

3. Weights and holes​

  • Read: landscape.get_weight (min/max/average over a region), landscape.get_weight_grid (row-major 0..255 values, at most 65536 vertices per call).
  • Write: paint_layer_region (constant box), paint_layer_circle (disc with falloff 0..1 of the radius; vertices outside the disc keep their weight), paint_layer_gradient (axis x or y), set_weight_grid (row-major values, the inverse of get_weight_grid), fill_layer (whole landscape), clear_layer (deletes the layer's weights, keeps the layer).
  • Weight-blended layers renormalise the other weight-blended layers of the same vertices, exactly as in Landscape Mode.
  • Holes: landscape.set_visibility_layer {landscape, minX..maxY, hidden} writes the engine visibility layer (hidden:true cuts, false restores). Holes render only with a material that has a Landscape Visibility Mask.
  • Files: landscape.export_weightmap {landscape, layer, file} writes .png or .raw through the engine exporter; landscape.import_weightmap {landscape, layer, file, minX, minY, width} reads an 8-bit .raw (row-major; width defaults to the landscape width, height = size / width). PNG import is not offered (no public decoder in the kit's dependencies).

4. Edit layers​

UE 5.7+ landscapes always have edit layers. On older engines a landscape created without them needs landscape.enable_edit_layers (UE 4.27–5.6; converts the existing data into a default layer).

  • landscape.list_edit_layers — bottom-to-top stack with visible, locked, heightmapAlpha, weightmapAlpha, active, type and blueprint brushes.
  • add_edit_layer {name} (the engine makes names unique; read editLayer.name), remove_edit_layer (not the last one; clears the active selection if it pointed there), rename_edit_layer, reorder_edit_layer {layer, newIndex}, set_active_edit_layer {layer} (empty clears), set_edit_layer_alpha {layer, alpha, target:'heightmap'|'weightmap'} (heightmap -1..1, weightmap 0..1), set_edit_layer_locked, set_edit_layer_visible (enabled), clear_edit_layer {heightmap, weightmap} (refused on a locked layer).
  • landscape.list_blueprint_brushes lists the ALandscapeBlueprintBrushBase actors per layer (Water bodies appear here when they carve the landscape).

5. Splines​

Control points and segments live in the landscape's ULandscapeSplinesComponent (created on the first point). Locations are landscape-local centimetres; indices come from spline_list and spline_list_segments and shift down after removals.

  • Points: spline_add_point, spline_set_point_transform (move/rotate), spline_set_width, spline_set_side_falloff, spline_set_point_settings (paint layer, raise/lower terrain, end falloff, mesh offset, point mesh — all fields written), spline_get_point, spline_list, spline_remove_point (also removes its segments).
  • Segments: spline_connect {startIndex, endIndex, startTangent, endTangent, layerName} (0 tangents = half the point distance with automatic flipping), spline_list_segments, spline_get_segment, spline_set_segment_tangents, spline_set_segment (paint layer, raise/lower), spline_set_mesh_entries (complete list of {mesh, scale, scaleToWidth, centerH, forwardAxis, upAxis}; empty clears), spline_remove_segment.
  • Whole network: spline_import_points {points, connect, closedLoop, layerName} appends a chain, spline_export_points returns points + segments (feed points back to import), spline_rebuild (meshes and collision), spline_apply (rasterises raise/lower and layer painting into the landscape — the splines edit layer when present; applied:false means nothing changed), spline_clear.

6. Grass​

  • Types: grass_create_type {folder, name}, grass_list_types {folder}, grass_get_type (every variety, typed), grass_audit_type, grass_set_density_scaling.
  • Varieties (by index): grass_add_variety {mesh, density}, grass_remove_variety, grass_get_variety (every reflected property as text), grass_set_variety {settings:[{key,value}]} (FGrassVariety names, dotted paths such as GrassDensity.Default, ScaleX.Min; all keys are validated first and a parse error restores the variety), grass_set_scale (Uniform/Free/LockXY + ranges), and typed setters grass_set_density, set_start_cull, set_end_cull, set_min_lod, set_jitter, set_random_rotation, set_align_to_surface, set_grid, set_receive_decals, set_dynamic_shadow, set_contact_shadow (5.0+), set_landscape_lightmap, set_cpu_copy.
  • Materials: grass is spawned from a Landscape Grass Output node in the landscape material. landscape.list_grass_outputs {material | landscape} lists its pins and assigned grass types (edit the node with the material kit). landscape.grass_flush drops cached grass so it regenerates.

Recipes​

Layered terrain in eight calls.

  1. landscape.create {name:'Terrain', componentsX:4, componentsY:4, sectionSizeQuads:63}.
  2. Sculpt with the region tools of section 1 (noise, terrace, smooth).
  3. landscape.set_material {landscape:'Terrain', material:'/Game/M_Landscape'} (a layered material).
  4. landscape.auto_create_layer_infos {landscape:'Terrain', folder:'/Game/Landscape/Layers'}.
  5. landscape.fill_layer {landscape:'Terrain', layer:'Grass'}.
  6. landscape.paint_layer_circle {landscape:'Terrain', layer:'Rock', centerX:100, centerY:100, radius:30, weight:255, falloff:0.5}.
  7. landscape.spline_import_points {landscape:'Terrain', points:[...], connect:true, layerName:'Dirt'}.
  8. landscape.spline_apply {landscape:'Terrain'}, then landscape.validate_layers.

Weight round trip. get_weight_grid a tile, change values, set_weight_grid with the same origin and width. For whole-landscape transfers use export_weightmap (.raw) and import_weightmap.

Non-destructive edits. add_edit_layer {name:'Roads'} → set_active_edit_layer {layer:'Roads'} → sculpt/paint → set_edit_layer_alpha to blend it, set_edit_layer_visible {enabled:false} to compare, clear_edit_layer to start over.

Gotchas​

  • Layer names are case-sensitive FNames taken from the layer-info asset; create_layer_info names the layer after the asset, auto_create_layer_infos after the requested name.
  • Painting is visible only when the landscape material has a matching layer; weights are stored regardless.
  • remove_layer_info, replace_layer_info and enable_edit_layers run engine operations that may show a short progress bar; they do not open dialogs.
  • Spline indices are positions in the component arrays: re-read spline_list / spline_list_segments after removing points or segments.
  • enable_edit_layers is hidden on UE 5.7+, where every landscape already has edit layers.

Ferramentas​

Legenda. risco 0 = somente leitura, 1 = operação inofensiva do editor, 2 = altera asset, 3 = apaga/substitui asset, 4 = projeto/config/build, 5 = potencialmente destrutivo (chamadas acima de MaxAutoRisk exigem "_confirm": true). altera = roda numa transação (edit.undo reverte). requer PIE / requer mundo = recusado sem sessão PIE / sem nível aberto. requer plugin = indisponível quando o plugin está desativado. dryRun = aceita o argumento dryRun. smoke = coberto por edit.self_test.

landscape.add_edit_layer (risco 2, altera, requer mundo, smoke)​

Adds a standard edit layer on top of the stack; the reply's editLayer carries the (uniquified) name.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
namestringobrigatório. Requested name; the engine makes it unique.

Retorna: editLayers, count, editLayer.

landscape.add_height_region (risco 2, altera, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
deltaintegerHeight delta in landscape uint16 units. Padrão 0.

Retorna: landscape, message.

landscape.add_paint_layer (risco 2, altera, requer mundo, smoke)​

Assigns a layer-info asset to the landscape as a paint layer (the layer name comes from the asset). Returns the paint layers.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerInfostringobrigatório. Layer-info asset path (see create_layer_info).

Retorna: layers, count.

landscape.area_statistics (risco 0, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
stepintegerSampling interval in vertices. Padrão 1.

Retorna: samples, minHeight, maxHeight, averageHeight, maxSlope, averageSlope.

landscape.audit (risco 0, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: components, layers, hasMaterial, outdatedGrassMaps, warnings.

landscape.auto_create_layer_infos (risco 2, altera, requer mundo, smoke)​

Creates _LayerInfo assets in a folder and assigns them, for the given names or for every layer of the landscape material. Layers that already have a layer info are skipped.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
folderstringobrigatório. Content folder for the new _LayerInfo assets.
namesarray of stringLayer names to create; empty uses every layer declared by the landscape material.
weightBlendedbooleanWeight-blended layer infos when true. Padrão true.

Retorna: created, skipped, layers.

landscape.brush_flatten (risco 2, altera, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
centerXintegerBrush centre X in landscape vertex coordinates. Padrão 0.
centerYintegerBrush centre Y in landscape vertex coordinates. Padrão 0.
radiusintegerBrush radius in vertices. Padrão 8.
strengthintegerSigned height strength in uint16 units. Padrão 128.
falloffnumberEdge falloff from 0 (hard) through 1 (linear). Padrão 1.0.
targetHeightintegerAbsolute target height for flatten and terrace tools. Padrão 32768.
seedintegerDeterministic noise seed. Padrão 0.
terraceStepintegerTerrace step height in uint16 units. Padrão 256.

Retorna: landscape, message.

landscape.brush_lower (risco 2, altera, requer mundo, smoke)​

Lowers a circle by strength with falloff.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
centerXintegerBrush centre X in landscape vertex coordinates. Padrão 0.
centerYintegerBrush centre Y in landscape vertex coordinates. Padrão 0.
radiusintegerBrush radius in vertices. Padrão 8.
strengthintegerSigned height strength in uint16 units. Padrão 128.
falloffnumberEdge falloff from 0 (hard) through 1 (linear). Padrão 1.0.
targetHeightintegerAbsolute target height for flatten and terrace tools. Padrão 32768.
seedintegerDeterministic noise seed. Padrão 0.
terraceStepintegerTerrace step height in uint16 units. Padrão 256.

Retorna: landscape, message.

landscape.brush_raise (risco 2, altera, requer mundo, smoke)​

Raises a circle by strength with falloff (the circular raise brush).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
centerXintegerBrush centre X in landscape vertex coordinates. Padrão 0.
centerYintegerBrush centre Y in landscape vertex coordinates. Padrão 0.
radiusintegerBrush radius in vertices. Padrão 8.
strengthintegerSigned height strength in uint16 units. Padrão 128.
falloffnumberEdge falloff from 0 (hard) through 1 (linear). Padrão 1.0.
targetHeightintegerAbsolute target height for flatten and terrace tools. Padrão 32768.
seedintegerDeterministic noise seed. Padrão 0.
terraceStepintegerTerrace step height in uint16 units. Padrão 256.

Retorna: landscape, message.

landscape.brush_smooth (risco 2, altera, requer mundo, smoke)​

Circular smoothing weighted by the brush falloff.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
centerXintegerBrush centre X in landscape vertex coordinates. Padrão 0.
centerYintegerBrush centre Y in landscape vertex coordinates. Padrão 0.
radiusintegerBrush radius in vertices. Padrão 8.
strengthintegerSigned height strength in uint16 units. Padrão 128.
falloffnumberEdge falloff from 0 (hard) through 1 (linear). Padrão 1.0.
targetHeightintegerAbsolute target height for flatten and terrace tools. Padrão 32768.
seedintegerDeterministic noise seed. Padrão 0.
terraceStepintegerTerrace step height in uint16 units. Padrão 256.

Retorna: landscape, message.

landscape.clamp_region (risco 2, altera, requer mundo, smoke)​

Clamps the heights of a region into [minHeight, maxHeight].

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
minHeightintegerLowest allowed uint16 height. Padrão 0.
maxHeightintegerHighest allowed uint16 height. Padrão 65535.

Retorna: landscape, message.

landscape.clear_edit_layer (risco 2, altera, requer mundo, smoke)​

Clears the sculpted heights and/or painted weights of one edit layer.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Edit layer name.
heightmapbooleanClear sculpted heights. Padrão true.
weightmapbooleanClear painted weights and holes. Padrão true.

Retorna: editLayers, count, editLayer.

landscape.clear_layer (risco 2, altera, requer mundo, smoke)​

Deletes every painted weight of a paint layer; the layer stays assigned.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Landscape paint layer name.

Retorna: landscape, message.

landscape.copy_region (risco 2, altera, requer mundo, smoke)​

Copies a height block to another place, optionally from another landscape.

ArgumentoTipoDescrição
landscapestringobrigatório. Target landscape.
sourceLandscapestringSource landscape; empty = the target.
sourceMinXintegerSource inclusive minimum X. Padrão 0.
sourceMinYintegerSource inclusive minimum Y. Padrão 0.
sourceMaxXintegerSource inclusive maximum X. Padrão 0.
sourceMaxYintegerSource inclusive maximum Y. Padrão 0.
destXintegerTarget X of the source's first column. Padrão 0.
destYintegerTarget Y of the source's first row. Padrão 0.

Retorna: landscape, message.

landscape.create (risco 2, altera, requer mundo, smoke)​

Creates a flat landscape (height 32768) without Landscape Mode. Smallest: 1x1 components, 7 quads.

ArgumentoTipoDescrição
namestringobrigatório. Outliner label.
componentsXintegerComponent count in X (1..32). Padrão 1.
componentsYintegerComponent count in Y (1..32). Padrão 1.
sectionSizeQuadsintegerQuads in each subsection: 7,15,31,63,127,255. Padrão 7.
sectionsPerComponentintegerOne or two subsections per component. Padrão 1.
location{x,y,z}Actor location in cm.
scale{x,y,z}Actor scale; 100 means one metre per quad. Padrão FUeaVec3(100,100,100).

Retorna: landscape, message.

landscape.create_from_height_array (risco 2, altera, requer mundo, smoke)​

Creates a landscape from a row-major uint16 height array, or rebuilds an existing one (replace) keeping its transform, material and settings.

ArgumentoTipoDescrição
namestringOutliner label of the new landscape; empty keeps the replaced landscape's label.
replacestringExisting landscape to rebuild from the array: its transform, material and settings are kept, location/rotation/scale/material args are ignored, and the old actor is destroyed.
componentsXintegerComponent count in X (1..32). Padrão 1.
componentsYintegerComponent count in Y (1..32). Padrão 1.
sectionSizeQuadsintegerQuads per section: 7, 15, 31, 63, 127 or 255. Padrão 7.
sectionsPerComponentintegerSections per component axis: 1 or 2. Padrão 1.
location{x,y,z}Actor location in cm (new landscapes only).
rotation{x,y,z}Actor rotation in degrees (new landscapes only).
scale{x,y,z}Actor scale (new landscapes only); 100 = one metre per quad. Padrão FUeaVec3(100,100,100).
heightsarray of integerobrigatório. Row-major uint16 heights (0..65535, 32768 = actor Z): exactly (componentsXsectionsPerComponentsectionSizeQuads+1) x (same for Y) values.
materialstringOptional landscape material asset path (new landscapes only).

Retorna: landscape, oldVertsX, oldVertsY, newVertsX, newVertsY, copiedLayers, skippedLayers, copiedSettings, dryRun, changedActors, message.

landscape.create_layer_info (risco 2, altera, smoke)​

Creates a ULandscapeLayerInfoObject asset /; its paint-layer name is the asset name. Assign it with landscape.add_paint_layer.

ArgumentoTipoDescrição
folderstringobrigatório. Content folder.
namestringobrigatório. Bare layer-info asset name.
weightBlendedbooleanWeight-blended layer when true. Padrão true.

Retorna: asset, message.

landscape.delete (risco 3, altera, destrutivo, requer mundo, smoke)​

Deletes a landscape actor. Declared on the last landscape class so the self-test removes its shared fixture only after every landscape theme ran.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: landscape, message.

landscape.duplicate (risco 2, altera, requer mundo, dryRun, smoke)​

Copies a landscape (heights, paint weights, material, settings) to a new actor at an offset.

ArgumentoTipoDescrição
landscapestringobrigatório. Source landscape reference.
namestringobrigatório. Label of the copy.
offset{x,y,z}World offset of the copy in cm from the source location.
copyLayersbooleanCopy paint-layer weights (layers with an assigned layer-info asset). Padrão true.
dryRunbooleanOnly validate and report what would be created. Padrão false.

Retorna: landscape, oldVertsX, oldVertsY, newVertsX, newVertsY, copiedLayers, skippedLayers, copiedSettings, dryRun, changedActors, message.

landscape.enable_edit_layers (risco 2, altera, UE ≤5.6, requer mundo, smoke)​

Converts a landscape without edit layers to edit layers (UE 5.6 and older; newer landscapes always have them). Returns the edit layers.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: editLayers, count, editLayer.

landscape.erode_region (risco 2, altera, requer mundo, smoke)​

Thermal erosion: material slides from steep neighbours until slopes fall under the talus threshold.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
iterationsintegerPasses 1..50. Padrão 5.
talusintegerHeight difference (uint16) a neighbour may exceed before material slides. Padrão 64.
ratenumberFraction of the excess moved per pass, 0..0.5. Padrão 0.25.

Retorna: landscape, message.

landscape.export_heightmap (risco 0, requer mundo)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
filestringobrigatório. Absolute output file path.

Retorna: landscape, message.

landscape.export_weightmap (risco 0, requer mundo)​

Exports a paint layer's weightmap to an absolute .png or .raw path (engine ULandscapeInfo::ExportLayer).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Assigned paint layer name.
filestringobrigatório. Absolute file path (.png or .raw on export; 8-bit .raw on import).
minXintegerImport only: region origin X vertex. Padrão 0.
minYintegerImport only: region origin Y vertex. Padrão 0.
widthintegerImport only: raw image width in pixels; 0 uses the landscape width. Padrão 0.

Retorna: landscape, message.

landscape.fill_layer (risco 2, altera, requer mundo, smoke)​

Fills the whole landscape with a paint layer at full weight.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Landscape paint layer name.

Retorna: landscape, message.

landscape.find_flat_spots (risco 0, requer mundo, smoke)​

Finds flat vertices (slope and height filters) for placing buildings, spawns or props; flattest first.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
stepintegerSampling interval in vertices. Padrão 1.
maxSlopeDegreesnumberMaximum slope in degrees. Padrão 10.
minHeightintegerLowest accepted uint16 height. Padrão 0.
maxHeightintegerHighest accepted uint16 height. Padrão 65535.
maxResultsintegerResult limit 1..1000 (flattest first). Padrão 50.

Retorna: spots, matches, samples.

landscape.flatten_path (risco 2, altera, requer mundo, smoke)​

Levels a band along a polyline (road or river bed), heights interpolated between the points.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
pointsarray of {x,y,z}obrigatório. Path points: x, y in vertex coordinates; z = target uint16 height, or -1 to use the terrain height at that point. At least two.
halfWidthnumberHalf-width of the fully flattened band in vertices. Padrão 2.
falloffWidthnumberWidth of the blend band outside it in vertices. Padrão 2.
strengthnumberBlend strength 0..1. Padrão 1.0.

Retorna: landscape, message.

landscape.flatten_region (risco 2, altera, requer mundo, smoke)​

Moves a region toward a target height with a strength; mode raise/lower restricts the direction (fill pits or cut bumps only).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
heightintegerTarget uint16 height, 0 through 65535. Padrão 32768.
strengthnumberBlend toward the target, 0..1 (1 = exact). Padrão 1.0.
modestringboth, raise (only lifts lower vertices) or lower (only cuts higher vertices). Padrão TEXT("both").

Retorna: landscape, message.

landscape.get (risco 0, requer mundo, smoke)​

Landscape summary: vertex bounds, component layout, transform, material, edit-layer flag.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: landscape, message.

landscape.get_bounds (risco 0, requer mundo, smoke)​

World bounds of the landscape components (read-only) and collision component count.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: landscape, boundsMin, boundsMax, components, collisionComponents.

landscape.get_component (risco 0, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
sectionBaseXintegerComponent section base X. Padrão 0.
sectionBaseYintegerComponent section base Y. Padrão 0.

Retorna: component, materialOverride.

landscape.get_component_settings (risco 0, requer mundo, smoke)​

Per-component settings (LOD, lighting, collision mips, bounds extensions, material overrides, world bounds) for one or all components.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape reference.
sectionBaseXintegerComponent section base X (see landscape.list_components). Padrão 0.
sectionBaseYintegerComponent section base Y. Padrão 0.
allComponentsbooleanApply to / read every component instead of one. Padrão false.

Retorna: components, count.

landscape.get_height (risco 0, requer mundo, smoke)​

uint16 height and world Z (cm) at a landscape vertex.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
xintegerLandscape vertex X coordinate. Padrão 0.
yintegerLandscape vertex Y coordinate. Padrão 0.

Retorna: height, worldZ, message.

landscape.get_height_range (risco 0, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
deltaintegerHeight delta in landscape uint16 units. Padrão 0.

Retorna: minX, minY, width, height, heights, minHeight, maxHeight.

landscape.get_heights_grid (risco 0, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
deltaintegerHeight delta in landscape uint16 units. Padrão 0.

Retorna: minX, minY, width, height, heights, minHeight, maxHeight.

landscape.get_normal (risco 0, requer mundo, smoke)​

World-space normal, slope and height at a vertex.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
xintegerLandscape vertex X coordinate. Padrão 0.
yintegerLandscape vertex Y coordinate. Padrão 0.

Retorna: height, worldZ, normal, slopeDegrees, world, layers.

landscape.get_outdated_grass_maps (risco 0, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: components, layers, hasMaterial, outdatedGrassMaps, warnings.

landscape.get_settings (risco 0, requer mundo, smoke)​

Reads every reflected landscape-actor setting the kit manages (materials, LOD, lighting, collision, navigation, bounds, rendering).

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: landscape, settings.

landscape.get_weight (risco 0, requer mundo, smoke)​

Min/max/average weight of a paint layer over an inclusive vertex region.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Paint layer name.
minXintegerInclusive minimum X. Padrão 0.
minYintegerInclusive minimum Y. Padrão 0.
maxXintegerInclusive maximum X. Padrão 0.
maxYintegerInclusive maximum Y. Padrão 0.
weightintegerConstant weight, 0 through 255. Padrão 0.

Retorna: minWeight, maxWeight, averageWeight, samples.

landscape.get_weight_grid (risco 0, requer mundo, smoke)​

Row-major weights (0..255) of a paint layer over an inclusive vertex region (at most 65536 vertices).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Paint layer name.
minXintegerInclusive minimum X. Padrão 0.
minYintegerInclusive minimum Y. Padrão 0.
maxXintegerInclusive maximum X. Padrão 0.
maxYintegerInclusive maximum Y. Padrão 0.
weightintegerConstant weight, 0 through 255. Padrão 0.

Retorna: width, height, weights.

landscape.grass_add_variety (risco 2, altera, smoke)​

Appends a variety with a static mesh and a density.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
meshstringobrigatório. Static mesh for the new variety.
densitynumberInitial density in instances per 10 m x 10 m (0..1000). Padrão 100.

Retorna: grassType, varieties, settings.

landscape.grass_audit_type (risco 0, smoke)​

Reports varieties without a mesh, with zero density, or with an end cull distance below the start.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.

Retorna: grassType, varieties, settings.

landscape.grass_create_type (risco 2, altera, smoke)​

Creates an empty ULandscapeGrassType asset /. Add varieties with landscape.grass_add_variety.

ArgumentoTipoDescrição
folderstringobrigatório. Content folder under /Game.
namestringobrigatório. Bare grass-type asset name.

Retorna: grassType, varieties, settings.

landscape.grass_flush (risco 2, altera, requer mundo, smoke)​

Flushes the landscape's grass components and cached grass maps so they regenerate; returns the stale-map count.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: components, layers, hasMaterial, outdatedGrassMaps, warnings.

landscape.grass_get_type (risco 0, smoke)​

Returns a grass type with every variety (mesh, density, culling, scaling, placement, rendering flags).

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.

Retorna: grassType, varieties, settings.

landscape.grass_get_variety (risco 0, smoke)​

Returns every reflected property of one variety as text in settings (keys usable with grass_set_variety).

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index. Padrão 0.

Retorna: grassType, varieties, settings.

landscape.grass_list_types (risco 0, smoke)​

Lists grass type assets under a folder.

ArgumentoTipoDescrição
folderstringContent folder to search. Padrão TEXT("/Game").
nameContainsstringOptional case-insensitive name filter.
recursivebooleanSearch sub-folders. Padrão true.

Retorna: grassTypes, count.

landscape.grass_remove_variety (risco 3, altera, destrutivo, smoke)​

Removes one variety from a grass type.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index. Padrão 0.

Retorna: grassType, varieties, settings.

landscape.grass_set_align_to_surface (risco 2, altera, smoke)​

Aligns instances of one variety to the landscape surface.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
enabledbooleanRequested state. Padrão true.

Retorna: grassType, varieties, settings.

landscape.grass_set_contact_shadow (risco 2, altera, UE 5.1+, smoke)​

Lets instances of one variety cast contact shadows (UE5).

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
enabledbooleanRequested state. Padrão true.

Retorna: grassType, varieties, settings.

landscape.grass_set_cpu_copy (risco 2, altera, smoke)​

Keeps a CPU copy of the instance buffer of one variety (needed for runtime instance queries).

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
enabledbooleanRequested state. Padrão true.

Retorna: grassType, varieties, settings.

landscape.grass_set_density (risco 2, altera, smoke)​

Sets the default density (0..1000 instances per 10 m x 10 m) of one variety.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
valuenumberRequested value (see the tool description for its range). Padrão 0.

Retorna: grassType, varieties, settings.

landscape.grass_set_density_scaling (risco 2, altera, smoke)​

Enables or disables scalability density scaling for the whole grass type (index is ignored).

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
enabledbooleanRequested state. Padrão true.

Retorna: grassType, varieties, settings.

landscape.grass_set_dynamic_shadow (risco 2, altera, smoke)​

Lets instances of one variety cast dynamic shadows.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
enabledbooleanRequested state. Padrão true.

Retorna: grassType, varieties, settings.

landscape.grass_set_end_cull (risco 2, altera, smoke)​

Sets the default end cull distance (cm) of one variety.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
valuenumberRequested value (see the tool description for its range). Padrão 0.

Retorna: grassType, varieties, settings.

landscape.grass_set_grid (risco 2, altera, smoke)​

Places instances of one variety on a jittered grid instead of randomly.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
enabledbooleanRequested state. Padrão true.

Retorna: grassType, varieties, settings.

landscape.grass_set_jitter (risco 2, altera, smoke)​

Sets the grid placement jitter (0..1) of one variety.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
valuenumberRequested value (see the tool description for its range). Padrão 0.

Retorna: grassType, varieties, settings.

landscape.grass_set_landscape_lightmap (risco 2, altera, smoke)​

Lights instances of one variety with the landscape lightmap.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
enabledbooleanRequested state. Padrão true.

Retorna: grassType, varieties, settings.

landscape.grass_set_min_lod (risco 2, altera, smoke)​

Sets the minimum mesh LOD (-1..8, -1 = automatic) of one variety.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
valuenumberRequested value (see the tool description for its range). Padrão 0.

Retorna: grassType, varieties, settings.

landscape.grass_set_random_rotation (risco 2, altera, smoke)​

Enables random yaw for one variety.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
enabledbooleanRequested state. Padrão true.

Retorna: grassType, varieties, settings.

landscape.grass_set_receive_decals (risco 2, altera, smoke)​

Lets instances of one variety receive decals.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
enabledbooleanRequested state. Padrão true.

Retorna: grassType, varieties, settings.

landscape.grass_set_scale (risco 2, altera, smoke)​

Sets the scaling mode and the X/Y/Z scale ranges of one variety.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index. Padrão 0.
scalingstringUniform (X range scales all axes), Free (independent X/Y/Z) or LockXY (X for X and Y, Z separate). Padrão TEXT("Uniform").
scaleXMinnumberX (or uniform) scale range minimum. Padrão 1.
scaleXMaxnumberX (or uniform) scale range maximum. Padrão 1.
scaleYMinnumberY scale range minimum (Free only). Padrão 1.
scaleYMaxnumberY scale range maximum (Free only). Padrão 1.
scaleZMinnumberZ scale range minimum (Free and LockXY). Padrão 1.
scaleZMaxnumberZ scale range maximum (Free and LockXY). Padrão 1.

Retorna: grassType, varieties, settings.

landscape.grass_set_start_cull (risco 2, altera, smoke)​

Sets the default start cull distance (cm) of one variety.

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index (settings that belong to the whole type ignore it). Padrão 0.
valuenumberRequested value (see the tool description for its range). Padrão 0.

Retorna: grassType, varieties, settings.

landscape.grass_set_variety (risco 2, altera, smoke)​

Assigns reflected FGrassVariety properties of one variety (dotted paths into structs, e.g. GrassDensity.Default, ScaleX.Min).

ArgumentoTipoDescrição
grassTypestringobrigatório. Landscape grass type asset path or unique name.
indexintegerZero-based variety index. Padrão 0.
settingsarray of UeaKeyValueobrigatório. Property assignments in engine text form (e.g. {key:'GrassDensity.Default',value:'50'}, {key:'bUseGrid',value:'true'}).

Retorna: grassType, varieties, settings.

landscape.has_material (risco 0, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: components, layers, hasMaterial, outdatedGrassMaps, warnings.

landscape.height_histogram (risco 0, requer mundo, smoke)​

Height distribution of a region in buckets.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
stepintegerSampling interval in vertices. Padrão 1.
bucketsintegerBucket count 2..256. Padrão 16.

Retorna: counts, minHeight, maxHeight, bucketWidth, minWorldZ, maxWorldZ, samples.

landscape.import_weightmap (risco 2, altera, requer mundo)​

Imports an 8-bit .raw weightmap (row-major, width x height bytes) into a paint layer at (minX, minY).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Assigned paint layer name.
filestringobrigatório. Absolute file path (.png or .raw on export; 8-bit .raw on import).
minXintegerImport only: region origin X vertex. Padrão 0.
minYintegerImport only: region origin Y vertex. Padrão 0.
widthintegerImport only: raw image width in pixels; 0 uses the landscape width. Padrão 0.

Retorna: landscape, message.

landscape.line_trace (risco 0, requer mundo, smoke)​

Traces a world ray against this landscape's collision only (nearest hit).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
start{x,y,z}Ray start in world cm.
end{x,y,z}Ray end in world cm.

Retorna: hit, location, normal, distance, component, vertexX, vertexY, height, componentsTested.

landscape.list (risco 0, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: landscapes, count.

landscape.list_blueprint_brushes (risco 0, requer mundo, smoke)​

Lists the landscape blueprint brushes of every edit layer.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: brushes, count.

landscape.list_components (risco 0, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: components, count.

landscape.list_edit_layers (risco 0, requer mundo, smoke)​

Lists edit layers bottom to top with visibility, lock, alphas, active flag and blueprint brushes.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: editLayers, count, editLayer.

landscape.list_grass_outputs (risco 0, smoke)​

Lists the Landscape Grass Output entries (pin name + grass type) of a material, or of the landscape's material.

ArgumentoTipoDescrição
materialstringMaterial or material instance to inspect; empty uses the landscape's material.
landscapestringLandscape actor reference, used when material is empty.

Retorna: material, outputs, count.

landscape.list_layers (risco 0, requer mundo, smoke)​

Lists paint layers with their layer-info asset and blend mode.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: layers, count.

landscape.list_proxies (risco 0, requer mundo, smoke)​

Lists the landscape actor and its streaming proxies (world-partition or level streaming).

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: proxies, count.

landscape.mirror_region (risco 2, altera, requer mundo, smoke)​

Mirrors (symmetric map) or flips a region along X or Y.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
axisstringx mirrors across the vertical centre line (left/right), y across the horizontal one. Padrão TEXT("x").
modestringmirror copies the first half onto the second (symmetric map); flip reverses the whole region. Padrão TEXT("mirror").

Retorna: landscape, message.

landscape.noise_region (risco 2, altera, requer mundo, smoke)​

Deterministic fBm Perlin noise inside a circular brush (seed, octaves, frequency).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
centerXintegerBrush centre X vertex. Padrão 0.
centerYintegerBrush centre Y vertex. Padrão 0.
radiusintegerBrush radius in vertices. Padrão 8.
strengthintegerPeak amplitude in uint16 units. Padrão 128.
falloffnumberEdge falloff exponent 0 (hard) .. 1 (linear). Padrão 1.0.
seedintegerNoise seed (offsets the noise field). Padrão 0.
octavesintegerOctaves 1..8. Padrão 4.
frequencynumberBase frequency in cycles per vertex (0.001..1). Padrão 0.1.

Retorna: landscape, message.

landscape.paint_layer_circle (risco 2, altera, requer mundo, smoke)​

Paints a disc of weight around a vertex, with an optional linear falloff toward the rim. Vertices outside the disc are left unchanged.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Assigned paint layer name.
centerXintegerBrush centre X vertex. Padrão 0.
centerYintegerBrush centre Y vertex. Padrão 0.
radiusintegerBrush radius in vertices (the whole circle must lie inside the landscape). Padrão 8.
weightintegerCentre paint weight, 0 through 255. Padrão 255.
falloffnumberFraction of the radius (0..1) over which the weight fades linearly to 0 at the rim; 0 paints a hard disc. Padrão 0.

Retorna: landscape, message.

landscape.paint_layer_gradient (risco 2, altera, requer mundo, smoke)​

Paints a linear weight gradient over an inclusive region along x or y.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Assigned paint layer name.
minXintegerInclusive region minimum X. Padrão 0.
minYintegerInclusive region minimum Y. Padrão 0.
maxXintegerInclusive region maximum X. Padrão 0.
maxYintegerInclusive region maximum Y. Padrão 0.
startWeightintegerWeight at the start edge (low X, or low Y when axis is y). Padrão 0.
endWeightintegerWeight at the end edge. Padrão 255.
axisstringGradient axis: x or y. Padrão TEXT("x").

Retorna: landscape, message.

landscape.paint_layer_region (risco 2, altera, requer mundo, smoke)​

Paints a constant weight (0..255) over an inclusive vertex box.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Paint layer name.
minXintegerInclusive minimum X. Padrão 0.
minYintegerInclusive minimum Y. Padrão 0.
maxXintegerInclusive maximum X. Padrão 0.
maxYintegerInclusive maximum Y. Padrão 0.
weightintegerConstant weight, 0 through 255. Padrão 0.

Retorna: landscape, message.

landscape.ramp_region (risco 2, altera, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
startXintegerStart X vertex. Padrão 0.
startYintegerStart Y vertex. Padrão 0.
endXintegerEnd X vertex. Padrão 1.
endYintegerEnd Y vertex. Padrão 1.
startHeightintegerStart height in uint16 units. Padrão 32768.
endHeightintegerEnd height in uint16 units. Padrão 32768.
halfWidthintegerHalf-width in vertices. Padrão 1.

Retorna: landscape, message.

landscape.rebuild_bounds (risco 2, altera, requer mundo, smoke)​

Recomputes cached component bounds from the heights and refreshes transforms/render state.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: landscape, boundsMin, boundsMax, components, collisionComponents.

landscape.recalc_normals (risco 2, altera, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: landscape, message.

landscape.remove_edit_layer (risco 3, altera, destrutivo, requer mundo, smoke)​

Deletes an edit layer and its content; the last remaining layer cannot be removed.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Edit layer name.

Retorna: editLayers, count, editLayer.

landscape.remove_layer_info (risco 3, altera, destrutivo, requer mundo, smoke)​

Removes a paint layer from the landscape: deletes its painted weights and unassigns its layer info (the asset stays).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Landscape paint layer name.

Retorna: layers, count.

landscape.rename_edit_layer (risco 2, altera, requer mundo, smoke)​

Renames an edit layer; the new name must be unique.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Current edit layer name.
newNamestringobrigatório. New unique name.

Retorna: editLayers, count, editLayer.

landscape.reorder_edit_layer (risco 2, altera, requer mundo, smoke)​

Moves an edit layer to another stack index (0 = bottom).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Edit layer name.
newIndexintegerDestination stack index (0 = bottom). Padrão 0.

Retorna: editLayers, count, editLayer.

landscape.replace_layer_info (risco 2, altera, requer mundo, smoke)​

Replaces the layer-info asset of a paint layer with another asset; painted weights move to the new layer info.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Paint layer whose layer info (and painted weights) moves to the new asset.
layerInfostringobrigatório. Layer-info asset that replaces it; must not already be a paint layer of this landscape.

Retorna: layers, count.

landscape.resample (risco 3, altera, destrutivo, requer mundo, smoke)​

Changes the vertex resolution (section size, sections, components) keeping the world footprint; heights and paint weights are bilinearly resampled and the landscape is rebuilt in place.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape reference.
componentsXintegerNew component count in X; 0 keeps the current count. Padrão 0.
componentsYintegerNew component count in Y; 0 keeps the current count. Padrão 0.
sectionSizeQuadsintegerNew quads per section (7, 15, 31, 63, 127, 255); 0 keeps. Padrão 0.
sectionsPerComponentintegerNew sections per component (1 or 2); 0 keeps. Padrão 0.
dryRunbooleanOnly validate and report the new size. Padrão false.

Retorna: landscape, oldVertsX, oldVertsY, newVertsX, newVertsY, copiedLayers, skippedLayers, copiedSettings, dryRun, changedActors, message.

landscape.resize (risco 3, altera, destrutivo, requer mundo, smoke)​

Changes the component count keeping the quad size (crop or extend); the landscape is rebuilt in place.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape reference.
componentsXintegerNew component count in X (1..32). Padrão 1.
componentsYintegerNew component count in Y (1..32). Padrão 1.
anchorstringcorner keeps the minimum corner fixed; center grows or shrinks evenly (the actor moves so the terrain stays in place). Padrão TEXT("corner").
fillHeightintegerHeight for new vertices (0..65535); -1 extends the nearest edge heights. Padrão -1.
dryRunbooleanOnly validate and report the new size. Padrão false.

Retorna: landscape, oldVertsX, oldVertsY, newVertsX, newVertsY, copiedLayers, skippedLayers, copiedSettings, dryRun, changedActors, message.

landscape.sample (risco 0, requer mundo, smoke)​

Height, normal, slope and paint-layer weights at a vertex.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
xintegerLandscape vertex X coordinate. Padrão 0.
yintegerLandscape vertex Y coordinate. Padrão 0.

Retorna: height, worldZ, normal, slopeDegrees, world, layers.

landscape.sample_world (risco 0, requer mundo, smoke)​

Terrain height, normal and slope under world XY points (bilinear), for placing actors on the ground.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
pointsarray of {x,y,z}obrigatório. World points in cm (x, y used; z ignored), 1..1024.

Retorna: samples, inside.

landscape.scale_region (risco 2, altera, requer mundo, smoke)​

Scales the relief of a region around a pivot height (exaggerate or flatten).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
factornumberMultiplier 0..10 (below 1 flattens, above 1 exaggerates). Padrão 1.0.
pivotintegerPivot uint16 height; -1 uses the region mean. Padrão -1.

Retorna: landscape, message.

landscape.set_active_edit_layer (risco 2, altera, requer mundo, smoke)​

Selects the edit layer that height and weight tools write to (empty clears the selection).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringEdit layer that height/weight tools write to; empty clears the selection (tools then use the first layer).

Retorna: editLayers, count, editLayer.

landscape.set_bounds_extension (risco 2, altera, requer mundo, smoke)​

Sets the landscape-wide Z bounds extensions in cm.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape reference.
negativeZnumberExtra bounds below the terrain in cm; -1 unchanged. Padrão -1.
positiveZnumberExtra bounds above the terrain in cm; -1 unchanged. Padrão -1.

Retorna: landscape, settings.

landscape.set_collision_mip (risco 2, altera, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
valueintegerRequested nonnegative setting value. Padrão 0.

Retorna: landscape, message.

landscape.set_collision_settings (risco 2, altera, requer mundo, smoke)​

Sets the collision profile and overlap/bake flags of the landscape actor; collision components are recreated.

ArgumentoTipoDescrição
collisionProfilestringCollision profile name (e.g. BlockAll); empty unchanged.
landscapestringobrigatório. Landscape reference.
generateOverlapEventsstringtrue, false or empty (unchanged).
bakeMaterialPositionOffsetIntoCollisionstringtrue, false or empty.

Retorna: landscape, settings.

landscape.set_component_bounds_extension (risco 2, altera, requer mundo, smoke)​

Sets per-component Z bounds extensions (for world-position-offset materials).

ArgumentoTipoDescrição
negativeZBoundsExtensionnumberExtra bounds below the terrain in cm (for world-position-offset materials). Padrão 0.
positiveZBoundsExtensionnumberExtra bounds above the terrain in cm. Padrão 0.

Retorna: components, count.

landscape.set_component_collision_mip (risco 2, altera, requer mundo, smoke)​

Sets complex and simple collision mip levels of one or all components (collision is rebuilt).

ArgumentoTipoDescrição
collisionMipLevelintegerComplex collision mip level (0..5). Padrão 0.
simpleCollisionMipLevelintegerSimple collision mip level (0..5); 0 = no separate simple collision. Padrão 0.

Retorna: components, count.

landscape.set_component_lighting (risco 2, altera, requer mundo, smoke)​

Sets static lighting resolution override and lightmass LOD bias of one or all components.

ArgumentoTipoDescrição
staticLightingResolutionnumberStatic lighting resolution override; 0 = use the landscape value (engine default). Padrão 0.
lightingLodBiasintegerLightmass LOD bias; -1 = automatic (engine default). Padrão -1.

Retorna: components, count.

landscape.set_component_lod (risco 2, altera, requer mundo, smoke)​

Sets forced LOD and LOD bias of one or all components.

ArgumentoTipoDescrição
forcedLodintegerForced render LOD; -1 = automatic (engine default). Padrão -1.
lodBiasintegerRender LOD bias (engine default 0). Padrão 0.

Retorna: components, count.

landscape.set_component_material_override (risco 2, altera, requer mundo, smoke)​

Sets or clears the material and hole-material override of one or all components.

ArgumentoTipoDescrição
materialstringMaterial override asset path; empty clears the override.
holeMaterialstringHole material override asset path; empty clears it.

Retorna: components, count.

landscape.set_edit_layer_alpha (risco 2, altera, requer mundo, smoke)​

Sets the heightmap (-1..1) or weightmap (0..1) blend alpha of an edit layer.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Edit layer name.
alphanumberBlend alpha: heightmap -1..1 (negative subtracts), weightmap 0..1. Padrão 1.
targetstringheightmap or weightmap. Padrão TEXT("heightmap").

Retorna: editLayers, count, editLayer.

landscape.set_edit_layer_locked (risco 2, altera, requer mundo, smoke)​

Locks (enabled=true) or unlocks an edit layer against edits.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Edit layer name.
enabledbooleanRequested state. Padrão true.

Retorna: editLayers, count, editLayer.

landscape.set_edit_layer_visible (risco 2, altera, requer mundo, smoke)​

Shows (enabled=true) or hides an edit layer in the merged landscape.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Edit layer name.
enabledbooleanRequested state. Padrão true.

Retorna: editLayers, count, editLayer.

landscape.set_height_region (risco 2, altera, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
heightintegerTarget uint16 height, 0 through 65535. Padrão 32768.

Retorna: landscape, message.

landscape.set_hole_material (risco 2, altera, requer mundo, smoke)​

Sets or clears the hole material used where the visibility layer is painted.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape reference.
assetstringAsset path; empty clears the reference.

Retorna: landscape, settings.

landscape.set_lighting_settings (risco 2, altera, requer mundo, smoke)​

Sets lighting and shadow flags of the landscape actor.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape reference.
staticLightingResolutionnumberStatic lighting resolution; -1 unchanged. Padrão -1.
castShadowstringtrue, false or empty (unchanged).
castDynamicShadowstringtrue, false or empty.
castStaticShadowstringtrue, false or empty.
castFarShadowstringtrue, false or empty.
affectDistanceFieldLightingstringtrue, false or empty.

Retorna: landscape, settings.

landscape.set_lod_settings (risco 2, altera, requer mundo, smoke)​

Sets LOD screen size and distribution settings of the landscape actor.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape reference.
lod0ScreenSizenumberScreen size of LOD0; -1 unchanged. Padrão -1.
lod0DistributionSettingnumberLOD0 distribution multiplier; -1 unchanged. Padrão -1.
lodDistributionSettingnumberDistribution multiplier of the other LODs; -1 unchanged. Padrão -1.

Retorna: landscape, settings.

landscape.set_material (risco 2, altera, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
materialstringobrigatório. Material asset path.

Retorna: landscape, message.

landscape.set_navigation_settings (risco 2, altera, requer mundo, smoke)​

Sets navigation relevance and collision fill for navmesh generation.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape reference.
usedForNavigationstringtrue, false or empty (unchanged).
fillCollisionUnderLandscapeForNavmeshstringtrue, false or empty.

Retorna: landscape, settings.

landscape.set_physical_material (risco 2, altera, requer mundo, smoke)​

Sets or clears the default physical material of the landscape.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape reference.
assetstringAsset path; empty clears the reference.

Retorna: landscape, settings.

landscape.set_rendering_settings (risco 2, altera, requer mundo, smoke)​

Sets custom depth, max draw distance and texture streaming multiplier.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape reference.
renderCustomDepthstringtrue, false or empty (unchanged).
customDepthStencilValueintegerCustom depth stencil value 0..255; -1 unchanged. Padrão -1.
maxDrawDistancenumberMax draw distance in cm (0 = infinite); -1 unchanged. Padrão -1.
streamingDistanceMultipliernumberTexture streaming distance multiplier; -1 unchanged. Padrão -1.

Retorna: landscape, settings.

landscape.set_settings (risco 2, altera, requer mundo, smoke)​

Sets allowlisted landscape-actor properties by name (see get_settings for the keys) through the details-panel route.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
settingsarray of UeaKeyValueProperty assignments: StaticLightingLOD, CollisionMipLevel, SimpleCollisionMipLevel, VirtualTextureRenderPassType.

Retorna: landscape, settings.

landscape.set_simple_collision_mip (risco 2, altera, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
valueintegerRequested nonnegative setting value. Padrão 0.

Retorna: landscape, message.

landscape.set_static_lighting_lod (risco 2, altera, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
valueintegerRequested nonnegative setting value. Padrão 0.

Retorna: landscape, message.

landscape.set_transform (risco 2, altera, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
location{x,y,z}World location in centimetres.
rotation{x,y,z}World rotation in degrees.
scale{x,y,z}Actor scale. Padrão FUeaVec3(100,100,100).

Retorna: landscape, message.

landscape.set_virtual_texture_settings (risco 2, altera, requer mundo, smoke)​

Sets the runtime virtual textures the landscape writes to, their LOD range and the main-pass mode.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape reference.
runtimeVirtualTexturesarray of stringRuntime virtual texture asset paths the landscape renders into (replaces the list).
keepTexturesbooleanKeep the current list instead of replacing it with runtimeVirtualTextures. Padrão false.
numLodsintegerLowest mips rendered to the virtual texture (0..12); -1 unchanged. Padrão -1.
lodBiasintegerLOD bias when rendering to the virtual texture (0..8); -1 unchanged. Padrão -1.
mainPassstringMain pass: Never, Exclusive or Always; empty unchanged.

Retorna: landscape, settings.

landscape.set_visibility_layer (risco 2, altera, requer mundo, smoke)​

Cuts (hidden=true) or restores holes over an inclusive vertex region through the landscape visibility layer.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
hiddenbooleantrue cuts a hole (needs a material with a Landscape Visibility Mask to render), false restores the surface. Padrão true.

Retorna: landscape, message.

landscape.set_weight_grid (risco 2, altera, requer mundo, smoke)​

Writes row-major weights (0..255) into a region starting at (minX, minY); the inverse of get_weight_grid.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
layerstringobrigatório. Assigned paint layer name.
minXintegerRegion origin X vertex. Padrão 0.
minYintegerRegion origin Y vertex. Padrão 0.
widthintegerRegion width in vertices. Padrão 0.
weightsarray of integerobrigatório. Row-major weights 0..255, exactly width*height values.

Retorna: landscape, message.

landscape.slope_map (risco 0, requer mundo, smoke)​

Grid of world-space slopes (degrees) over a region, with steep-area statistics.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
stepintegerSampling interval in vertices. Padrão 1.
maxSlopeDegreesnumberSlope threshold in degrees for the steep count. Padrão 30.

Retorna: columns, rows, slopes, minSlope, maxSlope, averageSlope, steepSamples, steepFraction.

landscape.slope_statistics (risco 0, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
stepintegerSampling interval in vertices. Padrão 1.

Retorna: samples, minHeight, maxHeight, averageHeight, maxSlope, averageSlope.

landscape.smooth_region (risco 2, altera, requer mundo, smoke)​

3x3 box-blur smoothing of a region, repeated for iterations and blended by strength.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerInclusive minimum X vertex. Padrão 0.
minYintegerInclusive minimum Y vertex. Padrão 0.
maxXintegerInclusive maximum X vertex. Padrão 0.
maxYintegerInclusive maximum Y vertex. Padrão 0.
iterationsintegerBlur passes, 1..20. Padrão 1.
strengthnumberBlend of each pass, 0..1. Padrão 1.0.

Retorna: landscape, message.

landscape.spline_add_point (risco 2, altera, requer mundo, smoke)​

Adds an unconnected control point (landscape-local location, half-width, side falloff), creating the spline component when missing.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
location{x,y,z}Landscape-local control-point location in centimetres.
rotation{x,y,z}Control-point rotation in degrees.
widthnumberHalf-width in centimetres (positive). Padrão 500.
sideFalloffnumberSide falloff in centimetres (nonnegative). Padrão 500.

Retorna: controlPoints, segmentCount, message.

landscape.spline_apply (risco 2, altera, requer mundo, smoke)​

Applies the splines to the landscape: raises/lowers heights and paints the configured layers (splines edit layer when present).

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: applied, landscape, message.

landscape.spline_clear (risco 3, altera, destrutivo, requer mundo, smoke)​

Removes every control point and segment of the landscape splines.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: controlPoints, segmentCount, message.

landscape.spline_connect (risco 2, altera, requer mundo, smoke)​

Connects two control points with a new segment.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
startIndexintegerControl point at the segment start. Padrão 0.
endIndexintegerControl point at the segment end. Padrão 1.
startTangentnumberStart tangent length in centimetres; 0 uses half the point distance. Padrão 0.
endTangentnumberEnd tangent length in centimetres; 0 uses half the point distance. Padrão 0.
layerNamestringPaint layer painted under the segment when splines are applied; empty paints nothing.

Retorna: segments, count, segment.

landscape.spline_export_points (risco 0, requer mundo, smoke)​

Exports control points and segments as typed arrays (feed the points to spline_import_points to recreate a chain).

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: points, segments.

landscape.spline_get_point (risco 0, requer mundo, smoke)​

Returns one control point.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
indexintegerZero-based existing control-point index (see spline_list). Padrão 0.

Retorna: controlPoints, segmentCount, message.

landscape.spline_get_segment (risco 0, requer mundo, smoke)​

Returns one segment (endpoints, tangent lengths, deformation settings, mesh entries) in the reply's segment.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
segmentintegerZero-based segment index (see spline_list_segments). Padrão 0.

Retorna: segments, count, segment.

landscape.spline_import_points (risco 2, altera, requer mundo, smoke)​

Appends control points in order and, by default, connects consecutive points with segments (optionally closing the loop).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
pointsarray of UeaLandSplineImportPointobrigatório. Points appended in order (at least two when connect is true).
connectbooleanConnect consecutive points with segments. Padrão true.
closedLoopbooleanAlso connect the last point back to the first. Padrão false.
layerNamestringPaint layer painted under the new segments when splines are applied.

Retorna: points, segments.

landscape.spline_list (risco 0, requer mundo, smoke)​

Lists the control points and the segment count.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: controlPoints, segmentCount, message.

landscape.spline_list_segments (risco 0, requer mundo, smoke)​

Lists segments with endpoints, tangents, deformation settings and meshes.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: segments, count, segment.

landscape.spline_rebuild (risco 2, altera, requer mundo, smoke)​

Rebuilds spline meshes and collision of the existing network.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: controlPoints, segmentCount, message.

landscape.spline_remove_point (risco 3, altera, destrutivo, requer mundo, smoke)​

Removes a control point and every segment connected to it; later indices shift down.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
indexintegerZero-based existing control-point index (see spline_list). Padrão 0.

Retorna: controlPoints, segmentCount, message.

landscape.spline_remove_segment (risco 3, altera, destrutivo, requer mundo, smoke)​

Removes one segment (its control points stay).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
segmentintegerZero-based segment index (see spline_list_segments). Padrão 0.

Retorna: segments, count, segment.

landscape.spline_set_mesh_entries (risco 2, altera, requer mundo, smoke)​

Replaces the spline mesh entries of one segment (mesh, scale, axes) and rebuilds its meshes.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
segmentintegerZero-based segment index. Padrão 0.
meshesarray of UeaLandSplineMeshEntryComplete new mesh list; empty clears the meshes.

Retorna: segments, count, segment.

landscape.spline_set_point_settings (risco 2, altera, requer mundo, smoke)​

Writes a control point's deformation (layer, raise/lower, end falloff) and point-mesh settings.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
indexintegerZero-based existing control-point index. Padrão 0.
layerNamestringPaint layer painted under the point when splines are applied; empty paints nothing.
raiseTerrainbooleanRaise the terrain up to the spline when applied. Padrão true.
lowerTerrainbooleanLower the terrain down to the spline when applied. Padrão true.
endFalloffnumberFalloff at a dead-end point, in centimetres. Padrão 0.
segmentMeshOffsetnumberVertical offset of segment meshes at this point, in centimetres. Padrão 0.
meshstringStatic mesh placed at the point; empty removes it.
meshScale{x,y,z}Scale of the point mesh. Padrão FUeaVec3(1,1,1).

Retorna: controlPoints, segmentCount, message.

landscape.spline_set_point_transform (risco 2, altera, requer mundo, smoke)​

Moves and rotates a control point (landscape-local), updating connected segments.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
indexintegerZero-based existing control-point index. Padrão 0.
location{x,y,z}New landscape-local location in centimetres.
rotation{x,y,z}New rotation in degrees (pitch, yaw, roll).

Retorna: controlPoints, segmentCount, message.

landscape.spline_set_segment (risco 2, altera, requer mundo, smoke)​

Writes a segment's deformation settings (paint layer, raise/lower terrain).

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
segmentintegerZero-based segment index. Padrão 0.
layerNamestringPaint layer painted under the segment when splines are applied; empty paints nothing.
raiseTerrainbooleanRaise the terrain up to the spline when applied. Padrão true.
lowerTerrainbooleanLower the terrain down to the spline when applied. Padrão true.

Retorna: segments, count, segment.

landscape.spline_set_segment_tangents (risco 2, altera, requer mundo, smoke)​

Sets the start/end tangent lengths of a segment.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
segmentintegerZero-based segment index. Padrão 0.
startTangentnumberStart tangent length in centimetres (negative flips the direction). Padrão 0.
endTangentnumberEnd tangent length in centimetres (negative flips the direction). Padrão 0.

Retorna: segments, count, segment.

landscape.spline_set_side_falloff (risco 2, altera, requer mundo, smoke)​

Sets a control point's side falloff in centimetres.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
indexintegerZero-based existing control-point index. Padrão 0.
valuenumberNonnegative width or falloff in centimetres. Padrão 0.

Retorna: controlPoints, segmentCount, message.

landscape.spline_set_width (risco 2, altera, requer mundo, smoke)​

Sets a control point's half-width in centimetres.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
indexintegerZero-based existing control-point index. Padrão 0.
valuenumberNonnegative width or falloff in centimetres. Padrão 0.

Retorna: controlPoints, segmentCount, message.

landscape.stamp_height_region (risco 2, altera, requer mundo, smoke)​

Writes a row-major block of heights (set, add, max or min) with a blend strength.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
minXintegerX vertex of the block's first column. Padrão 0.
minYintegerY vertex of the block's first row. Padrão 0.
columnsintegerBlock width in vertices. Padrão 1.
rowsintegerBlock height in vertices. Padrão 1.
heightsarray of integerobrigatório. Row-major values (columns*rows). set/max/min: absolute uint16 heights; add: signed deltas.
modestringset, add, max or min. Padrão TEXT("set").
strengthnumberBlend of the result, 0..1. Padrão 1.0.

Retorna: landscape, message.

landscape.stamp_shape (risco 2, altera, requer mundo, smoke)​

Adds a procedural feature: hill, cone, plateau or crater.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
shapestringhill (smooth bump), cone, plateau (flat top) or crater (raised rim, sunken bowl). Padrão TEXT("hill").
centerXintegerCentre X vertex. Padrão 0.
centerYintegerCentre Y vertex. Padrão 0.
radiusintegerRadius in vertices. Padrão 8.
heightDeltaintegerSigned peak height change in uint16 units (negative digs). Padrão 512.
innernumberPlateau: fraction of the radius that is flat top (0..0.95). Crater: rim position (0.3..0.95). Padrão 0.5.

Retorna: landscape, message.

landscape.terrace_region (risco 2, altera, requer mundo, smoke)​

Sem descrição.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape actor reference.
centerXintegerBrush centre X in landscape vertex coordinates. Padrão 0.
centerYintegerBrush centre Y in landscape vertex coordinates. Padrão 0.
radiusintegerBrush radius in vertices. Padrão 8.
strengthintegerSigned height strength in uint16 units. Padrão 128.
falloffnumberEdge falloff from 0 (hard) through 1 (linear). Padrão 1.0.
targetHeightintegerAbsolute target height for flatten and terrace tools. Padrão 32768.
seedintegerDeterministic noise seed. Padrão 0.
terraceStepintegerTerrace step height in uint16 units. Padrão 256.

Retorna: landscape, message.

landscape.update_collision (risco 2, altera, requer mundo, smoke)​

Recreates every collision component from the current heights (use after height edits before traces or physics).

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: landscape, boundsMin, boundsMax, components, collisionComponents.

landscape.validate_layers (risco 0, requer mundo, smoke)​

Reports paint layers without a layer-info asset and whether the landscape has a material.

ArgumentoTipoDescrição
landscapestringLandscape actor label, name, or path. Empty selects the only landscape.

Retorna: components, layers, hasMaterial, outdatedGrassMaps, warnings.

landscape.vertex_to_world (risco 0, requer mundo, smoke)​

Converts landscape vertex coordinates (and a uint16 height, or the terrain height) to a world location.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape reference.
xnumberVertex X (fractional allowed). Padrão 0.
ynumberVertex Y (fractional allowed). Padrão 0.
heightnumberuint16 height; -1 samples the terrain at (x, y). Padrão -1.

Retorna: vertexX, vertexY, height, world, inside, componentSectionBaseX, componentSectionBaseY.

landscape.world_to_vertex (risco 0, requer mundo, smoke)​

Converts a world location (cm) to landscape vertex coordinates and uint16 height.

ArgumentoTipoDescrição
landscapestringobrigatório. Landscape reference.
location{x,y,z}World location in cm.

Retorna: vertexX, vertexY, height, world, inside, componentSectionBaseX, componentSectionBaseY.