Kit level
193 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
Everything about the world the agent is building: maps and sublevels, editor layers, World Settings, environment actors (sun, sky light, sky atmosphere, fog, clouds, reflection captures), post-process volumes and settings, splines and spline meshes, gameplay/utility volumes, lighting builds and Lightmass, navigation, and (UE 5) World Partition, data layers and level instances.
Works on UE 4.27 through 5.8 (175 tools on 4.27, 192 on 5.8). Tools marked with a minimum engine
version are hidden on older engines. The kit is split over eight classes
(UUeaKit_Level, UUeaKit_LevelEnvironment, UUeaKit_LevelPostProcess, UUeaKit_LevelSplines,
UUeaKit_LevelVolumes, UUeaKit_LevelLighting, UUeaKit_LevelNav, UUeaKit_LevelPartition)
that all expose the level. namespace.
Generic actor work (spawn, transform, properties, selection, folders, groups) lives in the actor
kit; asset CRUD in asset; PIE and undo in edit.
Start here
level.get_current— name, package, dirty/untitled state, actor and sublevel counts, whether the level is partitioned, unbuilt lighting and world bounds.level.list_environment— which of sun / sky light / sky atmosphere / fog / clouds / reflection captures already exist.level.setup_default_environment— creates the missing ones in one call.level.get_stats— actors by class, lights, meshes, brushes, volumes, estimated triangles.
Tools
Maps and sublevels
| Tool | Purpose |
|---|---|
level.list_maps / level.list_templates | Level assets in a folder; engine template maps. |
level.create | New level asset (optionally from a template), optionally opened and saved. |
level.open / level.save | Open a level; save the open level (saveAs for save-as). |
level.duplicate_map / level.rename_map / level.delete_map | Level asset lifecycle. |
level.get_current / level.get_stats / level.get_package_info | State, content statistics, file path and size. |
level.list_sublevels / level.get_sublevel | Sublevels with class, loaded/visible/locked state, transform and actor count. |
level.add_sublevel / level.create_sublevel / level.remove_sublevel | Add an existing level, create + add a new one, remove one. |
level.set_sublevel_visible / _loaded / _locked / _transform / _streaming_class | Per-sublevel editing state. |
level.set_current_sublevel / level.get_current_sublevel | Which level new actors spawn into. |
level.move_actors_to_sublevel / level.list_actors_in_sublevel | Move actors between levels; list a level's actors. |
level.list_streaming_volumes / level.add_streaming_volume | Level streaming volumes and the sublevels they drive. |
level.find_actors_by_class_in_world | Quick class query over the whole world. |
level.get_level_blueprint / level.open_level_blueprint | The persistent level's Level Blueprint. |
World Settings
level.set_game_mode_override, level.set_kill_z, level.set_world_gravity,
level.set_world_to_meters, level.set_time_dilation_limits, and
level.get_world_settings_full (every editable AWorldSettings property with its value).
Layers
level.list_layers, level.create_layer, level.rename_layer, level.delete_layer,
level.set_layer_visible, level.add_actors_to_layer, level.remove_actors_from_layer,
level.get_layer_actors, level.get_actor_layers.
Environment
| Tool | Purpose |
|---|---|
level.setup_default_environment | Sun + sky light + sky atmosphere + fog (+ clouds) in one call; skips what exists. |
level.add_directional_light / add_point_light / add_spot_light / add_rect_light / add_sky_light | Light actors with intensity, colour, mobility, shadows and extra properties. |
level.add_sky_atmosphere / add_volumetric_cloud / add_exponential_fog / add_atmospheric_fog | Sky and fog actors (add_atmospheric_fog is the legacy deprecated actor). |
level.add_reflection_capture / add_planar_reflection / list_reflection_captures / recapture_reflections | Reflections. |
level.list_lights / level.get_light | Lights with intensity, colour, mobility, shadows; full component property dump. |
level.set_light / set_lights_many | Any subset of a light's settings, one light or many. |
level.set_light_mobility / set_light_channels / set_light_ies / set_light_function | Mobility, lighting channels, IES profile, light function material. |
level.set_sun_rotation / level.set_sun_from_time | Point the sun by pitch/yaw, or by hour of day + latitude. |
level.get_sky_light / set_sky_light / recapture_sky_light | Sky light settings and recapture. |
level.get_sky_atmosphere / set_sky_atmosphere | Rayleigh/Mie scattering, ground albedo, atmosphere height, multi-scattering. |
level.get_volumetric_cloud / set_volumetric_cloud | Layer altitude/height, tracing distances, cloud material. |
level.get_fog / set_fog | Density, falloff, colour, start distance, volumetric fog, second fog layer. |
level.list_environment / level.apply_environment_preset | Overview; day / noon / sunset / night / overcast / foggy moods. |
level.delete_environment_actors | Delete environment actors by kind. |
Post process
Every setter writes FPostProcessSettings and turns on the matching bOverride_* flag. The
target is a post-process volume, a camera actor, a cine camera, or any actor whose components
carry post-process settings.
| Tool | Purpose |
|---|---|
level.add_post_process_volume | Unbound by default, so it affects the whole level. |
level.list_post_process_volumes | Priority, bounds mode, enabled, overridden field count. |
level.get_post_process / level.set_post_process | Every field with value + overridden flag; generic setter by field name. |
level.clear_post_process_overrides / level.reset_post_process | Stop overriding some/all fields; default-construct the settings. |
level.set_post_process_volume | The volume's own settings (unbound, priority, blend radius/weight, enabled, extent). |
level.set_bloom / set_exposure / set_color_grading / set_ambient_occlusion / set_motion_blur / set_depth_of_field / set_vignette / set_film_grain (5.0+) / set_chromatic_aberration / set_lens_flares / set_white_balance | Typed setters for the common looks. |
level.set_global_illumination (5.0+) / level.set_reflection_method | Lumen / SSGI / SSR. |
level.add_post_process_material / remove_post_process_material / list_post_process_materials | Weighted blendables. |
level.copy_post_process | Copy the whole struct (including override flags) between targets. |
Splines
level.add_spline (points, closed, local/world), list_splines, get_spline,
get_spline_points, add_spline_point, remove_spline_point, set_spline_point,
set_spline_points, clear_spline, set_spline_closed, set_spline_point_type,
reverse_spline, get_spline_length, sample_spline (distance or 0..1 alpha),
sample_spline_evenly, spline_from_actors, place_along_spline (actor class or static mesh,
count or spacing, align to tangent), add_spline_mesh_segments, list_spline_meshes,
clear_spline_meshes, export_spline / import_spline (JSON round trip).
Volumes
level.list_volume_kinds lists every kind level.add_volume accepts: trigger_box,
trigger_sphere, trigger_capsule, blocking, kill_z, pain_causing, nav_modifier,
nav_mesh_bounds, audio, physics, cull_distance, lightmass_importance,
precomputed_visibility, camera_blocking, level_streaming, post_process.
Then: add_volume, list_volumes, get_volume, set_volume_extent,
resize_volume_to_actors, set_trigger_collision, set_pain_volume, set_physics_volume,
set_audio_volume, set_cull_distances, set_nav_modifier_area, set_volume_priority,
set_blocking_volume_collision, add_nav_mesh_bounds, get_nav_bounds, delete_volumes.
Lighting
level.build_lighting (quality preview/medium/high/production, wait), build_geometry,
build_all, get_build_status, get_lightmass_settings / set_lightmass_settings,
set_lighting_scenario / list_lighting_scenarios, set_lightmap_resolution /
set_lightmap_resolution_many / get_lightmap_stats, set_lights_mobility_many,
set_directional_shadows, set_light_indirect, invalidate_lighting, list_unbuilt_lights,
build_reflection_captures, set_force_no_precomputed_lighting, repair_build_data_ids.
Navigation
level.build_navigation (wait), get_navigation_status, list_nav_data, get_nav_settings,
set_nav_agent, set_nav_runtime_generation, set_recast_settings, add_nav_link,
list_nav_links, find_path, project_point_to_nav, get_random_reachable_point,
is_point_on_nav, rebuild_dirty_nav.
World Partition (UE 5)
level.is_partitioned (works on 4.27 too and returns false), list_data_layers (5.1+),
create_data_layer (5.1+), set_data_layer_state, add_actors_to_data_layer,
remove_actors_from_data_layer, get_actor_data_layers, set_actor_spatial,
list_runtime_grids (5.4+), list_external_actors, load_region / unload_region (5.3+),
list_level_instances, create_level_instance, break_level_instance, list_hlod_layers.
Recipe: a lit, playable level in three calls
level.setup_default_environment{sun:true, skyLight:true, skyAtmosphere:true, fog:true, sunPitch:-45}level.add_post_process_volume{name:"PP_Global", unbound:true}level.set_exposure{target:"PP_Global", method:"manual", bias:1}— without this the auto exposure of a new level makes everything look flat.
Then level.save {saveAs:"/Game/Maps/MyLevel"} (a brand new level is untitled until saved).
Recipe: sunset mood
level.apply_environment_preset{preset:"sunset", keepExisting:true}level.set_fog{density:"0.08", volumetric:"true"}level.set_sun_from_time{hour:18.5, latitude:40}for a precise time of day.level.set_color_grading{target:"PP_Global", temperature:"7500", saturation:"(X=1.1,Y=1.05,Z=1,W=1)"}
Recipe: a post-process look
level.set_bloom{target:"PP_Global", intensity:"0.8", threshold:"-1"}level.set_ambient_occlusion{target:"PP_Global", intensity:"0.6", radius:"80"}level.set_vignette{target:"PP_Global", intensity:"0.4"}level.get_post_process{target:"PP_Global", onlyOverridden:true}to review what you changed.level.copy_post_process{from:"PP_Global", to:"PP_Interior"}to reuse it.
Recipe: a spline road with meshes
level.add_spline{name:"Road", points:[{x:0,y:0,z:0},{x:2000,y:0,z:0},{x:4000,y:1500,z:0}]}level.set_spline_point_type{actor:"Road", type:"curve", index:-1}level.add_spline_mesh_segments{actor:"Road", staticMesh:"/Game/Meshes/SM_RoadSegment", forwardAxis:"x"}level.place_along_spline{actor:"Road", staticMesh:"/Game/Meshes/SM_Lamp", spacing:800, alignToTangent:true, offset:{x:0,y:250,z:0}}level.sample_spline_evenly{actor:"Road", count:20}if you need the waypoints for something else.
Recipe: trigger, nav bounds and a build
level.add_volume{kind:"trigger_box", name:"TB_Door", location:{x:0,y:0,z:100}, extent:{x:200,y:200,z:150}}level.set_trigger_collision{actor:"TB_Door", profile:"Trigger", generateOverlapEvents:"true"}level.add_nav_mesh_bounds{extent:{x:5000,y:5000,z:1000}}level.build_navigation{wait:true}thenlevel.get_navigation_status.level.find_path{start:{x:0,y:0,z:0}, end:{x:3000,y:0,z:0}}to verify the navmesh connects.
Recipe: sublevel workflow
level.savefirst — a persistent level must exist on disk before it can own sublevels.level.create_sublevel{folder:"/Game/Maps", name:"L_Props", streamingClass:"blueprint"}level.set_current_sublevel{sublevel:"L_Props"}so new actors land there.level.move_actors_to_sublevel{actors:["SM_Crate1","SM_Crate2"], sublevel:"L_Props"}level.add_streaming_volume{sublevels:["L_Props"], extent:{x:3000,y:3000,z:1000}}level.set_sublevel_visible/level.set_sublevel_loadedwhile editing;level.list_sublevelsto check the state.
Recipe: data layers (UE 5.1+, partitioned levels)
level.is_partitioned— everything else in this section returnsE_NOT_SUPPORTEDwhen false.level.create_data_layer{name:"DL_Vegetation", folder:"/Game/DataLayers", runtime:true}level.add_actors_to_data_layer{actors:["SM_Tree1","SM_Tree2"], dataLayer:"DL_Vegetation"}level.set_data_layer_state{dataLayer:"DL_Vegetation", state:"activated", visible:"true"}level.set_actor_spatial{actor:"BP_QuestGiver", spatiallyLoaded:false}for actors that must always be loaded.
Gotchas
- Untitled levels. A newly created level lives in
/Temp/until saved.level.add_sublevel,level.create_sublevelandlevel.save(withoutsaveAs) all need a real package on disk — save the persistent level first. - Use the
level.*map tools for maps, not theassetkit.level.duplicate_map,level.rename_mapandlevel.delete_mapgo through world-aware engine APIs. The generic asset tools are built onUEditorAssetLibrary, which refuses anything "of type Map/Level" outright on 4.27. When one of these does fail, the reply now carries the engine's own error text. - Volumes are brushes. Most volume kinds are BSP brush actors: changing
extentrebuilds the brush (level.set_volume_extent), it is not a scale.trigger_sphereandtrigger_capsuleare shape components instead and useradius.level.list_volume_kindstells you which is which. - Unbound post-process volumes.
level.add_post_process_volumedefaults tounbound:true, which ignores the volume's bounds and affects the whole level — that is almost always what you want for a global look. Setunbound:falsefor a local zone. - Override flags. Reading a post-process field always returns a value; only
overridden:truemeans the target actually applies it.level.get_post_processwithonlyOverridden:trueshows what you changed. - Optional setter fields are text.
level.set_light,level.set_fog,level.set_bloomand friends take strings so an empty value means "leave unchanged" ("0"and"false"are real values). Colours are separate: passcolorplususeColor:true. - Unknown fields are reported, not fatal. Fields that do not exist on the running engine
(
filmGrain*on 4.27,depthOfField.methodon 5.x,bloomConvolutionScatterDispersionon 4.27) come back infailedwith a reason instead of failing the whole call. - Invalid build-data GUIDs crash the engine, not just the tool.
UMapBuildDataRegistrydoescheck(Guid.IsValid()), so a sky atmosphere, reflection capture or light component carrying a zero GUID asserts the editor the moment a build touches it — and a component spawned by script can end up that way. Every build tool in this kit (build_lighting,build_geometry,build_all,build_reflection_captures,recapture_reflections) repairs them first and reports what it fixed inrepaired[].level.repair_build_data_idsruns the same pass on its own if you want to check or fix a level before handing it to another tool. - Lighting builds are slow.
level.build_lightingreturns immediately unless you passwait:true; polllevel.get_build_statusotherwise. It is not undoable. - Unbuilt lighting. Adding or moving a static/stationary light marks the level's lighting out
of date (
level.get_currentreportslightingUnbuilt). Use movable lights, orlevel.set_force_no_precomputed_lighting {enabled:true}, to skip baking entirely. - Navigation needs bounds. There is no navmesh until a
nav_mesh_boundsvolume exists;level.find_pathandlevel.project_point_to_navreturn "not found" until then.maxSlopeis a Recast generation setting, not an agent property — set it withlevel.set_recast_settings {properties:[{key:"AgentMaxSlope", value:"44"}]}. - Partition tools are 5.x only and return a clean
E_NOT_SUPPORTEDon a non-partitioned world rather than failing hard.level.is_partitionedworks on every version. level.load_regionholds the region for the session. The loader adapter must stay alive or the cells unload again immediately, so the kit keeps it untillevel.unload_regionreleases it.level.unload_regiontherefore only releases regions this session loaded; it reports that clearly when a box matches nothing.- Transactions. Every
Mutatestool is wrapped in an editor transaction, soedit.undoworks. Builds,level.save,level.delete_mapandlevel.set_nav_agent(which writesDefaultEngine.ini) are not undoable. - Actor references accept an actor label, an object name or a unique class name (
"Sun","DirectionalLight_1","PointLight"), matched in that order, then by unique prefix. - New and edited level actors are dirty in memory until
level.save/asset.save_all.
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.
level.add_actors_to_data_layer (risco 2, altera, UE 5.1+, requer mundo)
Assigns actors to a data layer. Not smoke-tested: needs a partitioned world.
| Argumento | Tipo | Descrição |
|---|---|---|
actors | array of string | obrigatório. |
dataLayer | string | obrigatório. Data layer short name or asset path. |
Retorna: changed, changedCount, failed, failedCount, message.
level.add_actors_to_layer (risco 2, altera, requer mundo)
Adds actors to an editor layer (the layer is created when missing). Not smoke-tested: needs level actors that the self-test does not own.
| Argumento | Tipo | Descrição |
|---|---|---|
actors | array of string | obrigatório. |
layer | string | obrigatório. |
Retorna: changed, changedCount, failed, failedCount, message.
level.add_atmospheric_fog (risco 1, altera, requer mundo, smoke)
Adds the legacy AtmosphericFog actor (deprecated by Epic; prefer level.add_sky_atmosphere).
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | |
location | {x,y,z} | |
properties | array of UeaKeyValue |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_directional_light (risco 2, altera, requer mundo, smoke)
Adds a directional light (the sun).
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | Padrão TEXT("DirectionalLight"). |
rotation | {x,y,z} | Pitch/yaw/roll in degrees; a negative pitch points down. Padrão FUeaVec3(-45.0, 45.0, 0.0). |
intensity | number | Light intensity in lux (engine default is 10). Padrão 10.0. |
color | UeaColor | |
castShadows | boolean | Padrão true. |
atmosphereSunLight | boolean | Drive the SkyAtmosphere sun disk with this light. Padrão true. |
mobility | string | "static", "stationary" or "movable" (default). Padrão TEXT("movable"). |
properties | array of UeaKeyValue | Extra property assignments applied to the light component. |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_exponential_fog (risco 2, altera, requer mundo, smoke)
Adds an exponential height fog actor.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | Padrão TEXT("ExponentialHeightFog"). |
location | {x,y,z} | |
density | number | Padrão 0.02. |
heightFalloff | number | Padrão 0.2. |
fogColor | UeaColor | |
startDistance | number | Distance in cm at which the fog starts. Padrão 0.0. |
volumetric | boolean | Turn on volumetric fog. Padrão false. |
extinctionScale | number | Volumetric fog extinction scale. Padrão 1.0. |
properties | array of UeaKeyValue |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_nav_link (risco 2, altera, requer mundo, smoke)
Adds a nav link proxy connecting two world points (jumps, ledges, doors).
| Argumento | Tipo | Descrição |
|---|---|---|
start | {x,y,z} | obrigatório. World location of the link's left point. |
end | {x,y,z} | obrigatório. World location of the link's right point. |
bidirectional | boolean | Traversable in both directions (default) or only from start to end. Padrão true. |
name | string | Padrão TEXT("NavLinkProxy"). |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_nav_mesh_bounds (risco 2, altera, requer mundo, smoke)
Adds a nav mesh bounds volume (navigation is only generated inside these).
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | Padrão TEXT("NavMeshBoundsVolume"). |
location | {x,y,z} | |
extent | {x,y,z} | Half-size in cm. Padrão FUeaVec3(2000.0, 2000.0, 500.0). |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_planar_reflection (risco 2, altera, requer mundo, smoke)
Adds a planar reflection actor (mirrors, water).
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | Padrão TEXT("PlanarReflection"). |
location | {x,y,z} | |
rotation | {x,y,z} | |
properties | array of UeaKeyValue |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_point_light (risco 2, altera, requer mundo, smoke)
Adds a point light.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | Padrão TEXT("PointLight"). |
location | {x,y,z} | |
intensity | number | Intensity in candelas/lumens depending on the unit (engine default is 5000). Padrão 5000.0. |
color | UeaColor | |
attenuationRadius | number | Attenuation radius in cm. Padrão 1000.0. |
sourceRadius | number | Source radius in cm (soft shadows). Padrão 0.0. |
castShadows | boolean | Padrão true. |
mobility | string | "static", "stationary" or "movable" (default). Padrão TEXT("movable"). |
properties | array of UeaKeyValue |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_post_process_material (risco 2, altera, requer mundo)
Adds a post-process material to the target's weighted blendables. Not smoke-tested: needs a project-authored post-process material.
| Argumento | Tipo | Descrição |
|---|---|---|
material | string | obrigatório. Post-process material or material instance. |
weight | number | 0..1 blend weight. Padrão 1.0. |
Retorna: target, materials, count, message.
level.add_post_process_volume (risco 2, altera, requer mundo, smoke)
Adds a post-process volume (unbound by default, so it affects the whole level).
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | Padrão TEXT("PostProcessVolume"). |
unbound | boolean | Affect the whole level regardless of where the camera is (default true). Padrão true. |
location | {x,y,z} | |
extent | {x,y,z} | Half-size in cm when the volume is bounded. Padrão FUeaVec3(1000.0, 1000.0, 1000.0). |
priority | number | Higher priority wins where volumes overlap. Padrão 0.0. |
blendRadius | number | Blend distance in cm outside the volume. Padrão 100.0. |
blendWeight | number | 0..1 weight of this volume's settings. Padrão 1.0. |
enabled | boolean | Padrão true. |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_rect_light (risco 2, altera, requer mundo, smoke)
Adds a rect (area) light.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | Padrão TEXT("RectLight"). |
location | {x,y,z} | |
rotation | {x,y,z} | |
intensity | number | Padrão 5000.0. |
color | UeaColor | |
attenuationRadius | number | Padrão 1000.0. |
sourceWidth | number | Emitter width in cm. Padrão 64.0. |
sourceHeight | number | Emitter height in cm. Padrão 64.0. |
barnDoorAngle | number | Barn door angle in degrees (0 = no barn doors). Padrão 0.0. |
castShadows | boolean | Padrão true. |
mobility | string | Padrão TEXT("movable"). |
properties | array of UeaKeyValue |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_reflection_capture (risco 2, altera, requer mundo, smoke)
Adds a sphere or box reflection capture.
| Argumento | Tipo | Descrição |
|---|---|---|
shape | string | "sphere" (default) or "box". Padrão TEXT("sphere"). |
name | string | |
location | {x,y,z} | |
radius | number | Influence radius in cm (sphere captures). Padrão 3000.0. |
extent | {x,y,z} | Half-size in cm (box captures). Padrão FUeaVec3(1000.0, 1000.0, 1000.0). |
brightness | number | Padrão 1.0. |
properties | array of UeaKeyValue |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_sky_atmosphere (risco 2, altera, requer mundo, smoke)
Adds a SkyAtmosphere actor (physically based sky).
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | |
location | {x,y,z} | |
properties | array of UeaKeyValue |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_sky_light (risco 2, altera, requer mundo, smoke)
Adds a sky light.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | Padrão TEXT("SkyLight"). |
realTimeCapture | boolean | Capture the sky every frame (5.x real-time capture; ignored on 4.27 where it is off by default). Padrão true. |
cubemap | string | Cubemap texture to use instead of capturing the scene. |
intensity | number | Padrão 1.0. |
lowerHemisphereColor | UeaColor | |
mobility | string | Padrão TEXT("movable"). |
properties | array of UeaKeyValue |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_spline (risco 2, altera, requer mundo, smoke)
Creates an actor whose root is a spline component, optionally with the given points.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | Padrão TEXT("Spline"). |
location | {x,y,z} | Actor location. |
points | array of {x,y,z} | Initial points; empty gives the engine's default two-point spline. |
closed | boolean | Padrão false. |
space | string | "local" (default) or "world" - how points are interpreted. Padrão TEXT("local"). |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_spline_mesh_segments (risco 2, altera, requer mundo)
Builds a spline-mesh component per segment of a spline (roads, cables, pipes). Not smoke-tested: needs a static mesh asset, which an empty project may not have.
| Argumento | Tipo | Descrição |
|---|---|---|
staticMesh | string | obrigatório. Static mesh deformed along each segment. |
segments | integer | How many segments to build; 0 (default) = one per point pair. Padrão 0. |
forwardAxis | string | "x" (default), "y" or "z". Padrão TEXT("x"). |
material | string | Optional material override. |
Retorna: actor, meshes, count, message.
level.add_spline_point (risco 2, altera, requer mundo, smoke)
Adds a point to a spline (index -1 appends).
| Argumento | Tipo | Descrição |
|---|---|---|
position | {x,y,z} | obrigatório. |
space | string | "local" (default) or "world". Padrão TEXT("local"). |
index | integer | Insert index; -1 appends. Padrão -1. |
Retorna: actor, component, points, pointCount, length, closed, message.
level.add_spot_light (risco 2, altera, requer mundo, smoke)
Adds a spot light.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | Padrão TEXT("SpotLight"). |
location | {x,y,z} | |
rotation | {x,y,z} | Pitch/yaw/roll in degrees. Padrão FUeaVec3(-90.0, 0.0, 0.0). |
intensity | number | Padrão 5000.0. |
color | UeaColor | |
attenuationRadius | number | Padrão 1000.0. |
sourceRadius | number | Padrão 0.0. |
innerCone | number | Inner cone half-angle in degrees. Padrão 0.0. |
outerCone | number | Outer cone half-angle in degrees. Padrão 44.0. |
castShadows | boolean | Padrão true. |
mobility | string | Padrão TEXT("movable"). |
properties | array of UeaKeyValue |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_streaming_volume (risco 2, altera, requer mundo)
Adds a level streaming volume that loads/shows the given sublevels. Not smoke-tested: needs existing sublevels, which the transient self-test world has none of.
| Argumento | Tipo | Descrição |
|---|---|---|
sublevels | array of string | obrigatório. Sublevels the volume controls. |
name | string | |
location | {x,y,z} | |
extent | {x,y,z} | Half-size in cm (default 1000 on each axis). Padrão FUeaVec3(1000.0, 1000.0, 1000.0). |
usage | string | "loading_and_visibility" (default), "loading", "visibility_blocking_on_load", "blocking_on_load". Padrão TEXT("loading_and_visibility"). |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_sublevel (risco 2, altera, requer mundo)
Adds an existing level asset to the current world as a streaming sublevel. Not smoke-tested: the self-test world is an unsaved transient level, which cannot own sublevels.
| Argumento | Tipo | Descrição |
|---|---|---|
map | string | obrigatório. Level asset to add as a sublevel. |
streamingClass | string | "always_loaded" (default) or "blueprint". Padrão TEXT("always_loaded"). |
location | {x,y,z} | |
rotation | {x,y,z} |
Retorna: sublevel, message.
level.add_volume (risco 2, altera, requer mundo, smoke)
Adds a volume of the given kind, sized by extent (or radius for sphere/capsule triggers).
| Argumento | Tipo | Descrição |
|---|---|---|
kind | string | obrigatório. One of level.list_volume_kinds, e.g. "trigger_box", "audio", "nav_mesh_bounds". |
name | string | |
location | {x,y,z} | |
extent | {x,y,z} | Half-size in cm (default 100 on each axis). Padrão FUeaVec3(100.0, 100.0, 100.0). |
radius | number | Radius in cm for trigger_sphere / trigger_capsule. Padrão 100.0. |
rotation | {x,y,z} | |
properties | array of UeaKeyValue |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.add_volumetric_cloud (risco 2, altera, requer mundo, smoke)
Adds a VolumetricCloud actor.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | |
location | {x,y,z} | |
properties | array of UeaKeyValue |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.apply_environment_preset (risco 2, altera, requer mundo, smoke)
Applies a lighting mood preset (day, noon, sunset, night, overcast, foggy).
| Argumento | Tipo | Descrição |
|---|---|---|
preset | string | obrigatório. day, noon, sunset, night, overcast or foggy. |
keepExisting | boolean | Do not create missing actors, only tune the ones that exist. Padrão true. |
Retorna: created, existing, createdCount, message.
level.break_level_instance (risco 3, altera, destrutivo, UE 5.1+, requer mundo)
Breaks a level instance apart, moving its actors back into the current level. Not smoke-tested: needs an existing level instance actor.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Level instance actor to break apart. |
levels | integer | How many nesting levels to break (1 by default). Padrão 1. |
Retorna: instances, count, message.
level.build_all (risco 4, requer mundo)
Runs the full "Build All" (geometry, lighting, navigation, HLOD). Not smoke-tested: long running and not undoable.
| Argumento | Tipo | Descrição |
|---|---|---|
quality | string | "preview" (default), "medium", "high" or "production". Padrão TEXT("preview"). |
wait | boolean | Block until the build finishes (the tool runs off the game thread and polls). Padrão false. |
maxFrames | integer | Maximum editor frames to wait for when wait is on. Padrão 20000. |
Retorna: type, started, running, finished, framesWaited, unbuiltObjects, repaired, repairedCount, message.
level.build_geometry (risco 4, requer mundo)
Rebuilds BSP geometry of the current level. Not smoke-tested: a geometry rebuild is not undoable and would disturb the volumes created by the run.
Sem argumentos.
Retorna: type, started, running, finished, framesWaited, unbuiltObjects, repaired, repairedCount, message.
level.build_lighting (risco 4, requer mundo)
Starts a lighting build; with wait=true the tool runs off the game thread and polls until it finishes. Not smoke-tested: a lighting build takes minutes and blocks the editor.
| Argumento | Tipo | Descrição |
|---|---|---|
quality | string | "preview" (default), "medium", "high" or "production". Padrão TEXT("preview"). |
wait | boolean | Block until the build finishes (the tool runs off the game thread and polls). Padrão false. |
maxFrames | integer | Maximum editor frames to wait for when wait is on. Padrão 20000. |
Retorna: type, started, running, finished, framesWaited, unbuiltObjects, repaired, repairedCount, message.
level.build_navigation (risco 4, requer mundo)
Rebuilds the navigation data; with wait=true the tool runs off the game thread and polls. Not smoke-tested: a navigation build takes a long time and is not undoable.
| Argumento | Tipo | Descrição |
|---|---|---|
wait | boolean | Block until the navigation build finishes (the tool runs off the game thread and polls). Padrão false. |
maxFrames | integer | Maximum editor frames to wait for when wait is on. Padrão 10000. |
Retorna: started, building, finished, framesWaited, remainingTasks, message.
level.build_reflection_captures (risco 1, requer mundo, smoke)
Rebuilds every reflection capture in the level (fast compared with a lighting build).
Sem argumentos.
Retorna: type, started, running, finished, framesWaited, unbuiltObjects, repaired, repairedCount, message.
level.clear_post_process_overrides (risco 2, altera, requer mundo, smoke)
Stops overriding the named fields (empty = every field).
| Argumento | Tipo | Descrição |
|---|---|---|
keys | array of string | Field names to stop overriding; empty clears every override. |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.clear_spline (risco 3, altera, destrutivo, requer mundo, smoke)
Removes every point of a spline.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Actor carrying the spline component. |
component | string | Component name when the actor has more than one spline. |
Retorna: actor, component, points, pointCount, length, closed, message.
level.clear_spline_meshes (risco 3, altera, destrutivo, requer mundo, smoke)
Removes every spline-mesh component from a spline actor.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Actor carrying the spline component. |
component | string | Component name when the actor has more than one spline. |
Retorna: actor, meshes, count, message.
level.copy_post_process (risco 2, altera, requer mundo, smoke)
Copies the whole FPostProcessSettings struct (including override flags) from one target to another.
| Argumento | Tipo | Descrição |
|---|---|---|
from | string | obrigatório. Source target. |
to | string | obrigatório. Destination target. |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.create (risco 2, altera, smoke)
Creates a level asset (optionally from a template), optionally opening and saving it.
| Argumento | Tipo | Descrição |
|---|---|---|
folder | string | obrigatório. Destination content folder, e.g. "/Game/Maps". |
name | string | obrigatório. Asset name of the new level. |
template | string | Optional template level to copy (package path or unique name); empty = empty level. |
open | boolean | Open the new level in the editor after creating it. Padrão false. |
save | boolean | Save the new level package to disk. Padrão false. |
Retorna: name, package, path, opened, saved, message.
level.create_data_layer (risco 2, altera, UE 5.1+, requer mundo)
Creates a data layer asset and registers an instance of it in the world. Not smoke-tested: needs a partitioned world, which the self-test project does not have.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | obrigatório. Data layer asset name. |
folder | string | Content folder for the data layer asset, e.g. "/Game/DataLayers". Padrão TEXT("/Game/DataLayers"). |
runtime | boolean | Runtime data layers can be loaded/unloaded at runtime; editor-only ones cannot. Padrão false. |
Retorna: dataLayers, count, message.
level.create_layer (risco 2, altera, requer mundo, smoke)
Creates an empty editor layer.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | obrigatório. |
Retorna: layers, count.
level.create_level_instance (risco 2, altera, UE 5.1+, requer mundo)
Moves actors into a new level asset and replaces them with a level instance actor. Not smoke-tested: writes a level asset to disk and may open a modal dialog.
| Argumento | Tipo | Descrição |
|---|---|---|
actors | array of string | obrigatório. Actors to move into the new level instance. |
folder | string | obrigatório. Destination folder for the new level asset. |
name | string | obrigatório. Asset name of the new level. |
packed | boolean | Create a packed level actor instead of a plain level instance. Padrão false. |
Retorna: instances, count, message.
level.create_sublevel (risco 2, altera, requer mundo)
Creates a new empty level asset and adds it to the current world as a sublevel. Not smoke-tested: the self-test world is an unsaved transient level, which cannot own sublevels.
| Argumento | Tipo | Descrição |
|---|---|---|
folder | string | obrigatório. Destination folder for the new level asset. |
name | string | obrigatório. Asset name of the new level. |
streamingClass | string | "always_loaded" (default) or "blueprint". Padrão TEXT("always_loaded"). |
Retorna: sublevel, message.
level.delete_environment_actors (risco 3, altera, destrutivo, requer mundo, smoke)
Deletes environment actors of the given kinds (empty = all of them).
| Argumento | Tipo | Descrição |
|---|---|---|
kinds | array of string | Kinds to delete: sun, sky_light, sky_atmosphere, fog, clouds, reflection_capture, planar_reflection. Empty = every environment actor. |
Retorna: changed, changedCount, failed, failedCount, message.
level.delete_layer (risco 3, altera, destrutivo, requer mundo, smoke)
Deletes an editor layer (its actors stay in the level).
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | obrigatório. |
Retorna: layers, count.
level.delete_map (risco 3, altera, destrutivo, smoke)
Deletes a level asset. The level must not be the one currently open.
| Argumento | Tipo | Descrição |
|---|---|---|
map | string | obrigatório. Level asset (package path or unique name). |
Retorna: message, count.
level.delete_volumes (risco 3, altera, destrutivo, requer mundo, smoke)
Deletes volumes by kind or by actor list.
| Argumento | Tipo | Descrição |
|---|---|---|
kind | string | Delete every volume of this kind; ignored when actors is given. |
actors | array of string | Specific volume actors to delete. |
Retorna: changed, changedCount, failed, failedCount, message.
level.duplicate_map (risco 2, altera, smoke)
Duplicates a level asset into another folder/name.
| Argumento | Tipo | Descrição |
|---|---|---|
map | string | obrigatório. Source level asset. |
folder | string | obrigatório. Destination folder. |
name | string | obrigatório. Destination asset name. |
Retorna: name, package, path, opened, saved, message.
level.export_spline (risco 0, requer mundo, smoke)
Exports a spline as JSON (points, tangents, types, closed flag).
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Actor carrying the spline component. |
component | string | Component name when the actor has more than one spline. |
Retorna: actor, json, pointCount.
level.find_actors_by_class_in_world (risco 0, requer mundo, smoke)
Actors of a class (or subclass) in the current world.
| Argumento | Tipo | Descrição |
|---|---|---|
class | string | obrigatório. Class name, class path or Blueprint asset. |
includeSublevels | boolean | Include actors living in loaded sublevels (default true). Padrão true. |
limit | integer | Padrão 200. |
Retorna: actors, count, total.
level.find_path (risco 0, requer mundo, smoke)
Finds a navmesh path between two world points and returns its waypoints.
| Argumento | Tipo | Descrição |
|---|---|---|
start | {x,y,z} | obrigatório. |
end | {x,y,z} | obrigatório. |
Retorna: valid, partial, points, count, length, message.
level.get_actor_data_layers (risco 0, UE 5.1+, requer mundo)
Data layers an actor belongs to. Not smoke-tested: needs a partitioned world and a level actor.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Actor label, object name or unique class name. |
Retorna: dataLayers, count, message.
level.get_actor_layers (risco 0, requer mundo)
Editor layers an actor belongs to. Not smoke-tested: needs a level actor that the self-test does not own.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Actor label, object name or unique class name. |
Retorna: layers, count.
level.get_build_status (risco 0, requer mundo, smoke)
Whether a lighting, geometry or navigation build is running, and how much is unbuilt.
Sem argumentos.
Retorna: lightingBuilding, anyBuildRunning, navigationBuilding, unbuiltLightingObjects, unbuiltReflectionCaptures, remainingNavBuildTasks, configuredLightingQuality, message.
level.get_current (risco 0, requer mundo, smoke)
The level currently open: name, package, dirty/untitled state, actor and sublevel counts, partitioning, unbuilt lighting and bounds.
Sem argumentos.
Retorna: name, package, path, dirty, untitled, actorCount, sublevelCount, partitioned, unbuiltLightingObjects, lightingUnbuilt, boundsMin, boundsMax, gameModeOverride.
level.get_current_sublevel (risco 0, requer mundo, smoke)
The level new actors are currently spawned into.
Sem argumentos.
Retorna: sublevel, message.
level.get_fog (risco 0, requer mundo, smoke)
Settings of the exponential height fog actor.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | Actor label/name; empty = the first actor of the matching kind in the level. |
Retorna: entries, count, message.
level.get_layer_actors (risco 0, requer mundo, smoke)
Actors assigned to an editor layer.
| Argumento | Tipo | Descrição |
|---|---|---|
layer | string | obrigatório. |
Retorna: actors, count, total.
level.get_level_blueprint (risco 0, requer mundo, smoke)
Path and graph names of the persistent level's Level Blueprint.
Sem argumentos.
Retorna: path, name, graphs, nodeCount, message.
level.get_light (risco 0, requer mundo, smoke)
Full summary of one light, including every editable property of its light component.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Actor label, object name or unique class name. |
Retorna: light, properties, applied, failed, message.
level.get_lightmap_stats (risco 0, requer mundo, smoke)
Lightmap resolution and lightmap UV channel of every static mesh component in the level.
Sem argumentos.
Retorna: entries, count, lightmapTotalSizeKB, shadowmapTotalSizeKB, message.
level.get_lightmass_settings (risco 0, requer mundo, smoke)
Lightmass settings of the current level.
Sem argumentos.
Retorna: entries, count, message.
level.get_nav_bounds (risco 0, requer mundo, smoke)
Nav mesh bounds volumes in the level and their combined world bounds.
Sem argumentos.
Retorna: volumes, count, min, max, hasBounds.
level.get_nav_settings (risco 0, smoke)
Project navigation settings: supported agents and generation options.
Sem argumentos.
Retorna: agents, count, autoCreateNavigationData, allowClientSideNavigation, buildNavigationAtRuntime, entries, message.
level.get_navigation_status (risco 0, requer mundo, smoke)
Whether navigation is building, how many tasks remain, and which agents and nav data exist.
Sem argumentos.
Retorna: navigationSystemPresent, building, locked, remainingTasks, navDataCount, navBoundsVolumes, agents, message.
level.get_package_info (risco 0, smoke)
File path, size on disk, dirty state and (5.x) external actor count of a level package.
| Argumento | Tipo | Descrição |
|---|---|---|
map | string | Level asset; empty = the level currently open. |
Retorna: package, filePath, sizeBytes, dirty, exists, externalActorCount.
level.get_post_process (risco 0, requer mundo, smoke)
Reads post-process settings from a volume, camera or cine camera.
| Argumento | Tipo | Descrição |
|---|---|---|
onlyOverridden | boolean | Only report the fields whose bOverride_ flag is on. Padrão true. |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.get_random_reachable_point (risco 0, requer mundo, smoke)
A random navigable point within a radius of an origin.
| Argumento | Tipo | Descrição |
|---|---|---|
origin | {x,y,z} | obrigatório. |
radius | number | obrigatório. Search radius in cm. |
Retorna: found, point, distance, message.
level.get_sky_atmosphere (risco 0, requer mundo, smoke)
Settings of the SkyAtmosphere actor.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | Actor label/name; empty = the first actor of the matching kind in the level. |
Retorna: entries, count, message.
level.get_sky_light (risco 0, requer mundo, smoke)
Settings of the sky light.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | Actor label/name; empty = the first actor of the matching kind in the level. |
Retorna: entries, count, message.
level.get_spline (risco 0, requer mundo, smoke)
One spline in detail: every point with tangents, rotation, scale and type, plus length.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Actor carrying the spline component. |
component | string | Component name when the actor has more than one spline. |
Retorna: actor, component, points, pointCount, length, closed, message.
level.get_spline_length (risco 0, requer mundo, smoke)
Total length of a spline in cm.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Actor carrying the spline component. |
component | string | Component name when the actor has more than one spline. |
Retorna: actor, samples, count, length.
level.get_spline_points (risco 0, requer mundo, smoke)
Just the points of a spline.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Actor carrying the spline component. |
component | string | Component name when the actor has more than one spline. |
Retorna: actor, component, points, pointCount, length, closed, message.
level.get_stats (risco 0, requer mundo, smoke)
Content statistics of the level currently open: actors by class, lights, meshes, brushes, volumes and an estimated triangle count.
Sem argumentos.
Retorna: actorCount, lightCount, staticMeshCount, skeletalMeshCount, brushCount, volumeCount, componentCount, estimatedTriangles, byClass, distinctClasses.
level.get_sublevel (risco 0, requer mundo)
One sublevel in detail. Not smoke-tested: the transient self-test world has no sublevels.
| Argumento | Tipo | Descrição |
|---|---|---|
sublevel | string | obrigatório. Sublevel name or package path (substring match on the package is accepted). |
Retorna: sublevel, message.
level.get_volume (risco 0, requer mundo, smoke)
One volume in detail, with every editable property of the actor.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Volume actor label, name or unique class. |
Retorna: volume, properties, applied, failed, message.
level.get_volumetric_cloud (risco 0, requer mundo, smoke)
Settings of the VolumetricCloud actor.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | Actor label/name; empty = the first actor of the matching kind in the level. |
Retorna: entries, count, message.
level.get_world_settings_full (risco 0, requer mundo, smoke)
Every editable property of AWorldSettings with its current value.
Sem argumentos.
Retorna: entries, count, message.
level.import_spline (risco 2, altera, requer mundo)
Replaces a spline's points from JSON produced by level.export_spline. Not smoke-tested: its payload is a JSON document, which cannot be written in a UHT Smoke string (single quotes there are rewritten to double quotes, so nested JSON cannot be expressed).
| Argumento | Tipo | Descrição |
|---|---|---|
json | string | obrigatório. JSON produced by level.export_spline. |
Retorna: actor, component, points, pointCount, length, closed, message.
level.invalidate_lighting (risco 4, destrutivo, requer mundo)
Invalidates the baked lighting of every actor, marking the level as needing a rebuild. Not smoke-tested: throws away the project's baked lighting and is not undoable.
Sem argumentos.
Retorna: type, started, running, finished, framesWaited, unbuiltObjects, repaired, repairedCount, message.
level.is_partitioned (risco 0, requer mundo, smoke)
Whether the current world uses World Partition (always false on UE 4.27).
Sem argumentos.
Retorna: partitioned, streamingEnabled, world, externalActorCount, message.
level.is_point_on_nav (risco 0, requer mundo, smoke)
Whether a world point lies on the navmesh.
| Argumento | Tipo | Descrição |
|---|---|---|
point | {x,y,z} | obrigatório. |
extent | {x,y,z} | Search box half-size in cm around the point. Padrão FUeaVec3(100.0, 100.0, 200.0). |
Retorna: found, point, distance, message.
level.list_actors_in_sublevel (risco 0, requer mundo, smoke)
Actors that live in one level (empty sublevel = the persistent level).
| Argumento | Tipo | Descrição |
|---|---|---|
sublevel | string | Sublevel name or package; empty = the persistent level. |
classFilter | string | Only actors of this class (or a subclass). |
limit | integer | Padrão 200. |
Retorna: actors, count, total.
level.list_data_layers (risco 0, UE 5.1+, requer mundo)
Data layer instances of the current partitioned world. Not smoke-tested: the self-test world is not partitioned, so this returns E_NOT_SUPPORTED.
Sem argumentos.
Retorna: dataLayers, count, message.
level.list_environment (risco 0, requer mundo, smoke)
Which environment actors exist in the level (sun, sky light, atmosphere, fog, clouds, captures) and their key values.
Sem argumentos.
Retorna: environment, count, message.
level.list_external_actors (risco 0, UE 5.0+, requer mundo, smoke)
External actor packages of the current world (one package per actor in a partitioned level).
| Argumento | Tipo | Descrição |
|---|---|---|
limit | integer | Padrão 200. |
Retorna: packages, count, total, message.
level.list_hlod_layers (risco 0, UE 5.0+, smoke)
HLOD layer assets available in the project.
Sem argumentos.
Retorna: layers, count, message.
level.list_layers (risco 0, requer mundo, smoke)
Editor layers of the current world with visibility and actor counts.
Sem argumentos.
Retorna: layers, count.
level.list_level_instances (risco 0, UE 5.1+, requer mundo, smoke)
Level instance actors in the current world.
Sem argumentos.
Retorna: instances, count, message.
level.list_lighting_scenarios (risco 0, requer mundo, smoke)
Levels flagged as lighting scenarios.
Sem argumentos.
Retorna: sublevels, count.
level.list_lights (risco 0, requer mundo, smoke)
Lights in the level with intensity, colour, mobility and shadow state.
| Argumento | Tipo | Descrição |
|---|---|---|
classFilter | string | Light class to keep, e.g. "PointLight"; empty = every light. |
mobility | string | "static", "stationary" or "movable"; empty = any. |
limit | integer | Padrão 200. |
Retorna: lights, count, total.
level.list_maps (risco 0, smoke)
Level (UWorld) assets in a content folder, filtered by name substring.
| Argumento | Tipo | Descrição |
|---|---|---|
folder | string | Content folder to search, e.g. "/Game/Maps". Empty = "/Game". |
recursive | boolean | Padrão true. |
nameContains | string | Case-insensitive substring the map name must contain. |
limit | integer | Padrão 200. |
Retorna: maps, count, total.
level.list_nav_data (risco 0, requer mundo, smoke)
Navigation data actors in the level with their agent parameters.
Sem argumentos.
Retorna: navData, count, message.
level.list_nav_links (risco 0, requer mundo, smoke)
Nav link proxies in the level.
Sem argumentos.
Retorna: links, count, message.
level.list_post_process_materials (risco 0, requer mundo, smoke)
Post-process materials currently blended by the target.
| Argumento | Tipo | Descrição |
|---|---|---|
target | string | obrigatório. Post-process volume, camera actor or any actor with post-process settings. |
Retorna: target, materials, count, message.
level.list_post_process_volumes (risco 0, requer mundo, smoke)
Post-process volumes in the level with priority, bounds mode and how many fields they override.
Sem argumentos.
Retorna: volumes, count.
level.list_reflection_captures (risco 0, requer mundo, smoke)
Reflection capture actors in the level.
Sem argumentos.
Retorna: actors, count, total.
level.list_runtime_grids (risco 0, UE 5.0+, requer mundo)
Runtime grids of the world's partition runtime hash. Not smoke-tested: needs a partitioned world.
Sem argumentos.
Retorna: grids, count, message.
level.list_spline_meshes (risco 0, requer mundo, smoke)
Spline-mesh components on a spline actor.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Actor carrying the spline component. |
component | string | Component name when the actor has more than one spline. |
Retorna: actor, meshes, count, message.
level.list_splines (risco 0, requer mundo, smoke)
Actors in the level that carry a spline component.
Sem argumentos.
Retorna: splines, count.
level.list_streaming_volumes (risco 0, requer mundo, smoke)
Level streaming volumes in the current world with the sublevels they drive.
Sem argumentos.
Retorna: actors, count, total.
level.list_sublevels (risco 0, requer mundo, smoke)
Streaming sublevels of the current world with class, loaded/visible/locked state, transform and actor count.
Sem argumentos.
Retorna: sublevels, count.
level.list_templates (risco 0, smoke)
Engine template levels that level.create can copy (/Engine/Maps/Templates).
Sem argumentos.
Retorna: maps, count, total.
level.list_unbuilt_lights (risco 0, requer mundo, smoke)
Lights that contribute to baked lighting while the level's lighting is out of date.
Sem argumentos.
Retorna: lights, count, unbuiltObjects, message.
level.list_volume_kinds (risco 0, smoke)
Every kind level.add_volume accepts, with its actor class and whether it is a BSP brush or a shape component.
Sem argumentos.
Retorna: kinds, count.
level.list_volumes (risco 0, requer mundo, smoke)
Volumes in the level, optionally of one kind.
| Argumento | Tipo | Descrição |
|---|---|---|
kind | string | Kind to keep; empty = every volume. |
limit | integer | Padrão 200. |
Retorna: volumes, count.
level.load_region (risco 1, UE 5.3+, requer mundo)
Loads the partition cells intersecting a world-space box into the editor. Not smoke-tested: needs a partitioned world.
| Argumento | Tipo | Descrição |
|---|---|---|
min | {x,y,z} | obrigatório. Minimum corner of the world-space box to load/unload. |
max | {x,y,z} | obrigatório. Maximum corner of the world-space box. |
Retorna: applied, min, max, message.
level.move_actors_to_sublevel (risco 2, altera, requer mundo)
Moves actors from their current level into another loaded level. Not smoke-tested: the self-test world has no sublevels to move actors into.
| Argumento | Tipo | Descrição |
|---|---|---|
actors | array of string | obrigatório. |
sublevel | string | obrigatório. Destination sublevel; empty is not accepted (use the persistent level name). |
Retorna: changed, changedCount, failed, failedCount, message.
level.open (risco 2)
Opens a level in the editor. Not smoke-tested: swapping the open level is not undoable and would disturb every other tool in the run.
| Argumento | Tipo | Descrição |
|---|---|---|
map | string | obrigatório. Level asset to open (package path or unique name). |
saveCurrent | boolean | Save dirty packages before switching. Padrão false. |
Retorna: name, package, path, opened, saved, message.
level.open_level_blueprint (risco 1, requer mundo)
Opens the Level Blueprint editor. Not smoke-tested: opens an editor window.
Sem argumentos.
Retorna: path, name, graphs, nodeCount, message.
level.place_along_spline (risco 2, altera, requer mundo, smoke)
Spawns copies of an actor class or a static mesh along a spline.
| Argumento | Tipo | Descrição |
|---|---|---|
actorClass | string | Actor class to spawn; ignored when staticMesh is given. |
staticMesh | string | Static mesh to place (spawns AStaticMeshActor). |
count | integer | How many copies to place; ignored when spacing is greater than 0. Padrão 5. |
spacing | number | Distance in cm between copies; 0 uses count. Padrão 0.0. |
alignToTangent | boolean | Rotate each copy to face along the spline. Padrão true. |
offset | {x,y,z} | Extra offset in cm applied to each copy. |
Retorna: changed, changedCount, failed, failedCount, message.
level.project_point_to_nav (risco 0, requer mundo, smoke)
Projects a world point onto the navmesh inside a search box.
| Argumento | Tipo | Descrição |
|---|---|---|
point | {x,y,z} | obrigatório. |
extent | {x,y,z} | Search box half-size in cm around the point. Padrão FUeaVec3(100.0, 100.0, 200.0). |
Retorna: found, point, distance, message.
level.rebuild_dirty_nav (risco 4, requer mundo)
Requests a rebuild of the navigation areas the editor marked dirty. Not smoke-tested: starts a navigation build that is not undoable.
Sem argumentos.
Retorna: started, building, finished, framesWaited, remainingTasks, message.
level.recapture_reflections (risco 1, altera, requer mundo, smoke)
Rebuilds every reflection capture in the level (invalid build-data GUIDs are repaired first, since the engine asserts on them).
Sem argumentos.
Retorna: repaired, repairedCount, count, message.
level.recapture_sky_light (risco 1, requer mundo, smoke)
Recaptures the sky into the sky light's cubemap.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | Actor label/name; empty = the first actor of the matching kind in the level. |
Retorna: message, count.
level.remove_actors_from_data_layer (risco 2, altera, UE 5.1+, requer mundo)
Removes actors from a data layer. Not smoke-tested: needs a partitioned world.
| Argumento | Tipo | Descrição |
|---|---|---|
actors | array of string | obrigatório. |
dataLayer | string | obrigatório. Data layer short name or asset path. |
Retorna: changed, changedCount, failed, failedCount, message.
level.remove_actors_from_layer (risco 2, altera, requer mundo)
Removes actors from an editor layer. Not smoke-tested: needs level actors that the self-test does not own.
| Argumento | Tipo | Descrição |
|---|---|---|
actors | array of string | obrigatório. |
layer | string | obrigatório. |
Retorna: changed, changedCount, failed, failedCount, message.
level.remove_post_process_material (risco 2, altera, requer mundo)
Removes a post-process material from the target's weighted blendables. Not smoke-tested: needs a project-authored post-process material.
| Argumento | Tipo | Descrição |
|---|---|---|
material | string | obrigatório. |
Retorna: target, materials, count, message.
level.remove_spline_point (risco 3, altera, destrutivo, requer mundo, smoke)
Removes one point from a spline.
| Argumento | Tipo | Descrição |
|---|---|---|
index | integer | obrigatório. |
Retorna: actor, component, points, pointCount, length, closed, message.
level.remove_sublevel (risco 3, altera, destrutivo, requer mundo)
Removes a sublevel from the current world (the asset is kept). Not smoke-tested: the self-test world has no sublevels.
| Argumento | Tipo | Descrição |
|---|---|---|
sublevel | string | obrigatório. Sublevel name or package path (substring match on the package is accepted). |
Retorna: message, count.
level.rename_layer (risco 2, altera, requer mundo, smoke)
Renames an editor layer.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | obrigatório. |
newName | string | obrigatório. |
Retorna: layers, count.
level.rename_map (risco 3, altera, smoke)
Renames a level asset in place (leaves a redirector).
| Argumento | Tipo | Descrição |
|---|---|---|
map | string | obrigatório. Level asset to rename. |
newName | string | obrigatório. New asset name (no path). |
Retorna: name, package, path, opened, saved, message.
level.repair_build_data_ids (risco 1, altera, requer mundo, smoke)
Replaces invalid (zero) build-data GUIDs on sky atmosphere, reflection capture and light components. The engine asserts on them during a build, so every build tool in this kit runs this first.
Sem argumentos.
Retorna: repaired, repairedCount, count, message.
level.reset_post_process (risco 3, altera, destrutivo, requer mundo, smoke)
Resets the target's post-process settings to the engine defaults (every override cleared).
| Argumento | Tipo | Descrição |
|---|---|---|
target | string | obrigatório. Post-process volume, camera actor or any actor with post-process settings. |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.resize_volume_to_actors (risco 2, altera, requer mundo)
Moves and resizes a volume so it encloses the given actors, plus a padding margin. Not smoke-tested: needs level actors that the self-test does not own.
| Argumento | Tipo | Descrição |
|---|---|---|
actors | array of string | obrigatório. Actors the volume must enclose. |
padding | number | Extra margin in cm added on every side. Padrão 100.0. |
Retorna: volume, properties, applied, failed, message.
level.reverse_spline (risco 2, altera, requer mundo, smoke)
Reverses the point order of a spline.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Actor carrying the spline component. |
component | string | Component name when the actor has more than one spline. |
Retorna: actor, component, points, pointCount, length, closed, message.
level.sample_spline (risco 0, requer mundo, smoke)
Location, rotation, tangent and up vector at a distance (or 0..1 alpha) along a spline.
| Argumento | Tipo | Descrição |
|---|---|---|
distance | number | Distance along the spline in cm; ignored when alpha is given. Padrão 0.0. |
alpha | string | Position along the spline as 0..1; empty uses distance. |
space | string | "local" or "world" (default). Padrão TEXT("world"). |
Retorna: actor, samples, count, length.
level.sample_spline_evenly (risco 0, requer mundo, smoke)
N evenly spaced samples along a spline.
| Argumento | Tipo | Descrição |
|---|---|---|
count | integer | obrigatório. How many samples to return (>= 2). |
space | string | "local" or "world" (default). Padrão TEXT("world"). |
Retorna: actor, samples, count, length.
level.save (risco 2)
Saves the level currently open (optionally "save as", optionally with its loaded sublevels). Not smoke-tested: writes to disk and an untitled level opens a modal Save As dialog.
| Argumento | Tipo | Descrição |
|---|---|---|
saveAs | string | Optional package path for "save as", e.g. "/Game/Maps/Copy". |
saveSublevels | boolean | Also save every loaded sublevel. Padrão false. |
Retorna: name, package, path, opened, saved, message.
level.set_actor_spatial (risco 2, altera, UE 5.0+, requer mundo)
Whether an actor streams with the partition grid, and which runtime grid it belongs to. Not smoke-tested: needs a level actor that the self-test does not own.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. |
spatiallyLoaded | boolean | obrigatório. Spatially loaded actors stream with the grid; non-spatial ones are always loaded. |
runtimeGrid | string | Runtime grid name; empty leaves it unchanged. |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.set_ambient_occlusion (risco 2, altera, requer mundo, smoke)
Screen-space ambient occlusion intensity, radius, static fraction, fade distance and power.
| Argumento | Tipo | Descrição |
|---|---|---|
intensity | string | |
radius | string | |
staticFraction | string | |
fadeDistance | string | |
power | string |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_audio_volume (risco 2, altera, requer mundo)
Priority, enabled flag and reverb of an audio volume. Not smoke-tested: needs an audio volume, which the smoke chain does not keep.
| Argumento | Tipo | Descrição |
|---|---|---|
priority | string | |
enabled | string | |
reverbEffect | string | Reverb effect asset. |
reverbVolume | string | Reverb volume 0..1. |
properties | array of UeaKeyValue |
Retorna: volume, properties, applied, failed, message.
level.set_blocking_volume_collision (risco 2, altera, requer mundo)
Collision profile of a blocking volume. Not smoke-tested: needs a blocking volume, which the smoke chain does not keep.
| Argumento | Tipo | Descrição |
|---|---|---|
profile | string | obrigatório. Collision profile name, e.g. "BlockAll", "InvisibleWall". |
Retorna: volume, properties, applied, failed, message.
level.set_bloom (risco 2, altera, requer mundo, smoke)
Bloom method, intensity, threshold and size.
| Argumento | Tipo | Descrição |
|---|---|---|
method | string | "standard" (gaussian) or "convolution". |
intensity | string | |
threshold | string | |
sizeScale | string | |
convolutionScatterDispersion | string | 5.0+ only. |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_chromatic_aberration (risco 2, altera, requer mundo, smoke)
Chromatic aberration (scene fringe) intensity and start offset.
| Argumento | Tipo | Descrição |
|---|---|---|
intensity | string | |
startOffset | string |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_color_grading (risco 2, altera, requer mundo, smoke)
Colour grading: saturation, contrast, gamma, gain, offset, white balance and scene colour tint.
| Argumento | Tipo | Descrição |
|---|---|---|
saturation | string | FVector4 fields accept "(X=1,Y=1,Z=1,W=1)" or "1,1,1,1". |
contrast | string | |
gamma | string | |
gain | string | |
offset | string | |
temperature | string | |
tint | string | |
sceneColorTint | string | Scene colour tint as "(R=1,G=1,B=1,A=1)". |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_cull_distances (risco 2, altera, requer mundo)
Size/distance pairs of a cull distance volume. Not smoke-tested: needs a cull distance volume, which the smoke chain does not keep.
| Argumento | Tipo | Descrição |
|---|---|---|
entries | array of UeaCullDistanceEntry | obrigatório. |
Retorna: volume, properties, applied, failed, message.
level.set_current_sublevel (risco 1, requer mundo, smoke)
Makes a sublevel the current level new actors spawn into (empty = the persistent level).
| Argumento | Tipo | Descrição |
|---|---|---|
sublevel | string | Sublevel name or package path; empty = the persistent level. |
Retorna: sublevel, message.
level.set_data_layer_state (risco 2, altera, UE 5.1+, requer mundo)
Initial runtime state, editor visibility and editor loading of a data layer. Not smoke-tested: needs a partitioned world.
| Argumento | Tipo | Descrição |
|---|---|---|
dataLayer | string | obrigatório. Data layer short name or asset path. |
state | string | "loaded", "activated" or "unloaded" (the initial runtime state). |
visible | string | Editor visibility. |
loadedInEditor | string | Whether the layer's actors are loaded in the editor. |
Retorna: dataLayers, count, message.
level.set_depth_of_field (risco 2, altera, requer mundo, smoke)
Depth of field: focal distance, f-stop, sensor width, focal region and blur sizes.
| Argumento | Tipo | Descrição |
|---|---|---|
focalDistance | string | |
fstop | string | |
sensorWidth | string | |
focalRegion | string | |
nearBlur | string | |
farBlur | string | |
method | string | 4.27 only (DepthOfFieldMethod); reported as failed on 5.x, where only Cinematic DoF exists. |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_directional_shadows (risco 2, altera, requer mundo, smoke)
Cascaded shadow map settings of a directional light.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | Directional light; empty = the first one in the level. |
cascades | string | |
dynamicShadowDistance | string | |
distanceFieldShadows | string | |
cascadeDistribution | string |
Retorna: entries, count, message.
level.set_exposure (risco 2, altera, requer mundo, smoke)
Auto-exposure method, bias, brightness range and adaptation speed.
| Argumento | Tipo | Descrição |
|---|---|---|
method | string | "manual", "histogram" or "basic". |
bias | string | |
minBrightness | string | |
maxBrightness | string | |
speedUp | string | |
speedDown | string | |
applyPhysicalCamera | string |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_film_grain (risco 2, altera, UE 5.0+, requer mundo, smoke)
Film grain intensity and its shadow/midtone/highlight weights.
| Argumento | Tipo | Descrição |
|---|---|---|
intensity | string | |
intensityShadows | string | |
intensityMidtones | string | |
intensityHighlights | string |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_fog (risco 2, altera, requer mundo, smoke)
Changes any subset of the exponential height fog settings.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | |
density | string | |
heightFalloff | string | |
fogColor | UeaColor | |
useFogColor | boolean | Padrão false. |
startDistance | string | |
volumetric | string | |
extinctionScale | string | |
secondFogDensity | string | |
secondFogHeightFalloff | string | |
secondFogHeightOffset | string | |
volumetricScatteringDistribution | string | |
volumetricAlbedo | UeaColor | |
useVolumetricAlbedo | boolean | Padrão false. |
properties | array of UeaKeyValue |
Retorna: entries, count, message.
level.set_force_no_precomputed_lighting (risco 2, altera, requer mundo, smoke)
Turns "Force No Precomputed Lighting" on or off in World Settings (fully dynamic lighting).
| Argumento | Tipo | Descrição |
|---|---|---|
enabled | boolean | obrigatório. |
Retorna: entries, count, message.
level.set_game_mode_override (risco 2, altera, requer mundo, smoke)
Sets (or clears) the Game Mode override of this level.
| Argumento | Tipo | Descrição |
|---|---|---|
gameMode | string | Game mode class or Blueprint; empty clears the override. |
Retorna: entries, count, message.
level.set_global_illumination (risco 2, altera, UE 5.0+, requer mundo, smoke)
Global illumination method (Lumen, SSGI, none) and Lumen quality.
| Argumento | Tipo | Descrição |
|---|---|---|
method | string | "none", "lumen", "ssgi" or "plugin". |
lumenSceneLightingQuality | string | |
lumenFinalGatherQuality | string |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_kill_z (risco 2, altera, requer mundo, smoke)
Sets the Kill Z of this level (actors below it are destroyed).
| Argumento | Tipo | Descrição |
|---|---|---|
killZ | number | obrigatório. Z below which actors are destroyed (cm). |
Retorna: entries, count, message.
level.set_layer_visible (risco 1, requer mundo, smoke)
Shows or hides every actor of an editor layer.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | obrigatório. |
visible | boolean | obrigatório. |
Retorna: layers, count.
level.set_lens_flares (risco 2, altera, requer mundo, smoke)
Lens flare intensity, tint, bokeh size and threshold.
| Argumento | Tipo | Descrição |
|---|---|---|
intensity | string | |
tint | string | "(R=1,G=1,B=1,A=1)". |
bokehSize | string | |
threshold | string |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_light (risco 2, altera, requer mundo, smoke)
Changes any subset of a light's settings (empty fields are left unchanged).
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. Light actor label, name or unique class. |
intensity | string | |
color | UeaColor | Colour; leave at the default and set useColor false to keep the current colour. |
useColor | boolean | Apply color (false = keep the current colour). Padrão false. |
temperature | string | |
useTemperature | string | |
castShadows | string | |
mobility | string | "static", "stationary" or "movable". |
attenuationRadius | string | |
innerCone | string | |
outerCone | string | |
sourceRadius | string | |
indirectIntensity | string | |
volumetricScattering | string | |
specularScale | string | |
iesTexture | string | IES profile texture asset. |
properties | array of UeaKeyValue |
Retorna: light, properties, applied, failed, message.
level.set_light_channels (risco 2, altera, requer mundo, smoke)
Sets the lighting channels a light affects.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. |
channel0 | boolean | Padrão true. |
channel1 | boolean | Padrão false. |
channel2 | boolean | Padrão false. |
Retorna: light, properties, applied, failed, message.
level.set_light_function (risco 2, altera, requer mundo, smoke)
Sets a light's light-function material.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. |
material | string | obrigatório. Light function material; empty clears it. |
Retorna: light, properties, applied, failed, message.
level.set_light_ies (risco 2, altera, requer mundo, smoke)
Sets a light's IES profile texture.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. |
iesTexture | string | obrigatório. IES profile texture asset (UTextureLightProfile); empty clears it. |
useIesBrightness | boolean | Padrão false. |
Retorna: light, properties, applied, failed, message.
level.set_light_indirect (risco 2, altera, requer mundo, smoke)
Indirect lighting intensity and volumetric scattering of one light.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. |
indirectIntensity | string | |
volumetricScattering | string |
Retorna: entries, count, message.
level.set_light_mobility (risco 2, altera, requer mundo, smoke)
Sets a light's mobility (static, stationary or movable).
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. |
mobility | string | obrigatório. "static", "stationary" or "movable". |
Retorna: light, properties, applied, failed, message.
level.set_lighting_scenario (risco 2, altera, requer mundo, smoke)
Marks a level as a lighting scenario (its baked lighting can be swapped at runtime).
| Argumento | Tipo | Descrição |
|---|---|---|
sublevel | string | obrigatório. Sublevel name; empty = the persistent level. |
enabled | boolean | obrigatório. |
Retorna: sublevels, count.
level.set_lightmap_resolution (risco 2, altera, requer mundo)
Overrides the lightmap resolution of one mesh component. Not smoke-tested: needs a static mesh actor that the self-test does not own.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | obrigatório. |
resolution | integer | obrigatório. Lightmap resolution in texels (power of two, e.g. 64). |
component | string | Component name when the actor has several meshes. |
Retorna: entries, count, lightmapTotalSizeKB, shadowmapTotalSizeKB, message.
level.set_lightmap_resolution_many (risco 2, altera, requer mundo, smoke)
Overrides the lightmap resolution of many actors at once.
| Argumento | Tipo | Descrição |
|---|---|---|
actors | array of string | Actors to change; empty uses classFilter. |
classFilter | string | Apply to every actor of this class when actors is empty; empty = every mesh actor. |
resolution | integer | obrigatório. |
Retorna: changed, changedCount, failed, failedCount, message.
level.set_lightmass_settings (risco 2, altera, requer mundo, smoke)
Changes any subset of the Lightmass settings of the current level.
| Argumento | Tipo | Descrição |
|---|---|---|
numIndirectLightingBounces | string | |
numSkyLightingBounces | string | |
indirectLightingQuality | string | |
indirectLightingSmoothness | string | |
staticLightingLevelScale | string | |
environmentColor | string | "(R=1,G=1,B=1,A=1)". |
environmentIntensity | string | |
useAmbientOcclusion | string | |
compressLightmaps | string | |
properties | array of UeaKeyValue | Any other LightmassSettings field by name. |
Retorna: entries, count, message.
level.set_lights_many (risco 2, altera, requer mundo, smoke)
Applies the same settings to many lights at once (by list or by class).
| Argumento | Tipo | Descrição |
|---|---|---|
actors | array of string | Light actors to change; empty uses classFilter. |
classFilter | string | Apply to every light of this class when actors is empty; empty = every light. |
intensity | string | |
color | UeaColor | |
useColor | boolean | Padrão false. |
temperature | string | |
useTemperature | string | |
castShadows | string | |
mobility | string | "static", "stationary" or "movable". |
attenuationRadius | string | |
innerCone | string | |
outerCone | string | |
sourceRadius | string | |
indirectIntensity | string | |
volumetricScattering | string | |
specularScale | string | |
iesTexture | string | |
properties | array of UeaKeyValue |
Retorna: changed, changedCount, failed, failedCount, message.
level.set_lights_mobility_many (risco 2, altera, requer mundo, smoke)
Sets the mobility of every light (optionally of one class) at once.
| Argumento | Tipo | Descrição |
|---|---|---|
mobility | string | obrigatório. "static", "stationary" or "movable". |
classFilter | string | Light class to change; empty = every light. |
Retorna: changed, changedCount, failed, failedCount, message.
level.set_motion_blur (risco 2, altera, requer mundo, smoke)
Motion blur amount, maximum, per-object size and target FPS.
| Argumento | Tipo | Descrição |
|---|---|---|
amount | string | |
max | string | |
perObjectSize | string | |
targetFps | string |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_nav_agent (risco 4)
Changes a supported navigation agent in the project settings and writes DefaultEngine.ini. Not smoke-tested: writes the project's DefaultEngine.ini, which the self-test must not touch.
| Argumento | Tipo | Descrição |
|---|---|---|
name | string | obrigatório. Agent name from level.get_nav_settings, e.g. "Default". |
radius | string | |
height | string | |
stepHeight | string | |
maxSlope | string | Maximum walkable slope in degrees. Not an agent property: reported as unsupported and applied through level.set_recast_settings instead. |
Retorna: agents, count, autoCreateNavigationData, allowClientSideNavigation, buildNavigationAtRuntime, entries, message.
level.set_nav_modifier_area (risco 2, altera, requer mundo)
Nav area class applied by a nav modifier volume. Not smoke-tested: needs a nav modifier volume, which the smoke chain does not keep.
| Argumento | Tipo | Descrição |
|---|---|---|
areaClass | string | obrigatório. Nav area class, e.g. "NavArea_Null", "NavArea_Obstacle", "NavArea_Default". |
Retorna: volume, properties, applied, failed, message.
level.set_nav_runtime_generation (risco 2, altera, requer mundo)
Runtime generation mode of the nav data actors (static, dynamic, dynamicModifiersOnly). Not smoke-tested: an empty project has no navigation data actor until a nav mesh bounds volume is built.
| Argumento | Tipo | Descrição |
|---|---|---|
mode | string | obrigatório. "static", "dynamic" or "dynamicModifiersOnly". |
actor | string | Nav data actor to change; empty = every nav data in the level. |
Retorna: navData, count, message.
level.set_pain_volume (risco 2, altera, requer mundo)
Damage settings of a pain-causing volume. Not smoke-tested: needs a pain-causing volume, which level.add_volume can create but the smoke chain does not keep.
| Argumento | Tipo | Descrição |
|---|---|---|
damagePerSec | string | |
damageType | string | Damage type class. |
painCausing | string | |
entryPain | string |
Retorna: volume, properties, applied, failed, message.
level.set_physics_volume (risco 2, altera, requer mundo)
Priority, friction, terminal velocity and water flag of a physics volume. Not smoke-tested: needs a physics volume, which the smoke chain does not keep.
| Argumento | Tipo | Descrição |
|---|---|---|
priority | string | |
fluidFriction | string | |
terminalVelocity | string | |
waterVolume | string |
Retorna: volume, properties, applied, failed, message.
level.set_post_process (risco 2, altera, requer mundo, smoke)
Writes arbitrary post-process fields by name (the bOverride_ flag of each is turned on).
| Argumento | Tipo | Descrição |
|---|---|---|
settings | array of UeaKeyValue | obrigatório. Field name -> value; the matching bOverride_ flag is turned on automatically. |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_post_process_volume (risco 2, altera, requer mundo, smoke)
Changes the volume's own settings (bounds mode, priority, blending, size).
| Argumento | Tipo | Descrição |
|---|---|---|
unbound | string | |
priority | string | |
blendRadius | string | |
blendWeight | string | |
enabled | string | |
extent | {x,y,z} | New half-size in cm; rebuilds the volume's brush. |
useExtent | boolean | Apply extent (false = keep the current size). Padrão false. |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_recast_settings (risco 2, altera, requer mundo)
Recast navmesh generation settings (cell size, agent size, tile size, debug draw). Not smoke-tested: an empty project has no RecastNavMesh actor until navigation is built.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | RecastNavMesh actor; empty = the first one in the level. |
cellSize | string | |
cellHeight | string | |
agentRadius | string | |
agentHeight | string | |
tileSizeUU | string | Tile size in Unreal units. |
drawDebug | string | Draw the navmesh in the editor viewport. |
properties | array of UeaKeyValue |
Retorna: entries, count, message.
level.set_reflection_method (risco 2, altera, requer mundo, smoke)
Reflection method (Lumen, SSR, none) and screen-space reflection quality/intensity.
| Argumento | Tipo | Descrição |
|---|---|---|
method | string | "none", "lumen" or "ssr" (5.0+; the SSR fields work on 4.27 too). |
ssrQuality | string | |
ssrIntensity | string |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_sky_atmosphere (risco 2, altera, requer mundo, smoke)
Changes any subset of the SkyAtmosphere settings.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | |
rayleighScatteringScale | string | |
rayleighScattering | UeaColor | |
useRayleighScattering | boolean | Padrão false. |
mieScatteringScale | string | |
mieAnisotropy | string | |
groundAlbedo | UeaColor | |
useGroundAlbedo | boolean | Padrão false. |
atmosphereHeight | string | Atmosphere height in km. |
multiScattering | string | |
properties | array of UeaKeyValue |
Retorna: entries, count, message.
level.set_sky_light (risco 2, altera, requer mundo, smoke)
Changes any subset of the sky light's settings.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | Sky light actor; empty = the first one in the level. |
intensity | string | |
color | UeaColor | |
useColor | boolean | Padrão false. |
realTimeCapture | string | |
cubemap | string | Cubemap texture asset (switches the source to "specified cubemap"). |
lowerHemisphereColor | UeaColor | |
useLowerHemisphereColor | boolean | Padrão false. |
occlusion | string | Occlusion (distance field ambient occlusion) intensity. |
properties | array of UeaKeyValue |
Retorna: entries, count, message.
level.set_spline_closed (risco 2, altera, requer mundo, smoke)
Opens or closes the loop of a spline.
| Argumento | Tipo | Descrição |
|---|---|---|
closed | boolean | obrigatório. |
Retorna: actor, component, points, pointCount, length, closed, message.
level.set_spline_point (risco 2, altera, requer mundo, smoke)
Changes any subset of one point's position, tangents, rotation, scale and type.
| Argumento | Tipo | Descrição |
|---|---|---|
index | integer | obrigatório. |
position | {x,y,z} | |
usePosition | boolean | Padrão false. |
arriveTangent | {x,y,z} | |
useArriveTangent | boolean | Padrão false. |
leaveTangent | {x,y,z} | |
useLeaveTangent | boolean | Padrão false. |
rotation | {x,y,z} | |
useRotation | boolean | Padrão false. |
scale | {x,y,z} | |
useScale | boolean | Padrão false. |
type | string | linear, curve, constant, curveClamped or curveCustomTangent. |
space | string | "local" (default) or "world". Padrão TEXT("local"). |
Retorna: actor, component, points, pointCount, length, closed, message.
level.set_spline_point_type (risco 2, altera, requer mundo, smoke)
Sets the interpolation type of one point (index -1 = every point).
| Argumento | Tipo | Descrição |
|---|---|---|
type | string | obrigatório. linear, curve, constant, curveClamped or curveCustomTangent. |
index | integer | Point index; -1 applies to every point. Padrão -1. |
Retorna: actor, component, points, pointCount, length, closed, message.
level.set_spline_points (risco 2, altera, requer mundo, smoke)
Replaces every point of a spline.
| Argumento | Tipo | Descrição |
|---|---|---|
points | array of {x,y,z} | obrigatório. New point positions, replacing every existing point. |
space | string | "local" (default) or "world". Padrão TEXT("local"). |
Retorna: actor, component, points, pointCount, length, closed, message.
level.set_sublevel_loaded (risco 2, altera, requer mundo)
Loads or unloads a sublevel (flushes level streaming). Not smoke-tested: the self-test world has no sublevels.
| Argumento | Tipo | Descrição |
|---|---|---|
sublevel | string | obrigatório. |
loaded | boolean | obrigatório. |
Retorna: sublevel, message.
level.set_sublevel_locked (risco 2, altera, requer mundo)
Locks or unlocks a sublevel for editing. Not smoke-tested: the self-test world has no sublevels.
| Argumento | Tipo | Descrição |
|---|---|---|
sublevel | string | obrigatório. |
locked | boolean | obrigatório. |
Retorna: sublevel, message.
level.set_sublevel_streaming_class (risco 2, altera, requer mundo)
Switches a sublevel between always-loaded and blueprint (dynamic) streaming. Not smoke-tested: the self-test world has no sublevels.
| Argumento | Tipo | Descrição |
|---|---|---|
sublevel | string | obrigatório. |
streamingClass | string | obrigatório. "always_loaded" or "blueprint". |
Retorna: sublevel, message.
level.set_sublevel_transform (risco 2, altera, requer mundo)
Moves a sublevel by setting its editor transform. Not smoke-tested: the self-test world has no sublevels.
| Argumento | Tipo | Descrição |
|---|---|---|
sublevel | string | obrigatório. |
location | {x,y,z} | |
rotation | {x,y,z} |
Retorna: sublevel, message.
level.set_sublevel_visible (risco 2, altera, requer mundo)
Shows or hides a sublevel in the editor. Not smoke-tested: the self-test world has no sublevels.
| Argumento | Tipo | Descrição |
|---|---|---|
sublevel | string | obrigatório. |
visible | boolean | obrigatório. |
Retorna: sublevel, message.
level.set_sun_from_time (risco 2, altera, requer mundo, smoke)
Points the sun using a simple solar model (hour of day + latitude).
| Argumento | Tipo | Descrição |
|---|---|---|
hour | number | obrigatório. Hour of day, 0..24 (12 = noon). |
latitude | number | Latitude in degrees (positive = northern hemisphere). Padrão 0.0. |
azimuth | number | Compass direction the sun travels through, in degrees. Padrão 0.0. |
actor | string | Directional light to rotate; empty = the first one in the level. |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.set_sun_rotation (risco 2, altera, requer mundo, smoke)
Points the sun (a directional light) at a pitch/yaw.
| Argumento | Tipo | Descrição |
|---|---|---|
pitch | number | obrigatório. Pitch in degrees (negative points down). |
yaw | number | obrigatório. Yaw in degrees. |
actor | string | Directional light to rotate; empty = the first one in the level. |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.set_time_dilation_limits (risco 2, altera, requer mundo, smoke)
Sets the minimum/maximum global time dilation of this level.
| Argumento | Tipo | Descrição |
|---|---|---|
min | string | Minimum global time dilation; empty leaves it unchanged. |
max | string | Maximum global time dilation; empty leaves it unchanged. |
Retorna: entries, count, message.
level.set_trigger_collision (risco 2, altera, requer mundo, smoke)
Collision profile and overlap events of a trigger volume.
| Argumento | Tipo | Descrição |
|---|---|---|
profile | string | Collision profile name, e.g. "Trigger", "OverlapAllDynamic", "BlockAll". |
generateOverlapEvents | string |
Retorna: volume, properties, applied, failed, message.
level.set_vignette (risco 2, altera, requer mundo, smoke)
Vignette intensity (0..1).
| Argumento | Tipo | Descrição |
|---|---|---|
intensity | string | obrigatório. |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_volume_extent (risco 2, altera, requer mundo, smoke)
Resizes a volume (rebuilds the BSP brush, or resizes the collision component of a trigger).
| Argumento | Tipo | Descrição |
|---|---|---|
extent | {x,y,z} | obrigatório. New half-size in cm. |
radius | number | New radius in cm for sphere/capsule triggers. Padrão 0.0. |
Retorna: volume, properties, applied, failed, message.
level.set_volume_priority (risco 2, altera, requer mundo)
Priority of an audio or post-process volume. Not smoke-tested: needs an audio or post-process volume selected by actor, covered by level.set_post_process_volume instead.
| Argumento | Tipo | Descrição |
|---|---|---|
priority | number | obrigatório. Higher priority wins where volumes overlap. |
Retorna: volume, properties, applied, failed, message.
level.set_volumetric_cloud (risco 2, altera, requer mundo, smoke)
Changes any subset of the VolumetricCloud settings.
| Argumento | Tipo | Descrição |
|---|---|---|
actor | string | |
layerBottomAltitude | string | Cloud layer bottom altitude in km. |
layerHeight | string | Cloud layer thickness in km. |
tracingStartMaxDistance | string | |
tracingMaxDistance | string | |
material | string | Cloud material asset. |
properties | array of UeaKeyValue |
Retorna: entries, count, message.
level.set_white_balance (risco 2, altera, requer mundo, smoke)
White balance temperature, tint and temperature type.
| Argumento | Tipo | Descrição |
|---|---|---|
temperature | string | |
tint | string | |
method | string | "whiteBalance" or "colorTemperature". |
Retorna: target, fields, count, overriddenCount, applied, failed, message.
level.set_world_gravity (risco 2, altera, requer mundo, smoke)
Sets the per-level gravity override (cm/s^2 on Z).
| Argumento | Tipo | Descrição |
|---|---|---|
gravityZ | number | obrigatório. Gravity on Z in cm/s^2 (engine default is -980). |
override | boolean | obrigatório. Use this value instead of the project default. |
Retorna: entries, count, message.
level.set_world_to_meters (risco 2, altera, requer mundo, smoke)
Sets WorldToMeters (Unreal units per metre, default 100).
| Argumento | Tipo | Descrição |
|---|---|---|
scale | number | obrigatório. Unreal units per metre (default 100). |
Retorna: entries, count, message.
level.setup_default_environment (risco 2, altera, requer mundo, smoke)
Creates the actors a lit, playable level needs (sun, sky light, sky atmosphere, fog, optionally clouds), skipping the ones that already exist.
| Argumento | Tipo | Descrição |
|---|---|---|
sun | boolean | Add a directional light acting as the sun. Padrão true. |
skyLight | boolean | Add a sky light (real-time capture on 5.x). Padrão true. |
skyAtmosphere | boolean | Add a SkyAtmosphere actor. Padrão true. |
fog | boolean | Add an exponential height fog actor. Padrão true. |
clouds | boolean | Add a VolumetricCloud actor. Padrão false. |
sunPitch | number | Sun pitch in degrees (negative points down; -45 is a mid-afternoon sun). Padrão -45.0. |
Retorna: created, existing, createdCount, message.
level.spline_from_actors (risco 2, altera, requer mundo)
Creates a spline whose points are the world locations of the given actors, in order. Not smoke-tested: needs level actors that the self-test does not own.
| Argumento | Tipo | Descrição |
|---|---|---|
actors | array of string | obrigatório. Actors whose locations become the spline points, in order. |
name | string | Padrão TEXT("Spline"). |
closed | boolean | Padrão false. |
Retorna: name, label, class, path, location, rotation, applied, failed, message.
level.unload_region (risco 1, UE 5.3+, requer mundo)
Unloads the partition cells intersecting a world-space box. Not smoke-tested: needs a partitioned world.
| Argumento | Tipo | Descrição |
|---|---|---|
min | {x,y,z} | obrigatório. Minimum corner of the world-space box to load/unload. |
max | {x,y,z} | obrigatório. Maximum corner of the world-space box. |
Retorna: applied, min, max, message.