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:
landscapeis the actor label, object name or path; read-only calls may omit it when the level has exactly one landscape. Start withlandscape.list/landscape.get.- Region and brush coordinates are landscape vertex coordinates (0..N, inclusive regions), not
world centimetres.
landscape.getreturns 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>_LayerInfoassets and assigns them — for the givennames, or for every layer of the landscape material whennamesis empty. Layers that already have an info are listed inskipped.landscape.list_layerslists names, assets and blend mode;landscape.validate_layerswarns 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 withfalloff0..1 of the radius; vertices outside the disc keep their weight),paint_layer_gradient(axisx or y),set_weight_grid(row-major values, the inverse ofget_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:truecuts,falserestores). Holes render only with a material that has a Landscape Visibility Mask. - Files:
landscape.export_weightmap {landscape, layer, file}writes.pngor.rawthrough the engine exporter;landscape.import_weightmap {landscape, layer, file, minX, minY, width}reads an 8-bit.raw(row-major;widthdefaults 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 withvisible,locked,heightmapAlpha,weightmapAlpha,active,typeand blueprintbrushes.add_edit_layer {name}(the engine makes names unique; readeditLayer.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_brusheslists theALandscapeBlueprintBrushBaseactors 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_pointsreturns points + segments (feedpointsback 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:falsemeans 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 asGrassDensity.Default,ScaleX.Min; all keys are validated first and a parse error restores the variety),grass_set_scale(Uniform/Free/LockXY + ranges), and typed settersgrass_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 thematerialkit).landscape.grass_flushdrops cached grass so it regenerates.
Recipes
Layered terrain in eight calls.
landscape.create {name:'Terrain', componentsX:4, componentsY:4, sectionSizeQuads:63}.- Sculpt with the region tools of section 1 (noise, terrace, smooth).
landscape.set_material {landscape:'Terrain', material:'/Game/M_Landscape'}(a layered material).landscape.auto_create_layer_infos {landscape:'Terrain', folder:'/Game/Landscape/Layers'}.landscape.fill_layer {landscape:'Terrain', layer:'Grass'}.landscape.paint_layer_circle {landscape:'Terrain', layer:'Rock', centerX:100, centerY:100, radius:30, weight:255, falloff:0.5}.landscape.spline_import_points {landscape:'Terrain', points:[...], connect:true, layerName:'Dirt'}.landscape.spline_apply {landscape:'Terrain'}, thenlandscape.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_infonames the layer after the asset,auto_create_layer_infosafter the requested name. - Painting is visible only when the landscape material has a matching layer; weights are stored regardless.
remove_layer_info,replace_layer_infoandenable_edit_layersrun 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_segmentsafter removing points or segments. enable_edit_layersis 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
MaxAutoRiskexigem"_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 argumentodryRun. smoke = coberto poredit.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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
name | string | obrigató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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
delta | integer | Height 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layerInfo | string | obrigatório. Layer-info asset path (see create_layer_info). |
Retorna: layers, count.
landscape.area_statistics (risco 0, requer mundo, smoke)
Sem descrição.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
step | integer | Sampling interval in vertices. Padrão 1. |
Retorna: samples, minHeight, maxHeight, averageHeight, maxSlope, averageSlope.
landscape.audit (risco 0, requer mundo, smoke)
Sem descrição.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
folder | string | obrigatório. Content folder for the new |
names | array of string | Layer names to create; empty uses every layer declared by the landscape material. |
weightBlended | boolean | Weight-blended layer infos when true. Padrão true. |
Retorna: created, skipped, layers.
landscape.brush_flatten (risco 2, altera, requer mundo, smoke)
Sem descrição.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
centerX | integer | Brush centre X in landscape vertex coordinates. Padrão 0. |
centerY | integer | Brush centre Y in landscape vertex coordinates. Padrão 0. |
radius | integer | Brush radius in vertices. Padrão 8. |
strength | integer | Signed height strength in uint16 units. Padrão 128. |
falloff | number | Edge falloff from 0 (hard) through 1 (linear). Padrão 1.0. |
targetHeight | integer | Absolute target height for flatten and terrace tools. Padrão 32768. |
seed | integer | Deterministic noise seed. Padrão 0. |
terraceStep | integer | Terrace 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
centerX | integer | Brush centre X in landscape vertex coordinates. Padrão 0. |
centerY | integer | Brush centre Y in landscape vertex coordinates. Padrão 0. |
radius | integer | Brush radius in vertices. Padrão 8. |
strength | integer | Signed height strength in uint16 units. Padrão 128. |
falloff | number | Edge falloff from 0 (hard) through 1 (linear). Padrão 1.0. |
targetHeight | integer | Absolute target height for flatten and terrace tools. Padrão 32768. |
seed | integer | Deterministic noise seed. Padrão 0. |
terraceStep | integer | Terrace 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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
centerX | integer | Brush centre X in landscape vertex coordinates. Padrão 0. |
centerY | integer | Brush centre Y in landscape vertex coordinates. Padrão 0. |
radius | integer | Brush radius in vertices. Padrão 8. |
strength | integer | Signed height strength in uint16 units. Padrão 128. |
falloff | number | Edge falloff from 0 (hard) through 1 (linear). Padrão 1.0. |
targetHeight | integer | Absolute target height for flatten and terrace tools. Padrão 32768. |
seed | integer | Deterministic noise seed. Padrão 0. |
terraceStep | integer | Terrace 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
centerX | integer | Brush centre X in landscape vertex coordinates. Padrão 0. |
centerY | integer | Brush centre Y in landscape vertex coordinates. Padrão 0. |
radius | integer | Brush radius in vertices. Padrão 8. |
strength | integer | Signed height strength in uint16 units. Padrão 128. |
falloff | number | Edge falloff from 0 (hard) through 1 (linear). Padrão 1.0. |
targetHeight | integer | Absolute target height for flatten and terrace tools. Padrão 32768. |
seed | integer | Deterministic noise seed. Padrão 0. |
terraceStep | integer | Terrace 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].
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
minHeight | integer | Lowest allowed uint16 height. Padrão 0. |
maxHeight | integer | Highest 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Edit layer name. |
heightmap | boolean | Clear sculpted heights. Padrão true. |
weightmap | boolean | Clear 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigató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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Target landscape. |
sourceLandscape | string | Source landscape; empty = the target. |
sourceMinX | integer | Source inclusive minimum X. Padrão 0. |
sourceMinY | integer | Source inclusive minimum Y. Padrão 0. |
sourceMaxX | integer | Source inclusive maximum X. Padrão 0. |
sourceMaxY | integer | Source inclusive maximum Y. Padrão 0. |
destX | integer | Target X of the source's first column. Padrão 0. |
destY | integer | Target 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.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | obrigatório. Outliner label. |
componentsX | integer | Component count in X (1..32). Padrão 1. |
componentsY | integer | Component count in Y (1..32). Padrão 1. |
sectionSizeQuads | integer | Quads in each subsection: 7,15,31,63,127,255. Padrão 7. |
sectionsPerComponent | integer | One 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.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | Outliner label of the new landscape; empty keeps the replaced landscape's label. |
replace | string | Existing 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. |
componentsX | integer | Component count in X (1..32). Padrão 1. |
componentsY | integer | Component count in Y (1..32). Padrão 1. |
sectionSizeQuads | integer | Quads per section: 7, 15, 31, 63, 127 or 255. Padrão 7. |
sectionsPerComponent | integer | Sections 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). |
heights | array of integer | obrigatório. Row-major uint16 heights (0..65535, 32768 = actor Z): exactly (componentsXsectionsPerComponentsectionSizeQuads+1) x (same for Y) values. |
material | string | Optional 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
| Argumento | Tipo | Descrição |
|---|---|---|
folder | string | obrigatório. Content folder. |
name | string | obrigatório. Bare layer-info asset name. |
weightBlended | boolean | Weight-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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Source landscape reference. |
name | string | obrigatório. Label of the copy. |
offset | {x,y,z} | World offset of the copy in cm from the source location. |
copyLayers | boolean | Copy paint-layer weights (layers with an assigned layer-info asset). Padrão true. |
dryRun | boolean | Only 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
iterations | integer | Passes 1..50. Padrão 5. |
talus | integer | Height difference (uint16) a neighbour may exceed before material slides. Padrão 64. |
rate | number | Fraction 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
file | string | obrigató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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Assigned paint layer name. |
file | string | obrigatório. Absolute file path (.png or .raw on export; 8-bit .raw on import). |
minX | integer | Import only: region origin X vertex. Padrão 0. |
minY | integer | Import only: region origin Y vertex. Padrão 0. |
width | integer | Import 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigató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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
step | integer | Sampling interval in vertices. Padrão 1. |
maxSlopeDegrees | number | Maximum slope in degrees. Padrão 10. |
minHeight | integer | Lowest accepted uint16 height. Padrão 0. |
maxHeight | integer | Highest accepted uint16 height. Padrão 65535. |
maxResults | integer | Result 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
points | array 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. |
halfWidth | number | Half-width of the fully flattened band in vertices. Padrão 2. |
falloffWidth | number | Width of the blend band outside it in vertices. Padrão 2. |
strength | number | Blend 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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
height | integer | Target uint16 height, 0 through 65535. Padrão 32768. |
strength | number | Blend toward the target, 0..1 (1 = exact). Padrão 1.0. |
mode | string | both, 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
sectionBaseX | integer | Component section base X. Padrão 0. |
sectionBaseY | integer | Component 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape reference. |
sectionBaseX | integer | Component section base X (see landscape.list_components). Padrão 0. |
sectionBaseY | integer | Component section base Y. Padrão 0. |
allComponents | boolean | Apply 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
x | integer | Landscape vertex X coordinate. Padrão 0. |
y | integer | Landscape vertex Y coordinate. Padrão 0. |
Retorna: height, worldZ, message.
landscape.get_height_range (risco 0, requer mundo, smoke)
Sem descrição.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
delta | integer | Height 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
delta | integer | Height 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
x | integer | Landscape vertex X coordinate. Padrão 0. |
y | integer | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Paint layer name. |
minX | integer | Inclusive minimum X. Padrão 0. |
minY | integer | Inclusive minimum Y. Padrão 0. |
maxX | integer | Inclusive maximum X. Padrão 0. |
maxY | integer | Inclusive maximum Y. Padrão 0. |
weight | integer | Constant 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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Paint layer name. |
minX | integer | Inclusive minimum X. Padrão 0. |
minY | integer | Inclusive minimum Y. Padrão 0. |
maxX | integer | Inclusive maximum X. Padrão 0. |
maxY | integer | Inclusive maximum Y. Padrão 0. |
weight | integer | Constant 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.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
mesh | string | obrigatório. Static mesh for the new variety. |
density | number | Initial 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.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigató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
| Argumento | Tipo | Descrição |
|---|---|---|
folder | string | obrigatório. Content folder under /Game. |
name | string | obrigató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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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).
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigató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).
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index. Padrão 0. |
Retorna: grassType, varieties, settings.
landscape.grass_list_types (risco 0, smoke)
Lists grass type assets under a folder.
| Argumento | Tipo | Descrição |
|---|---|---|
folder | string | Content folder to search. Padrão TEXT("/Game"). |
nameContains | string | Optional case-insensitive name filter. |
recursive | boolean | Search sub-folders. Padrão true. |
Retorna: grassTypes, count.
landscape.grass_remove_variety (risco 3, altera, destrutivo, smoke)
Removes one variety from a grass type.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-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.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
enabled | boolean | Requested 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).
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
enabled | boolean | Requested 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).
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
enabled | boolean | Requested 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.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
value | number | Requested 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).
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
enabled | boolean | Requested 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.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
enabled | boolean | Requested 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.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
value | number | Requested 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.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
enabled | boolean | Requested 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.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
value | number | Requested 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.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
enabled | boolean | Requested 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.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
value | number | Requested 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.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
enabled | boolean | Requested state. Padrão true. |
Retorna: grassType, varieties, settings.
landscape.grass_set_receive_decals (risco 2, altera, smoke)
Lets instances of one variety receive decals.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
enabled | boolean | Requested 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.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index. Padrão 0. |
scaling | string | Uniform (X range scales all axes), Free (independent X/Y/Z) or LockXY (X for X and Y, Z separate). Padrão TEXT("Uniform"). |
scaleXMin | number | X (or uniform) scale range minimum. Padrão 1. |
scaleXMax | number | X (or uniform) scale range maximum. Padrão 1. |
scaleYMin | number | Y scale range minimum (Free only). Padrão 1. |
scaleYMax | number | Y scale range maximum (Free only). Padrão 1. |
scaleZMin | number | Z scale range minimum (Free and LockXY). Padrão 1. |
scaleZMax | number | Z 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.
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index (settings that belong to the whole type ignore it). Padrão 0. |
value | number | Requested 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).
| Argumento | Tipo | Descrição |
|---|---|---|
grassType | string | obrigatório. Landscape grass type asset path or unique name. |
index | integer | Zero-based variety index. Padrão 0. |
settings | array of UeaKeyValue | obrigató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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
step | integer | Sampling interval in vertices. Padrão 1. |
buckets | integer | Bucket 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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Assigned paint layer name. |
file | string | obrigatório. Absolute file path (.png or .raw on export; 8-bit .raw on import). |
minX | integer | Import only: region origin X vertex. Padrão 0. |
minY | integer | Import only: region origin Y vertex. Padrão 0. |
width | integer | Import 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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigató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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape actor label, name, or path. Empty selects the only landscape. |
Retorna: brushes, count.
landscape.list_components (risco 0, requer mundo, smoke)
Sem descrição.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
material | string | Material or material instance to inspect; empty uses the landscape's material. |
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
axis | string | x mirrors across the vertical centre line (left/right), y across the horizontal one. Padrão TEXT("x"). |
mode | string | mirror 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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
centerX | integer | Brush centre X vertex. Padrão 0. |
centerY | integer | Brush centre Y vertex. Padrão 0. |
radius | integer | Brush radius in vertices. Padrão 8. |
strength | integer | Peak amplitude in uint16 units. Padrão 128. |
falloff | number | Edge falloff exponent 0 (hard) .. 1 (linear). Padrão 1.0. |
seed | integer | Noise seed (offsets the noise field). Padrão 0. |
octaves | integer | Octaves 1..8. Padrão 4. |
frequency | number | Base 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Assigned paint layer name. |
centerX | integer | Brush centre X vertex. Padrão 0. |
centerY | integer | Brush centre Y vertex. Padrão 0. |
radius | integer | Brush radius in vertices (the whole circle must lie inside the landscape). Padrão 8. |
weight | integer | Centre paint weight, 0 through 255. Padrão 255. |
falloff | number | Fraction 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Assigned paint layer name. |
minX | integer | Inclusive region minimum X. Padrão 0. |
minY | integer | Inclusive region minimum Y. Padrão 0. |
maxX | integer | Inclusive region maximum X. Padrão 0. |
maxY | integer | Inclusive region maximum Y. Padrão 0. |
startWeight | integer | Weight at the start edge (low X, or low Y when axis is y). Padrão 0. |
endWeight | integer | Weight at the end edge. Padrão 255. |
axis | string | Gradient 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Paint layer name. |
minX | integer | Inclusive minimum X. Padrão 0. |
minY | integer | Inclusive minimum Y. Padrão 0. |
maxX | integer | Inclusive maximum X. Padrão 0. |
maxY | integer | Inclusive maximum Y. Padrão 0. |
weight | integer | Constant weight, 0 through 255. Padrão 0. |
Retorna: landscape, message.
landscape.ramp_region (risco 2, altera, requer mundo, smoke)
Sem descrição.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
startX | integer | Start X vertex. Padrão 0. |
startY | integer | Start Y vertex. Padrão 0. |
endX | integer | End X vertex. Padrão 1. |
endY | integer | End Y vertex. Padrão 1. |
startHeight | integer | Start height in uint16 units. Padrão 32768. |
endHeight | integer | End height in uint16 units. Padrão 32768. |
halfWidth | integer | Half-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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigató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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigató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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Current edit layer name. |
newName | string | obrigató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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Edit layer name. |
newIndex | integer | Destination 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Paint layer whose layer info (and painted weights) moves to the new asset. |
layerInfo | string | obrigató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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape reference. |
componentsX | integer | New component count in X; 0 keeps the current count. Padrão 0. |
componentsY | integer | New component count in Y; 0 keeps the current count. Padrão 0. |
sectionSizeQuads | integer | New quads per section (7, 15, 31, 63, 127, 255); 0 keeps. Padrão 0. |
sectionsPerComponent | integer | New sections per component (1 or 2); 0 keeps. Padrão 0. |
dryRun | boolean | Only 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape reference. |
componentsX | integer | New component count in X (1..32). Padrão 1. |
componentsY | integer | New component count in Y (1..32). Padrão 1. |
anchor | string | corner keeps the minimum corner fixed; center grows or shrinks evenly (the actor moves so the terrain stays in place). Padrão TEXT("corner"). |
fillHeight | integer | Height for new vertices (0..65535); -1 extends the nearest edge heights. Padrão -1. |
dryRun | boolean | Only 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
x | integer | Landscape vertex X coordinate. Padrão 0. |
y | integer | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
points | array 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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
factor | number | Multiplier 0..10 (below 1 flattens, above 1 exaggerates). Padrão 1.0. |
pivot | integer | Pivot 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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | Edit 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape reference. |
negativeZ | number | Extra bounds below the terrain in cm; -1 unchanged. Padrão -1. |
positiveZ | number | Extra 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
value | integer | Requested 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.
| Argumento | Tipo | Descrição |
|---|---|---|
collisionProfile | string | Collision profile name (e.g. BlockAll); empty unchanged. |
landscape | string | obrigatório. Landscape reference. |
generateOverlapEvents | string | true, false or empty (unchanged). |
bakeMaterialPositionOffsetIntoCollision | string | true, 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).
| Argumento | Tipo | Descrição |
|---|---|---|
negativeZBoundsExtension | number | Extra bounds below the terrain in cm (for world-position-offset materials). Padrão 0. |
positiveZBoundsExtension | number | Extra 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).
| Argumento | Tipo | Descrição |
|---|---|---|
collisionMipLevel | integer | Complex collision mip level (0..5). Padrão 0. |
simpleCollisionMipLevel | integer | Simple 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.
| Argumento | Tipo | Descrição |
|---|---|---|
staticLightingResolution | number | Static lighting resolution override; 0 = use the landscape value (engine default). Padrão 0. |
lightingLodBias | integer | Lightmass 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.
| Argumento | Tipo | Descrição |
|---|---|---|
forcedLod | integer | Forced render LOD; -1 = automatic (engine default). Padrão -1. |
lodBias | integer | Render 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.
| Argumento | Tipo | Descrição |
|---|---|---|
material | string | Material override asset path; empty clears the override. |
holeMaterial | string | Hole 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Edit layer name. |
alpha | number | Blend alpha: heightmap -1..1 (negative subtracts), weightmap 0..1. Padrão 1. |
target | string | heightmap 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Edit layer name. |
enabled | boolean | Requested 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Edit layer name. |
enabled | boolean | Requested state. Padrão true. |
Retorna: editLayers, count, editLayer.
landscape.set_height_region (risco 2, altera, requer mundo, smoke)
Sem descrição.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
height | integer | Target 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape reference. |
asset | string | Asset 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape reference. |
staticLightingResolution | number | Static lighting resolution; -1 unchanged. Padrão -1. |
castShadow | string | true, false or empty (unchanged). |
castDynamicShadow | string | true, false or empty. |
castStaticShadow | string | true, false or empty. |
castFarShadow | string | true, false or empty. |
affectDistanceFieldLighting | string | true, 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape reference. |
lod0ScreenSize | number | Screen size of LOD0; -1 unchanged. Padrão -1. |
lod0DistributionSetting | number | LOD0 distribution multiplier; -1 unchanged. Padrão -1. |
lodDistributionSetting | number | Distribution 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
material | string | obrigató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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape reference. |
usedForNavigation | string | true, false or empty (unchanged). |
fillCollisionUnderLandscapeForNavmesh | string | true, 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape reference. |
asset | string | Asset 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape reference. |
renderCustomDepth | string | true, false or empty (unchanged). |
customDepthStencilValue | integer | Custom depth stencil value 0..255; -1 unchanged. Padrão -1. |
maxDrawDistance | number | Max draw distance in cm (0 = infinite); -1 unchanged. Padrão -1. |
streamingDistanceMultiplier | number | Texture 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
settings | array of UeaKeyValue | Property assignments: StaticLightingLOD, CollisionMipLevel, SimpleCollisionMipLevel, VirtualTextureRenderPassType. |
Retorna: landscape, settings.
landscape.set_simple_collision_mip (risco 2, altera, requer mundo, smoke)
Sem descrição.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
value | integer | Requested nonnegative setting value. Padrão 0. |
Retorna: landscape, message.
landscape.set_static_lighting_lod (risco 2, altera, requer mundo, smoke)
Sem descrição.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
value | integer | Requested nonnegative setting value. Padrão 0. |
Retorna: landscape, message.
landscape.set_transform (risco 2, altera, requer mundo, smoke)
Sem descrição.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigató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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape reference. |
runtimeVirtualTextures | array of string | Runtime virtual texture asset paths the landscape renders into (replaces the list). |
keepTextures | boolean | Keep the current list instead of replacing it with runtimeVirtualTextures. Padrão false. |
numLods | integer | Lowest mips rendered to the virtual texture (0..12); -1 unchanged. Padrão -1. |
lodBias | integer | LOD bias when rendering to the virtual texture (0..8); -1 unchanged. Padrão -1. |
mainPass | string | Main 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
hidden | boolean | true 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
layer | string | obrigatório. Assigned paint layer name. |
minX | integer | Region origin X vertex. Padrão 0. |
minY | integer | Region origin Y vertex. Padrão 0. |
width | integer | Region width in vertices. Padrão 0. |
weights | array of integer | obrigató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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
step | integer | Sampling interval in vertices. Padrão 1. |
maxSlopeDegrees | number | Slope 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
step | integer | Sampling 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | Inclusive minimum X vertex. Padrão 0. |
minY | integer | Inclusive minimum Y vertex. Padrão 0. |
maxX | integer | Inclusive maximum X vertex. Padrão 0. |
maxY | integer | Inclusive maximum Y vertex. Padrão 0. |
iterations | integer | Blur passes, 1..20. Padrão 1. |
strength | number | Blend 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
location | {x,y,z} | Landscape-local control-point location in centimetres. |
rotation | {x,y,z} | Control-point rotation in degrees. |
width | number | Half-width in centimetres (positive). Padrão 500. |
sideFalloff | number | Side 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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
startIndex | integer | Control point at the segment start. Padrão 0. |
endIndex | integer | Control point at the segment end. Padrão 1. |
startTangent | number | Start tangent length in centimetres; 0 uses half the point distance. Padrão 0. |
endTangent | number | End tangent length in centimetres; 0 uses half the point distance. Padrão 0. |
layerName | string | Paint 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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
index | integer | Zero-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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
segment | integer | Zero-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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
points | array of UeaLandSplineImportPoint | obrigatório. Points appended in order (at least two when connect is true). |
connect | boolean | Connect consecutive points with segments. Padrão true. |
closedLoop | boolean | Also connect the last point back to the first. Padrão false. |
layerName | string | Paint 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
index | integer | Zero-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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
segment | integer | Zero-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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
segment | integer | Zero-based segment index. Padrão 0. |
meshes | array of UeaLandSplineMeshEntry | Complete 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
index | integer | Zero-based existing control-point index. Padrão 0. |
layerName | string | Paint layer painted under the point when splines are applied; empty paints nothing. |
raiseTerrain | boolean | Raise the terrain up to the spline when applied. Padrão true. |
lowerTerrain | boolean | Lower the terrain down to the spline when applied. Padrão true. |
endFalloff | number | Falloff at a dead-end point, in centimetres. Padrão 0. |
segmentMeshOffset | number | Vertical offset of segment meshes at this point, in centimetres. Padrão 0. |
mesh | string | Static 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
index | integer | Zero-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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
segment | integer | Zero-based segment index. Padrão 0. |
layerName | string | Paint layer painted under the segment when splines are applied; empty paints nothing. |
raiseTerrain | boolean | Raise the terrain up to the spline when applied. Padrão true. |
lowerTerrain | boolean | Lower 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
segment | integer | Zero-based segment index. Padrão 0. |
startTangent | number | Start tangent length in centimetres (negative flips the direction). Padrão 0. |
endTangent | number | End 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
index | integer | Zero-based existing control-point index. Padrão 0. |
value | number | Nonnegative 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
index | integer | Zero-based existing control-point index. Padrão 0. |
value | number | Nonnegative 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
minX | integer | X vertex of the block's first column. Padrão 0. |
minY | integer | Y vertex of the block's first row. Padrão 0. |
columns | integer | Block width in vertices. Padrão 1. |
rows | integer | Block height in vertices. Padrão 1. |
heights | array of integer | obrigatório. Row-major values (columns*rows). set/max/min: absolute uint16 heights; add: signed deltas. |
mode | string | set, add, max or min. Padrão TEXT("set"). |
strength | number | Blend 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
shape | string | hill (smooth bump), cone, plateau (flat top) or crater (raised rim, sunken bowl). Padrão TEXT("hill"). |
centerX | integer | Centre X vertex. Padrão 0. |
centerY | integer | Centre Y vertex. Padrão 0. |
radius | integer | Radius in vertices. Padrão 8. |
heightDelta | integer | Signed peak height change in uint16 units (negative digs). Padrão 512. |
inner | number | Plateau: 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape actor reference. |
centerX | integer | Brush centre X in landscape vertex coordinates. Padrão 0. |
centerY | integer | Brush centre Y in landscape vertex coordinates. Padrão 0. |
radius | integer | Brush radius in vertices. Padrão 8. |
strength | integer | Signed height strength in uint16 units. Padrão 128. |
falloff | number | Edge falloff from 0 (hard) through 1 (linear). Padrão 1.0. |
targetHeight | integer | Absolute target height for flatten and terrace tools. Padrão 32768. |
seed | integer | Deterministic noise seed. Padrão 0. |
terraceStep | integer | Terrace 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).
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | Landscape 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape reference. |
x | number | Vertex X (fractional allowed). Padrão 0. |
y | number | Vertex Y (fractional allowed). Padrão 0. |
height | number | uint16 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.
| Argumento | Tipo | Descrição |
|---|---|---|
landscape | string | obrigatório. Landscape reference. |
location | {x,y,z} | World location in cm. |
Retorna: vertexX, vertexY, height, world, inside, componentSectionBaseX, componentSectionBaseY.