Pular para o conteúdo principal

Kit actor

197 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 actors placed in the editor world: finding them, spawning them from classes, Blueprints or asset paths, transforms, components added at edit time, attachment, outliner folders, groups, selection, mesh/decal/text/camera/sound specifics, bulk edits, JSON export/import, conversions and geometry queries.

Works on UE 4.27 through 5.8. Every tool is RequiresWorld: the core refuses the call with E_EDITOR_STATE when no level is loaded. The kit is split over six classes that all expose the actor. namespace:

ClassTheme
UUeaKit_Actorquery, spawn, duplicate, delete, clipboard, labels, tags, flags, reflection
UUeaKit_ActorTransformlocation/rotation/scale, alignment, distribution, snapping, mirroring
UUeaKit_ActorComponentsinstance components on level actors
UUeaKit_ActorHierarchyattachment, outliner folders, groups, selection
UUeaKit_ActorMeshstatic/skeletal/instanced meshes, decals, text, cameras, sounds
UUeaKit_ActorBulkbulk edits, export/import, stats, hygiene checks, traces, snapshots

Not in this kit: environment/volume/spline/post-process actors and layers (level kit), actors of a running PIE session (play.* in the edit kit), Blueprint construction-script components (bp kit).

Start here​

  1. actor.list {"limit": 20} — what is in the level (add classFilter, nameContains, tag, folder, includeBounds).
  2. actor.spawn_mesh {"mesh": "/Engine/BasicShapes/Cube", "name": "Crate", "location": {"z": 100}}.
  3. actor.get {"actor": "Crate", "includeComponents": true} — full state, components, bounds, GUID.

How actors are referenced​

Any actor argument accepts, in this order: the outliner label, the object name, a unique class name ("PlayerStart", "WorldSettings") or a unique label/name prefix. actors[] arguments accept the same forms plus the selectors class:Name, tag:Name, folder:Path, selected and all. Many *_many tools also accept an empty actors list plus a classFilter / nameContains / tag / folder filter instead.

Tools​

Query​

ToolPurpose
actor.listPaged listing with class/name/tag/folder/sublevel/hidden filters.
actor.get / actor.existsFull description (optionally components and properties) / existence check.
actor.count_by_class / actor.list_tagsHistograms of the level or of one folder.
actor.find_by_tag / actor.find_by_class / actor.find_by_labelBy tag, class (subclasses optional) or */? wildcard label.
actor.find_in_radius / actor.find_in_box / actor.get_nearest / actor.get_distanceSpatial queries.
actor.get_boundsCombined and per-actor bounding boxes.
actor.get_outliner_path / actor.get_guid / actor.get_by_guidOutliner path and persistent GUID.

Spawn, duplicate, delete​

ToolPurpose
actor.spawnFrom a class, a Blueprint or an asset path; applies label, folder, tags, properties.
actor.spawn_meshStaticMesh -> AStaticMeshActor, SkeletalMesh -> ASkeletalMeshActor, with material and mobility.
actor.spawn_many / actor.spawn_at_actorA list of specs in one transaction / at another actor's transform.
actor.spawn_grid / actor.spawn_circle / actor.spawn_random_in_boxProcedural placement (namePrefix, seed).
actor.spawn_player_start / actor.spawn_camera / actor.spawn_text / actor.spawn_decal / actor.spawn_sound / actor.spawn_emptyTyped spawners. cine: true gives a ACineCameraActor.
actor.duplicate / actor.duplicate_manyCopies with a cumulative offset.
actor.delete / actor.delete_many / actor.delete_by_filterdelete_by_filter is Risk 5 and honours dryRun.
actor.copy_to_clipboard / actor.paste_from_clipboardT3D text in and out of the editor clipboard.

Labels, tags, flags, reflection​

ToolPurpose
actor.set_label / actor.rename_many / actor.relabel_by_classrename_many uses {base}, {n} and {class}; relabel_by_class honours dryRun.
actor.set_tags / actor.add_tag / actor.remove_tag / actor.has_tagActor tags.
actor.set_hidden / actor.set_mobilityEditor and/or game visibility; mobility on every scene component.
actor.set_flagscanBeDamaged, replicates, netLoadOnClient, tickEnabled, lifeSpan, netDormancy, enableCollision, alwaysRelevant, autoDestroyWhenFinished — each guarded by a has* flag.
actor.get_property / set_property / get_properties / set_properties / list_properties / reset_propertyReflection over the actor and its components.
actor.call_functionCalls any UFUNCTION on the actor and returns its out/return parameters (Risk 3).

Transform​

actor.get_transform, set_location, set_rotation, set_scale, set_transform (space: world/local, sweep, teleport), move_by, rotate_by, scale_by, set_transform_many, look_at (axis, keepPitch), align_to_actor, align_to_grid, distribute, arrange_line, snap_to_floor (line trace + optional normal alignment), snap_to_actor, place_on_surface, mirror, set_pivot_offset, randomize_transform, get_relative_transform, match_transform, move_to_camera, focus_camera.

Delta tools (move_by, rotate_by, scale_by) and most *_many tools fall back to the current editor selection when actors is empty.

Components​

actor.list_components, get_component, add_component, remove_component, rename_component, get_component_property / set_component_property / set_component_properties / list_component_properties, set_component_transform (world: true for world space), attach_component, detach_component, set_component_mobility, set_component_visibility, set_component_hidden_in_game, set_component_collision, set_component_physics, set_component_material, get_component_materials, set_component_mesh, copy_components, get_component_bounds, set_component_tags, set_component_tick, list_sockets, get_socket_transform.

Component references resolve loosely too: exact name, case-insensitive name, unique class name ("StaticMeshComponent" finds StaticMeshComponent0) or unique name prefix. An empty component means the root component.

Hierarchy, folders, groups, selection​

  • Attachment: actor.attach, attach_many, detach, get_parent, get_children, get_root_component, set_root_component. rule is keepWorld (default), keepRelative or snapToTarget.
  • Folders: actor.list_folders, create_folder, rename_folder, delete_folder, set_folder, get_folder_actors, move_folder.
  • Groups: actor.group, ungroup, list_groups, get_group, add_to_group, remove_from_group, lock_group, unlock_group, set_grouping_active.
  • Selection: actor.select, deselect, select_none, get_selected, select_by_filter, select_children, select_parent, select_similar, select_in_box, invert_selection, select_component, get_selected_components, frame_selected.

Mesh actors​

  • Static: actor.set_static_mesh, get_static_mesh_info, set_materials, set_material_slot, list_material_slots, set_lod, set_cast_shadow, set_lightmap_resolution, set_collision_complexity, set_mesh_mobility, set_render_settings, set_nanite (5.0+), replace_mesh_many, apply_material_many.
  • Skeletal: actor.set_skeletal_mesh, set_animation_asset, set_anim_blueprint, get_skeletal_info.
  • Instanced: actor.create_instanced_mesh (hierarchical for HISM), add_instances, get_instances, set_instance_transform, remove_instances, clear_instances, instances_from_actors, instances_to_actors.
  • Others: actor.set_decal, set_text, set_camera, set_cine_camera, set_sound.

Bulk, export/import, analysis​

  • Bulk: actor.set_property_many, set_properties_many, set_tags_many, set_folder_many, set_hidden_many (all take a list or a filter; most honour dryRun).
  • Layout: actor.export, export_folder, import.
  • Conversion: actor.replace_with, convert_to_blueprint (harvest for several actors in one Blueprint), merge_static_meshes.
  • Analysis: actor.get_stats, find_missing_assets, find_overlapping, find_outside_bounds, find_at_origin, find_duplicates, find_unlabeled, validate, get_outliner_tree.
  • Geometry: actor.line_trace, sweep_box, overlap_box, overlap_sphere, raycast_from_camera.
  • Experiments: actor.snapshot_transforms / actor.restore_transforms (named in-memory snapshot, independent of the undo buffer).

Recipe: build a test arena​

  1. actor.spawn_grid {"mesh": "/Engine/BasicShapes/Cube", "rows": 5, "columns": 5, "spacing": 300, "namePrefix": "Floor", "folder": "Arena/Floor"}
  2. actor.spawn_player_start {"name": "Start", "location": {"z": 200}, "folder": "Arena"}
  3. actor.spawn_camera {"name": "Overview", "location": {"x": -1500, "z": 900}, "fov": 75, "folder": "Arena"}
  4. actor.look_at {"actor": "Overview", "target": "Floor_2_2"}
  5. actor.spawn_circle {"mesh": "/Engine/BasicShapes/Sphere", "count": 8, "radius": 600, "faceCenter": true, "namePrefix": "Pillar", "folder": "Arena/Props"}
  6. actor.snap_to_floor {"actors": ["folder:Arena/Props"]}
  7. actor.set_tags_many {"folder": "Arena", "tags": ["arena"], "add": true}
  8. actor.get_stats {} to check the triangle budget, then level.save (level kit).

Recipe: organise an imported level​

  1. actor.find_unlabeled {} then actor.relabel_by_class {"dryRun": true} to preview, then without dryRun.
  2. actor.select_by_filter {"classFilter": "StaticMeshActor"} and actor.set_folder_many {"classFilter": "StaticMeshActor", "path": "Geometry"}.
  3. actor.find_at_origin {} and actor.find_duplicates {} to spot mistakes.
  4. actor.validate {} for missing meshes/materials and degenerate scales.
  5. actor.get_outliner_tree {"limit": 20} for the final shape.

Recipe: instanced meshes for performance​

  1. actor.find_by_class {"class": "StaticMeshActor"} and group the ones sharing a mesh.
  2. actor.instances_from_actors {"actors": ["tag:foliage"], "deleteSource": true, "hierarchical": true, "name": "ISM_Foliage"}
  3. actor.get_instances {"actor": "ISM_Foliage", "limit": 20} / actor.add_instances to extend it.
  4. actor.instances_to_actors {"actor": "ISM_Foliage"} to go back to individual actors when editing.

Recipe: export a layout and re-import it elsewhere​

  1. actor.export_folder {"folder": "Arena", "properties": ["Tags"], "pretty": true} -> JSON string.
  2. Open the destination level (level kit).
  3. actor.import {"json": "<that JSON>", "offset": {"x": 5000}, "folder": "ArenaCopy"}.

Recipe: turn a prototype actor into a Blueprint​

  1. Build the actor with actor.spawn_empty + actor.add_component calls.
  2. actor.convert_to_blueprint {"actors": ["Prototype"], "folder": "/Game/Blueprints", "name": "BP_Prototype", "replaceInLevel": true}
  3. Continue in the bp kit (bp.add_variable, bp.add_function, bp.compile).

Gotchas​

  • Editor world only. These tools never touch a running PIE session; use play.* (edit kit) for that. Changes are recorded in the editor transaction, so edit.undo reverts them, but the level is only written to disk by the level kit's save tools.
  • Every spawned actor gets a scene root. A bare AActor has no root component, which would make it useless for transforms, attachment and actor.convert_to_blueprint, so the kit adds a movable DefaultSceneRoot (the same thing the editor's "Empty Actor" placement does). AInfo actors (GameMode, WorldSettings, …) are left transformless, as the engine intends.
  • Static mobility refuses transform edits. actor.spawn_mesh defaults to Static; pass mobility: "Movable" (or call actor.set_mobility) before moving a mesh actor at runtime.
  • properties[] values use Unreal text form: "42", "true", "(X=1,Y=2,Z=3)", an enum entry name ("Movable"), or an asset path. Paths may be Prop, Struct.Prop, Component.Prop and array elements with Prop[0].
  • Labels are not object names. actor.set_label changes only the outliner label; the object name stays as it was spawned. actor.get returns both.
  • Folders are plain path strings ("Props/Crates"). On 5.1+ they are mapped to FFolder internally. A folder with no actors disappears when the level is reloaded; actor.delete_folder simply moves its actors out.
  • Groups need grouping mode. If actor.group reports that no group was created, call actor.set_grouping_active {"active": true} first.
  • actor.add_component creates instance components. Native, Blueprint and root components cannot be removed from a level actor; use the bp kit for the Blueprint's construction script instead. actor.remove_component re-parents the component's children before destroying it.
  • A non-root scene component can never be parentless. actor.detach_component therefore re-parents to the actor's root rather than detaching to nothing, and is a no-op when the component already sits directly under the root. (actor.detach on whole actors does detach normally.)
  • actor.replace_with goes through the editor's actor conversion, which only carries the transform; the kit restores label, folder and tags afterwards. Some class pairs are refused by the editor and the reply says so instead of failing silently.
  • actor.merge_static_meshes writes an asset and runs a full bake; it is Risk 3 and can take a while on large selections.
  • actor.snapshot_transforms lives in memory for the editor session only and is not part of the undo buffer — it is meant for quick experiments you want to roll back without an undo.
  • Traces use the physics world of the editor level, so actors with no collision are invisible to line_trace, sweep_box and snap_to_floor.
  • actor.move_to_camera, actor.frame_selected and actor.raycast_from_camera need an interactive level viewport and fail with E_EDITOR_STATE in a headless editor.

Ferramentas​

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

actor.add_component (risco 2, altera, requer mundo, smoke)​

Adds an instance component to a level actor and attaches it to the root or to another component.

ArgumentoTipoDescrição
actorstringobrigatório.
classstringobrigatório. Component class ("StaticMeshComponent", "PointLightComponent", ...).
namestringName for the new component; a unique one is generated when empty.
parentstringExisting scene component to attach to; empty attaches to the root.
socketstringSocket on the parent component.
location{x,y,z}
rotation{x,y,z}
scale{x,y,z}
propertiesarray of UeaKeyValue

Retorna: component, properties, message.

actor.add_instances (risco 2, altera, requer mundo, smoke)​

Adds instances to an instanced static mesh actor.

ArgumentoTipoDescrição
actorstringobrigatório.
transformsarray of UeaActTransformSpecobrigatório.
worldSpacebooleanTreat the transforms as world-space (default) instead of component-relative. Padrão true.

Retorna: instances, count, total, mesh, message.

actor.add_tag (risco 2, altera, requer mundo, smoke)​

Adds a tag to one or more actors.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
tagstringobrigatório.

Retorna: actors, count, total, message.

actor.add_to_group (risco 2, altera, requer mundo, smoke)​

Adds actors to an existing group.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
groupstringobrigatório. Group actor label or name.

Retorna: group, message.

actor.align_to_actor (risco 2, altera, requer mundo, smoke)​

Copies location, rotation and/or scale of a target actor onto other actors.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
targetstringobrigatório. Actor whose transform is copied.
locationbooleanPadrão true.
rotationbooleanPadrão false.
scalebooleanPadrão false.

Retorna: actors, count, total, message.

actor.align_to_grid (risco 2, altera, requer mundo, smoke)​

Rounds the location of actors to a grid step.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
gridSizenumberGrid step in centimetres. Padrão 10.0.

Retorna: actors, count, total, message.

actor.apply_material_many (risco 2, altera, requer mundo, dryRun, smoke)​

Applies one material to many actors, on one slot or on every slot.

ArgumentoTipoDescrição
actorsarray of stringExplicit actor list; when empty the class/name/tag/folder filter is used.
materialstringobrigatório.
slotintegerMaterial slot; -1 applies to every slot. Padrão -1.
dryRunbooleanPadrão false.

Retorna: message, count, items.

actor.arrange_line (risco 2, altera, requer mundo, smoke)​

Places actors evenly on the segment between two world points.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
start{x,y,z}obrigatório.
end{x,y,z}obrigatório.

Retorna: actors, count, total, message.

actor.attach (risco 2, altera, requer mundo, smoke)​

Attaches an actor to a parent actor, optionally at a socket, with a keepWorld/keepRelative/snapToTarget rule.

ArgumentoTipoDescrição
actorstringobrigatório.
parentstringobrigatório.
socketstringSocket on the parent's root component.
rulestringkeepWorld (default), keepRelative or snapToTarget.

Retorna: actor, message.

actor.attach_component (risco 2, altera, requer mundo, smoke)​

Attaches a scene component to another component of the same actor, optionally at a socket.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
parentstringobrigatório. Scene component of the same actor to attach to.
socketstring
rulestringkeepWorld (default), keepRelative or snapToTarget.

Retorna: component, properties, message.

actor.attach_many (risco 2, altera, requer mundo, smoke)​

Attaches several actors to the same parent.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
parentstringobrigatório.
socketstring
rulestring

Retorna: actors, count, total, message.

actor.call_function (risco 3, altera, requer mundo, smoke)​

Calls a UFUNCTION on an actor of the editor world and returns its output parameters.

ArgumentoTipoDescrição
actorstringobrigatório.
functionstringobrigatório. UFUNCTION name on the actor.
argsarray of stringArguments in declaration order, in Unreal text form.

Retorna: values, count, message.

actor.clear_instances (risco 3, altera, destrutivo, requer mundo, smoke)​

Removes every instance of an instanced static mesh actor.

ArgumentoTipoDescrição
actorstringobrigatório. Actor label, object name, unique class name or unique name prefix.

Retorna: instances, count, total, mesh, message.

actor.convert_to_blueprint (risco 3, altera, requer mundo, smoke)​

Creates a Blueprint asset from one actor, or harvests the components of several actors into one Blueprint.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
folderstringobrigatório. Content folder for the new Blueprint asset.
namestringobrigatório.
replaceInLevelbooleanReplace the source actors with an instance of the new Blueprint. Padrão false.
harvestbooleanHarvest the components of every actor into a single Blueprint. Padrão false.

Retorna: value, number, result, message.

actor.copy_components (risco 2, altera, requer mundo, smoke)​

Copies instance components from one actor to another with the editor's component clipboard.

ArgumentoTipoDescrição
fromstringobrigatório. Actor to copy components from.
tostringobrigatório. Actor to paste them onto.
componentsarray of stringComponent names to copy; empty copies every non-native scene component.

Retorna: components, count, message.

actor.copy_to_clipboard (risco 1, requer mundo, smoke)​

Copies actors to the editor clipboard and returns the T3D text so it can be pasted later.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.

Retorna: value, number, result, message.

actor.count_by_class (risco 0, requer mundo, smoke)​

Actor count per class in the level or in one outliner folder, highest first.

ArgumentoTipoDescrição
folderstringOutliner folder path; empty means the whole level.

Retorna: values, count, message.

actor.create_folder (risco 1, altera, requer mundo, smoke)​

Creates an outliner folder (and its missing parents).

ArgumentoTipoDescrição
pathstringobrigatório. Outliner folder path, e.g. "Props/Crates".

Retorna: folders, count, message.

actor.create_instanced_mesh (risco 2, altera, requer mundo, smoke)​

Spawns an actor carrying an (optionally hierarchical) instanced static mesh component.

ArgumentoTipoDescrição
meshstringobrigatório.
namestring
hierarchicalbooleanUse a HierarchicalInstancedStaticMeshComponent (LOD support) instead of a plain ISM. Padrão false.
location{x,y,z}
folderstring

Retorna: actor, message.

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

Deletes one actor from the level.

ArgumentoTipoDescrição
actorstringobrigatório. Actor label, object name, unique class name or unique name prefix.

Retorna: message, count, items.

actor.delete_by_filter (risco 5, altera, destrutivo, requer mundo, dryRun, smoke)​

Deletes every actor matching a class/name/tag/folder filter. Use dryRun first: this can empty a level.

ArgumentoTipoDescrição
dryRunbooleanOnly report what would be deleted. Padrão false.

Retorna: message, count, items.

actor.delete_folder (risco 2, altera, destrutivo, requer mundo, smoke)​

Deletes an outliner folder, moving its actors to the parent folder or to the root.

ArgumentoTipoDescrição
pathstringobrigatório.
moveActorsToParentbooleanMove the actors of the folder to its parent instead of to the root. Padrão true.

Retorna: message, count, items.

actor.delete_many (risco 3, altera, destrutivo, requer mundo, smoke)​

Deletes several actors in one transaction.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.

Retorna: message, count, items.

actor.deselect (risco 1, requer mundo, smoke)​

Removes actors from the editor selection.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
addbooleanAdd to the current selection instead of replacing it. Padrão false.
selectHiddenbooleanAllow selecting hidden actors. Padrão true.

Retorna: actors, components, count, message.

actor.detach (risco 2, altera, requer mundo, smoke)​

Detaches actors from their parent, keeping their world transform by default.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
keepWorldbooleanKeep the current world transform after detaching. Padrão true.

Retorna: actors, count, total, message.

actor.detach_component (risco 2, altera, requer mundo, smoke)​

Re-parents a scene component to the actor's root, keeping its world transform. A non-root scene component can never be parentless, so detaching one that already sits under the root is a no-op.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.

Retorna: component, properties, message.

actor.distribute (risco 2, altera, requer mundo, smoke)​

Spaces actors evenly along an axis, either with a fixed spacing or between the current extremes.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
axisstringobrigatório. "x", "y" or "z".
spacingnumberFixed distance between neighbours; 0 spreads them evenly between the outermost two. Padrão 0.0.
betweenbooleanSpread evenly between the current extremes (ignores spacing). Padrão false.

Retorna: actors, count, total, message.

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

Duplicates an actor one or more times with a cumulative offset.

ArgumentoTipoDescrição
actorstringobrigatório.
offset{x,y,z}World offset applied to each copy (cumulative when count > 1).
namestringLabel of the copy; only used when count is 1.
countintegerHow many copies to make. Padrão 1.

Retorna: actors, count, total, message.

actor.duplicate_many (risco 2, altera, requer mundo, smoke)​

Duplicates several actors at once with a shared offset.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
offset{x,y,z}

Retorna: actors, count, total, message.

actor.exists (risco 0, requer mundo, smoke)​

Whether an actor reference resolves to exactly one actor of the editor world.

ArgumentoTipoDescrição
actorstringobrigatório. Actor label, object name, unique class name or unique name prefix.

Retorna: value, number, result, message.

actor.export (risco 0, requer mundo, smoke)​

Exports actors as JSON (class, label, folder, tags, transform, mesh/materials and chosen properties).

ArgumentoTipoDescrição
actorsarray of stringActors to export; empty exports the whole level.
propertiesarray of stringExtra property paths to record for every actor.
prettybooleanPretty-print the JSON. Padrão false.

Retorna: json, count, message.

actor.export_folder (risco 0, requer mundo, smoke)​

Exports every actor of an outliner folder as JSON.

ArgumentoTipoDescrição
folderstringobrigatório.
propertiesarray of string
prettybooleanPadrão false.

Retorna: json, count, message.

actor.find_at_origin (risco 0, requer mundo, smoke)​

Actors sitting at (or very near) the world origin, a common sign of a forgotten placement.

ArgumentoTipoDescrição
tolerancenumberDistance from the world origin below which an actor counts as "at origin". Padrão 1.0.
classFilterstring

Retorna: actors, count, total, message.

actor.find_by_class (risco 0, requer mundo, smoke)​

Every actor of a class (subclasses included by default).

ArgumentoTipoDescrição
classstringobrigatório. Class name, class path or Blueprint asset path.
includeSubclassesbooleanAlso match subclasses. Padrão true.

Retorna: actors, count, total, message.

actor.find_by_label (risco 0, requer mundo, smoke)​

Every actor whose label matches a wildcard pattern ("Smoke_*").

ArgumentoTipoDescrição
patternstringobrigatório. Label pattern; supports the wildcards * and ? (e.g. "Smoke_*").

Retorna: actors, count, total, message.

actor.find_by_tag (risco 0, requer mundo, smoke)​

Every actor carrying the given tag.

ArgumentoTipoDescrição
tagstringobrigatório.

Retorna: actors, count, total, message.

actor.find_duplicates (risco 0, requer mundo, smoke)​

Actors that share class, mesh and transform with another actor.

ArgumentoTipoDescrição
tolerancenumberDistance below which two locations count as identical, in centimetres. Padrão 1.0.
folderstring

Retorna: actors, count, total, message.

actor.find_in_box (risco 0, requer mundo, smoke)​

Actors whose origin lies inside an axis-aligned box.

ArgumentoTipoDescrição
min{x,y,z}obrigatório. Minimum corner of the world-space box.
max{x,y,z}obrigatório. Maximum corner of the world-space box.
classFilterstringOptional class name/substring filter.

Retorna: actors, count, total, message.

actor.find_in_radius (risco 0, requer mundo, smoke)​

Actors whose origin lies inside a sphere.

ArgumentoTipoDescrição
center{x,y,z}obrigatório. World-space centre of the sphere.
radiusnumberobrigatório. Radius in centimetres.
classFilterstringOptional class name/substring filter.

Retorna: actors, count, total, message.

actor.find_missing_assets (risco 0, requer mundo, smoke)​

Actors whose mesh or material references are null.

ArgumentoTipoDescrição
folderstringOutliner folder path; empty means the whole level.

Retorna: issues, errors, warnings, checked, message.

actor.find_outside_bounds (risco 0, requer mundo, smoke)​

Actors whose origin lies outside a world-space box.

ArgumentoTipoDescrição
min{x,y,z}obrigatório. Minimum corner of the world-space box.
max{x,y,z}obrigatório. Maximum corner of the world-space box.
classFilterstringOptional class name/substring filter.

Retorna: actors, count, total, message.

actor.find_overlapping (risco 0, requer mundo, smoke)​

Pairs of actors whose bounding-box centres are closer than a threshold.

ArgumentoTipoDescrição
classFilterstring
thresholdnumberMaximum distance between bounding-box centres to count as overlapping, in centimetres. Padrão 10.0.
limitintegerPadrão 100.

Retorna: actors, count, total, message.

actor.find_unlabeled (risco 0, requer mundo, smoke)​

Actors that still carry an auto-generated label (class name plus a number).

ArgumentoTipoDescrição
folderstringOutliner folder path; empty means the whole level.

Retorna: actors, count, total, message.

actor.focus_camera (risco 1, requer mundo, smoke)​

Moves the level viewport cameras so the given actors fill the view.

ArgumentoTipoDescrição
actorsarray of stringActors to act on; empty = the current selection.

Retorna: message, count, items.

actor.frame_selected (risco 1, requer mundo)​

Frames the current selection in the level viewport. Not smoke-tested: it needs an interactive level viewport.

Sem argumentos.

Retorna: message, count, items.

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

Full description of one actor, optionally with its components and property values.

ArgumentoTipoDescrição
actorstringobrigatório.
includeComponentsbooleanAlso list the actor's components. Padrão false.
includePropertiesbooleanAlso list the actor's editable properties and their current values. Padrão false.

Retorna: actor, components, properties, message.

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

Combined bounding box of a set of actors, plus the box of each one.

ArgumentoTipoDescrição
actorsarray of stringActors to measure; empty = every actor of the level.
onlyCollidingbooleanOnly take colliding components into account. Padrão false.

Retorna: min, max, center, extent, actors, count, message.

actor.get_by_guid (risco 0, requer mundo)​

Finds an actor by its persistent GUID. Not smoke-tested: it needs a GUID obtained from actor.get_guid first.

ArgumentoTipoDescrição
guidstringobrigatório.

Retorna: actor, message.

actor.get_children (risco 0, requer mundo, smoke)​

The actors attached to an actor, optionally recursively.

ArgumentoTipoDescrição
actorstringobrigatório.
recursivebooleanInclude grandchildren. Padrão false.

Retorna: actors, count, total, message.

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

Details of one component, optionally with its property values.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
includePropertiesbooleanPadrão false.

Retorna: component, properties, message.

actor.get_component_bounds (risco 0, requer mundo, smoke)​

World bounding box of one component.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringComponent name; empty uses the root component.

Retorna: min, max, center, extent, actors, count, message.

actor.get_component_materials (risco 0, requer mundo, smoke)​

Lists the material slots of a mesh component and the material currently used by each one.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringComponent name; empty uses the root component.

Retorna: values, count, message.

actor.get_component_property (risco 0, requer mundo, smoke)​

Reads one property of a component.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
propertystringobrigatório.

Retorna: value, number, result, message.

actor.get_distance (risco 0, requer mundo, smoke)​

Distance in centimetres between the origins of two actors.

ArgumentoTipoDescrição
astringobrigatório.
bstringobrigatório.

Retorna: value, number, result, message.

actor.get_folder_actors (risco 0, requer mundo, smoke)​

The actors of an outliner folder, optionally including subfolders.

ArgumentoTipoDescrição
pathstringobrigatório.
recursivebooleanInclude the actors of subfolders. Padrão true.

Retorna: actors, count, total, message.

actor.get_group (risco 0, requer mundo, smoke)​

The group an actor belongs to, with its members.

ArgumentoTipoDescrição
groupstringobrigatório. Group actor label/name, or any actor belonging to the group.

Retorna: group, message.

actor.get_guid (risco 0, requer mundo, smoke)​

Persistent GUID of an actor.

ArgumentoTipoDescrição
actorstringobrigatório. Actor label, object name, unique class name or unique name prefix.

Retorna: value, number, result, message.

actor.get_instances (risco 0, requer mundo, smoke)​

Lists the instances of an instanced static mesh actor with their transforms.

ArgumentoTipoDescrição
actorstringobrigatório.
limitintegerPadrão 100.
offsetintegerPadrão 0.

Retorna: instances, count, total, mesh, message.

actor.get_nearest (risco 0, requer mundo, smoke)​

The N actors nearest to an actor or to a world point, sorted by distance.

ArgumentoTipoDescrição
tostringReference actor; when empty the point in "point" is used.
point{x,y,z}Reference point used when "to" is empty.
classFilterstringOptional class name/substring filter.
countintegerHow many nearest actors to return. Padrão 1.

Retorna: actors, count, total, message.

actor.get_outliner_path (risco 0, requer mundo, smoke)​

Outliner path of an actor ("Folder/Sub/Label").

ArgumentoTipoDescrição
actorstringobrigatório. Actor label, object name, unique class name or unique name prefix.

Retorna: value, number, result, message.

actor.get_outliner_tree (risco 0, requer mundo, smoke)​

The outliner as a folder tree with the actors of each folder.

ArgumentoTipoDescrição
folderstringRoot folder; empty starts at the outliner root.
depthintegerMaximum folder depth (0 = unlimited). Padrão 0.
limitintegerMaximum actors listed per folder. Padrão 50.

Retorna: json, count, message.

actor.get_parent (risco 0, requer mundo, smoke)​

The attach parent of an actor, if any.

ArgumentoTipoDescrição
actorstringobrigatório. Actor label, object name, unique class name or unique name prefix.

Retorna: actor, message.

actor.get_properties (risco 0, requer mundo, smoke)​

Reads several properties of an actor at once.

ArgumentoTipoDescrição
actorstringobrigatório.
propertiesarray of stringProperty paths to read.

Retorna: values, count, message.

actor.get_property (risco 0, requer mundo, smoke)​

Reads one property of an actor or of one of its components ("Component.Prop").

ArgumentoTipoDescrição
actorstringobrigatório.
propertystringobrigatório. Property path: "Prop", "Struct.Prop", "ComponentName.Prop", arrays with "Prop[0]".

Retorna: value, number, result, message.

actor.get_relative_transform (risco 0, requer mundo, smoke)​

Transform of one actor expressed in the space of another.

ArgumentoTipoDescrição
actorstringobrigatório.
tostringobrigatório. Actor the transform is expressed relative to.

Retorna: location, rotation, scale, actor, message.

actor.get_root_component (risco 0, requer mundo, smoke)​

The root component of an actor.

ArgumentoTipoDescrição
actorstringobrigatório. Actor label, object name, unique class name or unique name prefix.

Retorna: component, properties, message.

actor.get_selected (risco 0, requer mundo, smoke)​

The currently selected actors, optionally with their components.

ArgumentoTipoDescrição
includeComponentsbooleanAlso list the components of the selected actors. Padrão false.

Retorna: actors, components, count, message.

actor.get_selected_components (risco 0, requer mundo, smoke)​

The components currently selected in the editor.

Sem argumentos.

Retorna: actors, components, count, message.

actor.get_skeletal_info (risco 0, requer mundo)​

Mesh, skeleton, bone count, morph targets and physics asset of a skeletal mesh actor. Not smoke-tested: it needs a skeletal mesh fixture.

ArgumentoTipoDescrição
actorstringobrigatório. Actor label, object name, unique class name or unique name prefix.

Retorna: mesh, skeleton, bones, morphTargets, physicsAsset, animBlueprint, materials, message.

actor.get_socket_transform (risco 0, requer mundo, smoke)​

World transform of one socket of an actor.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstring
socketstringobrigatório.

Retorna: location, rotation, scale, actor, message.

actor.get_static_mesh_info (risco 0, requer mundo, smoke)​

Mesh, materials, LOD count, triangle/vertex count, collision and lightmap resolution of a static mesh actor.

ArgumentoTipoDescrição
actorstringobrigatório. Actor label, object name, unique class name or unique name prefix.

Retorna: mesh, materials, lods, triangles, vertices, collision, lightmapResolution, boundsMin, boundsMax, message.

actor.get_stats (risco 0, requer mundo, smoke)​

Level statistics: actors per class, mesh actors, estimated triangles, lights, hidden actors, missing assets.

ArgumentoTipoDescrição
folderstringOutliner folder path; empty means the whole level.

Retorna: totalActors, meshActors, lights, hidden, missingAssets, triangles, byClass, message.

actor.get_transform (risco 0, requer mundo, smoke)​

World and relative transform of an actor plus its bounding box.

ArgumentoTipoDescrição
actorstringobrigatório. Actor label, object name, unique class name or unique name prefix.

Retorna: location, rotation, scale, actor, message.

actor.group (risco 2, altera, requer mundo, smoke)​

Groups actors into a new AGroupActor so the editor moves them together.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
namestringLabel for the new group actor.

Retorna: group, message.

actor.has_tag (risco 0, requer mundo, smoke)​

Whether an actor carries a tag.

ArgumentoTipoDescrição
actorstringobrigatório.
tagstringobrigatório.

Retorna: value, number, result, message.

actor.import (risco 2, altera, requer mundo)​

Spawns actors from JSON produced by actor.export, with an optional offset and folder override. Not smoke-tested: the JSON argument cannot be written in UHT metadata, which cannot carry double quotes.

ArgumentoTipoDescrição
jsonstringobrigatório. JSON produced by actor.export.
offset{x,y,z}World offset added to every imported actor.
folderstringOverride the outliner folder of every imported actor.

Retorna: actors, count, total, message.

actor.instances_from_actors (risco 2, altera, requer mundo, smoke)​

Converts static mesh actors that share one mesh into a single instanced static mesh actor.

ArgumentoTipoDescrição
actorsarray of stringobrigatório. Static mesh actors sharing one mesh.
deleteSourcebooleanDelete the source actors after the conversion. Padrão true.
namestring
hierarchicalbooleanPadrão false.
folderstring

Retorna: actor, message.

actor.instances_to_actors (risco 2, altera, requer mundo, smoke)​

Explodes an instanced static mesh actor back into one static mesh actor per instance.

ArgumentoTipoDescrição
actorstringobrigatório. Actor carrying an instanced static mesh component.
deleteSourcebooleanDelete the instanced actor afterwards. Padrão false.
namePrefixstring
folderstring

Retorna: actors, count, total, message.

actor.invert_selection (risco 1, requer mundo, smoke)​

Inverts the editor selection.

Sem argumentos.

Retorna: actors, components, count, message.

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

Line trace against the editor world; returns the hit actor, component, location and normal.

ArgumentoTipoDescrição
start{x,y,z}obrigatório.
end{x,y,z}obrigatório.
channelstringTrace channel: Visibility (default), Camera, WorldStatic, WorldDynamic, Pawn, PhysicsBody.
ignorearray of stringActors to ignore.
multibooleanReturn every hit instead of the first one. Padrão false.

Retorna: hit, hits, count, message.

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

Lists the actors of the editor world with optional class/name/tag/folder/sublevel filters and paging.

ArgumentoTipoDescrição
sublevelstringOnly actors of this sublevel (level object name).
hiddenOnlybooleanOnly actors currently hidden in the editor. Padrão false.
limitintegerMaximum actors returned (default 100, 0 = no limit). Padrão 100.
offsetintegerIndex of the first actor returned. Padrão 0.
includeBoundsbooleanAlso compute and return the bounding box of every actor (slower). Padrão false.

Retorna: actors, count, total, message.

actor.list_component_properties (risco 0, requer mundo, smoke)​

Lists the editable properties of a component with their types and (optionally) values.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
nameContainsstring
includeValuesbooleanPadrão true.
limitintegerPadrão 200.

Retorna: values, count, message.

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

Lists the components of an actor with class, parent, relative transform, mobility and creation method.

ArgumentoTipoDescrição
actorstringobrigatório.
sceneOnlybooleanOnly components deriving from USceneComponent. Padrão false.

Retorna: components, count, message.

actor.list_folders (risco 0, requer mundo, smoke)​

The outliner folder tree of the level with per-folder actor counts.

Sem argumentos.

Retorna: folders, count, message.

actor.list_groups (risco 0, requer mundo, smoke)​

Every actor group of the level with its members.

Sem argumentos.

Retorna: groups, count, groupingActive, message.

actor.list_material_slots (risco 0, requer mundo, smoke)​

Lists the material slots of a mesh actor and the material used by each one.

ArgumentoTipoDescrição
actorstringobrigatório. Actor label, object name, unique class name or unique name prefix.

Retorna: values, count, message.

actor.list_properties (risco 0, requer mundo, smoke)​

Lists the editable properties of an actor with their types and (optionally) values.

ArgumentoTipoDescrição
actorstringobrigatório.
nameContainsstringOnly properties whose name contains this substring.
includeValuesbooleanInclude the values as well as the names/types. Padrão true.
limitintegerMaximum properties returned (0 = all). Padrão 200.

Retorna: values, count, message.

actor.list_sockets (risco 0, requer mundo, smoke)​

Lists the sockets of an actor's components (or of one component).

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringComponent name; empty uses the root component.

Retorna: values, count, message.

actor.list_tags (risco 0, requer mundo, smoke)​

Every tag used in the level with the number of actors carrying it.

Sem argumentos.

Retorna: values, count, message.

actor.lock_group (risco 1, altera, requer mundo, smoke)​

Locks a group so its members are selected together.

ArgumentoTipoDescrição
groupstringobrigatório. Group actor label/name, or any actor belonging to the group.

Retorna: group, message.

actor.look_at (risco 2, altera, requer mundo, smoke)​

Rotates an actor so that one of its local axes points at a target actor or point.

ArgumentoTipoDescrição
actorstringobrigatório.
targetstringTarget actor; when empty the point in "point" is used.
point{x,y,z}
axisstringWhich local axis points at the target: "x" (default), "y", "z", "-x", "-y" or "-z".
keepPitchbooleanKeep the current pitch (rotate around yaw only). Padrão false.

Retorna: location, rotation, scale, actor, message.

actor.match_transform (risco 2, altera, requer mundo, smoke)​

Copies the whole world transform of one actor onto another.

ArgumentoTipoDescrição
actorstringobrigatório.
sourcestringobrigatório. Actor whose full transform is copied.

Retorna: location, rotation, scale, actor, message.

actor.merge_static_meshes (risco 3, altera, requer mundo)​

Merges the static meshes of several actors into one StaticMesh asset. Not smoke-tested: mesh merging writes assets and runs a long bake.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
folderstringobrigatório. Content folder for the merged static mesh.
namestringobrigatório.
replaceSourcebooleanDelete the source actors and spawn one actor with the merged mesh. Padrão false.
mergeMaterialsbooleanBake the materials into a single atlas material. Padrão false.
pivotAtOriginbooleanPut the merged mesh pivot at the world origin instead of the bounds centre. Padrão false.

Retorna: value, number, result, message.

actor.mirror (risco 2, altera, requer mundo, smoke)​

Mirrors actors across a world plane (their location and the matching scale component are negated).

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
axisstringobrigatório. Mirror plane normal: "x", "y" or "z".
origin{x,y,z}Point the mirror plane passes through.

Retorna: actors, count, total, message.

actor.move_by (risco 2, altera, requer mundo, smoke)​

Translates actors by a delta (world or local space); empty actors uses the selection.

ArgumentoTipoDescrição
actorsarray of stringActors to move; empty = the current selection.
delta{x,y,z}obrigatório. The delta: offset in centimetres, rotation in degrees or scale multiplier depending on the tool.
spacestring"world" (default) or "local".

Retorna: actors, count, total, message.

actor.move_folder (risco 1, altera, requer mundo, smoke)​

Reparents an outliner folder under another folder.

ArgumentoTipoDescrição
pathstringobrigatório.
newParentstringNew parent folder; empty moves the folder to the root.

Retorna: folders, count, message.

actor.move_to_camera (risco 2, altera, requer mundo)​

Moves actors in front of the active level viewport camera. Not smoke-tested: it needs an interactive level viewport.

ArgumentoTipoDescrição
actorsarray of stringActors to act on; empty = the current selection.

Retorna: actors, count, total, message.

actor.overlap_box (risco 0, requer mundo, smoke)​

Actors overlapping a world-space box.

ArgumentoTipoDescrição
center{x,y,z}obrigatório.
extent{x,y,z}obrigatório. Half-extent of the box in centimetres.
channelstring

Retorna: actors, count, total, message.

actor.overlap_sphere (risco 0, requer mundo, smoke)​

Actors overlapping a world-space sphere.

ArgumentoTipoDescrição
center{x,y,z}obrigatório.
radiusnumberobrigatório.
channelstring

Retorna: actors, count, total, message.

actor.paste_from_clipboard (risco 2, altera, requer mundo)​

Pastes actors from T3D text or from the system clipboard. Not smoke-tested: it depends on clipboard state the run does not own.

ArgumentoTipoDescrição
textstringActor text produced by actor.copy_to_clipboard; empty pastes the system clipboard.
offsetbooleanOffset the pasted actors. Padrão false.

Retorna: actors, count, total, message.

actor.place_on_surface (risco 2, altera, requer mundo, smoke)​

Traces from a point in a direction and places an actor at the hit location.

ArgumentoTipoDescrição
actorstringobrigatório.
from{x,y,z}obrigatório. World point the trace starts from.
direction{x,y,z}Trace direction; (0,0,0) means straight down.
maxDistancenumberTrace length in centimetres. Padrão 100000.0.
alignbooleanAlign the actor to the hit normal. Padrão false.

Retorna: location, rotation, scale, actor, message.

actor.randomize_transform (risco 2, altera, requer mundo, smoke)​

Adds bounded random rotation, scale and displacement to actors from a seed.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
rotationRange{x,y,z}Maximum random rotation per axis in degrees (x=pitch, y=yaw, z=roll).
scaleRange{x,y,z}Uniform scale range as (min, max, unused); (0,0,0) leaves the scale alone.
locationJitter{x,y,z}Maximum random displacement per axis in centimetres.
seedintegerPadrão 0.

Retorna: actors, count, total, message.

actor.raycast_from_camera (risco 0, requer mundo)​

Traces forward from the active level viewport camera. Not smoke-tested: it needs an interactive level viewport.

ArgumentoTipoDescrição
maxDistancenumberTrace length in centimetres. Padrão 100000.0.
channelstring

Retorna: hit, hits, count, message.

actor.relabel_by_class (risco 2, altera, requer mundo, dryRun, smoke)​

Gives every actor of a folder a unique label derived from its class.

ArgumentoTipoDescrição
folderstring
dryRunbooleanPadrão false.

Retorna: message, count, items.

actor.remove_component (risco 3, altera, destrutivo, requer mundo, smoke)​

Removes an instance component from a level actor; its children are re-parented first. Native, Blueprint and root components cannot be removed.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.

Retorna: message, count, items.

actor.remove_from_group (risco 2, altera, requer mundo, smoke)​

Removes actors from a group.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
groupstringobrigatório. Group actor label or name.

Retorna: group, message.

actor.remove_instances (risco 3, altera, destrutivo, requer mundo, smoke)​

Removes instances by index.

ArgumentoTipoDescrição
actorstringobrigatório.
indicesarray of integerobrigatório.

Retorna: instances, count, total, mesh, message.

actor.remove_tag (risco 2, altera, requer mundo, smoke)​

Removes a tag from one or more actors.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
tagstringobrigatório.

Retorna: actors, count, total, message.

actor.rename_component (risco 2, altera, requer mundo, smoke)​

Renames an instance component.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
newNamestringobrigatório.

Retorna: component, properties, message.

actor.rename_folder (risco 1, altera, requer mundo, smoke)​

Renames or moves an outliner folder and every actor inside it.

ArgumentoTipoDescrição
pathstringobrigatório.
newPathstringobrigatório.

Retorna: folders, count, message.

actor.rename_many (risco 2, altera, requer mundo, smoke)​

Relabels several actors from a pattern using {base}, {n} and {class}.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
patternstringobrigatório. Label pattern; {base} = current label, {n} = index, {class} = class name.
startintegerFirst value of {n}. Padrão 1.

Retorna: actors, count, total, message.

actor.replace_mesh_many (risco 2, altera, requer mundo, dryRun, smoke)​

Swaps one static mesh for another on every matching actor of the level (or of a folder).

ArgumentoTipoDescrição
fromstringobrigatório. StaticMesh currently used.
tostringobrigatório. StaticMesh to switch to.
folderstringRestrict to this outliner folder.
dryRunbooleanPadrão false.

Retorna: message, count, items.

actor.replace_with (risco 3, altera, destrutivo, requer mundo, smoke)​

Replaces actors with instances of another class or Blueprint, keeping their transform and label.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
classstringTarget class name or path.
blueprintstringTarget Blueprint asset path (alternative to class).
keepTransformbooleanPadrão true.
keepLabelbooleanPadrão true.

Retorna: actors, count, total, message.

actor.reset_property (risco 2, altera, requer mundo, smoke)​

Resets one property of an actor to its class default value.

ArgumentoTipoDescrição
actorstringobrigatório.
propertystringobrigatório. Property path: "Prop", "Struct.Prop", "ComponentName.Prop", arrays with "Prop[0]".

Retorna: value, number, result, message.

actor.restore_transforms (risco 2, altera, requer mundo, smoke)​

Restores the transforms recorded by actor.snapshot_transforms.

ArgumentoTipoDescrição
namestringobrigatório.
removebooleanForget the snapshot after restoring it. Padrão false.

Retorna: actors, count, total, message.

actor.rotate_by (risco 2, altera, requer mundo, smoke)​

Rotates actors by a delta in degrees (world or local space).

ArgumentoTipoDescrição
actorsarray of stringActors to move; empty = the current selection.
delta{x,y,z}obrigatório. The delta: offset in centimetres, rotation in degrees or scale multiplier depending on the tool.
spacestring"world" (default) or "local".

Retorna: actors, count, total, message.

actor.scale_by (risco 2, altera, requer mundo, smoke)​

Multiplies the scale of actors component-wise.

ArgumentoTipoDescrição
actorsarray of stringActors to move; empty = the current selection.
delta{x,y,z}obrigatório. The delta: offset in centimetres, rotation in degrees or scale multiplier depending on the tool.
spacestring"world" (default) or "local".

Retorna: actors, count, total, message.

actor.select (risco 1, requer mundo, smoke)​

Selects actors in the editor, replacing or extending the current selection.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
addbooleanAdd to the current selection instead of replacing it. Padrão false.
selectHiddenbooleanAllow selecting hidden actors. Padrão true.

Retorna: actors, components, count, message.

actor.select_by_filter (risco 1, requer mundo, smoke)​

Selects every actor matching a class/name/tag/folder filter.

ArgumentoTipoDescrição
addbooleanPadrão false.

Retorna: actors, components, count, message.

actor.select_children (risco 1, requer mundo, smoke)​

Selects the actors attached to the given actors (or to the current selection).

ArgumentoTipoDescrição
actorsarray of stringParent actors; empty uses the current selection.
recursivebooleanPadrão false.
addbooleanPadrão false.

Retorna: actors, components, count, message.

actor.select_component (risco 1, requer mundo, smoke)​

Selects one component of an actor (component selection mode).

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.

Retorna: actors, components, count, message.

actor.select_in_box (risco 1, requer mundo, smoke)​

Selects every actor whose origin lies inside a world-space box.

ArgumentoTipoDescrição
min{x,y,z}obrigatório.
max{x,y,z}obrigatório.
addbooleanPadrão false.

Retorna: actors, components, count, message.

actor.select_none (risco 1, requer mundo, smoke)​

Clears the editor selection.

Sem argumentos.

Retorna: actors, components, count, message.

actor.select_parent (risco 1, requer mundo, smoke)​

Selects the attach parents of the selected actors.

ArgumentoTipoDescrição
actorsarray of stringActors to act on; empty = the current selection.

Retorna: actors, components, count, message.

actor.select_similar (risco 1, requer mundo, smoke)​

Selects every actor of the same class as the given one.

ArgumentoTipoDescrição
actorstringobrigatório. Actor label, object name, unique class name or unique name prefix.

Retorna: actors, components, count, message.

actor.set_anim_blueprint (risco 2, altera, requer mundo)​

Assigns an Animation Blueprint to a skeletal mesh actor. Not smoke-tested: it needs a skeletal mesh fixture.

ArgumentoTipoDescrição
actorstringobrigatório.
animBlueprintstringobrigatório. Animation Blueprint asset path.

Retorna: actor, message.

actor.set_animation_asset (risco 2, altera, requer mundo)​

Plays an animation asset on a skeletal mesh actor at edit time. Not smoke-tested: it needs a skeletal mesh fixture.

ArgumentoTipoDescrição
actorstringobrigatório.
assetstringobrigatório. AnimSequence or other UAnimationAsset path.
loopbooleanPadrão true.
playingbooleanPadrão true.

Retorna: actor, message.

actor.set_camera (risco 2, altera, requer mundo, smoke)​

Sets field of view, aspect ratio, projection mode and post-process blend of a camera actor.

ArgumentoTipoDescrição
actorstringobrigatório.
fovnumberHorizontal field of view in degrees; 0 leaves it unchanged. Padrão 0.0.
aspectnumberPadrão 0.0.
constrainAspectbooleanPadrão false.
hasConstrainAspectbooleanPadrão false.
projectionModestringPerspective or Orthographic.
orthoWidthnumberWidth of the orthographic view in centimetres; 0 leaves it unchanged. Padrão 0.0.
postProcessBlendWeightnumber0..1; -1 leaves it unchanged. Padrão -1.0.

Retorna: actor, message.

actor.set_cast_shadow (risco 2, altera, requer mundo, smoke)​

Sets the shadow-casting flags of a mesh actor (any subset).

ArgumentoTipoDescrição
actorstringobrigatório.
castShadowbooleanPadrão true.
hasCastShadowbooleanPadrão false.
castDynamicbooleanPadrão true.
hasCastDynamicbooleanPadrão false.
castStaticbooleanPadrão true.
hasCastStaticbooleanPadrão false.
castHiddenShadowbooleanPadrão false.
hasCastHiddenShadowbooleanPadrão false.
castInsetShadowbooleanPadrão false.
hasCastInsetShadowbooleanPadrão false.

Retorna: values, count, message.

actor.set_cine_camera (risco 2, altera, requer mundo)​

Sets focal length, aperture, focus distance, sensor size and lens preset of a CineCameraActor. Not smoke-tested: the smoke fixture is a plain CameraActor.

ArgumentoTipoDescrição
actorstringobrigatório.
focalLengthnumberFocal length in millimetres; 0 leaves it unchanged. Padrão 0.0.
aperturenumberF-stop; 0 leaves it unchanged. Padrão 0.0.
focusDistancenumberManual focus distance in centimetres; 0 leaves it unchanged. Padrão 0.0.
sensorWidthnumberSensor width in millimetres; 0 leaves it unchanged. Padrão 0.0.
sensorHeightnumberPadrão 0.0.
lensPresetstringNamed lens preset from the project's cine camera settings.

Retorna: actor, message.

actor.set_collision_complexity (risco 2, altera, requer mundo, smoke)​

Sets how the collision of a static mesh actor is derived from the mesh (complex/simple).

ArgumentoTipoDescrição
actorstringobrigatório.
useComplexAsSimplebooleanUse the render mesh for collision. Padrão false.
useSimpleAsComplexbooleanUse the simple collision primitives for complex queries. Padrão false.

Retorna: actor, message.

actor.set_component_collision (risco 2, altera, requer mundo, smoke)​

Sets collision enablement, profile, object type and per-channel responses of a primitive component.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
enabledstringNoCollision, QueryOnly, PhysicsOnly or QueryAndPhysics.
profilestringCollision profile name ("BlockAll", "OverlapAll", ...).
objectTypestringObject type channel ("WorldStatic", "WorldDynamic", ...).
responsesarray of UeaActChannelResponse
generateOverlapEventsbooleanPadrão false.
hasGenerateOverlapEventsbooleanPadrão false.

Retorna: component, properties, message.

actor.set_component_hidden_in_game (risco 2, altera, requer mundo, smoke)​

Sets bHiddenInGame on a scene component.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
valuebooleanobrigatório.
propagatebooleanApply to child components as well. Padrão false.

Retorna: component, properties, message.

actor.set_component_material (risco 2, altera, requer mundo, smoke)​

Overrides the material of one slot of a mesh component.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
slotintegerMaterial slot index. Padrão 0.
materialstringMaterial asset path; empty clears the override.

Retorna: component, properties, message.

actor.set_component_mesh (risco 2, altera, requer mundo, smoke)​

Assigns a static or skeletal mesh asset to a mesh component.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
meshstringobrigatório. StaticMesh or SkeletalMesh asset path.

Retorna: component, properties, message.

actor.set_component_mobility (risco 2, altera, requer mundo, smoke)​

Sets the mobility of a scene component.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
mobilitystringobrigatório. Static, Stationary or Movable.

Retorna: component, properties, message.

actor.set_component_physics (risco 2, altera, requer mundo, smoke)​

Sets physics simulation, mass override, gravity and damping of a primitive component.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
simulatebooleanPadrão false.
hasSimulatebooleanPadrão false.
massnumberMass override in kilograms; 0 removes the override. Padrão 0.0.
gravitybooleanPadrão true.
hasGravitybooleanPadrão false.
linearDampingnumberPadrão -1.0.
angularDampingnumberPadrão -1.0.

Retorna: component, properties, message.

actor.set_component_properties (risco 2, altera, requer mundo, smoke)​

Writes several properties of a component in one transaction.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
propertiesarray of UeaKeyValueobrigatório.

Retorna: values, count, message.

actor.set_component_property (risco 2, altera, requer mundo, smoke)​

Writes one property of a component.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
propertystringobrigatório.
valuestringobrigatório.

Retorna: value, number, result, message.

actor.set_component_tags (risco 2, altera, requer mundo, smoke)​

Replaces the component tags of a component.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
tagsarray of string

Retorna: component, properties, message.

actor.set_component_tick (risco 2, altera, requer mundo, smoke)​

Enables or disables component ticking and sets the tick interval.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
enabledbooleanPadrão true.
intervalnumberSeconds between ticks; 0 = every frame. Padrão 0.0.

Retorna: component, properties, message.

actor.set_component_transform (risco 2, altera, requer mundo, smoke)​

Sets the relative (default) or world transform of a scene component.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
location{x,y,z}
hasLocationbooleanPadrão false.
rotation{x,y,z}
hasRotationbooleanPadrão false.
scale{x,y,z}
hasScalebooleanPadrão false.
worldbooleanInterpret the values as world-space instead of relative to the parent. Padrão false.

Retorna: location, rotation, scale, actor, message.

actor.set_component_visibility (risco 2, altera, requer mundo, smoke)​

Shows or hides a scene component in the editor, optionally propagating to its children.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório.
valuebooleanobrigatório.
propagatebooleanApply to child components as well. Padrão false.

Retorna: component, properties, message.

actor.set_decal (risco 2, altera, requer mundo, smoke)​

Sets the material, size, sort order and fade screen size of a DecalActor.

ArgumentoTipoDescrição
actorstringobrigatório.
materialstring
size{x,y,z}Decal box extent; (0,0,0) leaves it unchanged.
sortOrderintegerPadrão 0.
hasSortOrderbooleanPadrão false.
fadeScreenSizenumberPadrão -1.0.

Retorna: actor, message.

actor.set_flags (risco 2, altera, requer mundo, smoke)​

Sets any subset of the common actor flags (damage, replication, tick, life span, collision, relevancy).

ArgumentoTipoDescrição
actorstringobrigatório.
canBeDamagedbooleanSet only the flags you pass; the others are left alone (use the has* flags below). Padrão true.
hasCanBeDamagedbooleanPadrão false.
replicatesbooleanPadrão false.
hasReplicatesbooleanPadrão false.
netLoadOnClientbooleanPadrão true.
hasNetLoadOnClientbooleanPadrão false.
tickEnabledbooleanPadrão true.
hasTickEnabledbooleanPadrão false.
lifeSpannumberSeconds before the actor destroys itself in game; 0 = never. Padrão 0.0.
hasLifeSpanbooleanPadrão false.
netDormancystringNever, Awake, Initial, DormantAll or DormantPartial.
enableCollisionbooleanPadrão true.
hasEnableCollisionbooleanPadrão false.
alwaysRelevantbooleanPadrão false.
hasAlwaysRelevantbooleanPadrão false.
autoDestroyWhenFinishedbooleanPadrão false.
hasAutoDestroyWhenFinishedbooleanPadrão false.

Retorna: values, count, message.

actor.set_folder (risco 2, altera, requer mundo, smoke)​

Moves actors into an outliner folder (empty path = outliner root).

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
pathstringDestination folder; empty moves the actors to the outliner root.

Retorna: actors, count, total, message.

actor.set_folder_many (risco 2, altera, requer mundo, smoke)​

Moves every actor of a list or of a filter into an outliner folder.

ArgumentoTipoDescrição
actorsarray of string
pathstringDestination folder; empty moves to the outliner root.

Retorna: message, count, items.

actor.set_grouping_active (risco 1, requer mundo, smoke)​

Turns the editor's actor grouping mode on or off.

ArgumentoTipoDescrição
activebooleanobrigatório.

Retorna: groups, count, groupingActive, message.

actor.set_hidden (risco 2, altera, requer mundo, smoke)​

Hides or shows actors in the editor viewport and/or in game.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
hiddenbooleanobrigatório.
inEditorbooleanApply to the editor viewport (temporarily hidden). Padrão true.
inGamebooleanApply to the game (bHidden / SetActorHiddenInGame). Padrão false.

Retorna: actors, count, total, message.

actor.set_hidden_many (risco 2, altera, requer mundo, smoke)​

Hides or shows every actor of a list or of a filter.

ArgumentoTipoDescrição
actorsarray of string
hiddenbooleanobrigatório.
inEditorbooleanPadrão true.
inGamebooleanPadrão false.

Retorna: message, count, items.

actor.set_instance_transform (risco 2, altera, requer mundo, smoke)​

Sets the transform of one instance.

ArgumentoTipoDescrição
actorstringobrigatório.
indexintegerobrigatório.
location{x,y,z}
rotation{x,y,z}
scale{x,y,z}
worldSpacebooleanPadrão true.

Retorna: instances, count, total, mesh, message.

actor.set_label (risco 2, altera, requer mundo, smoke)​

Renames an actor's outliner label, optionally making it unique in the level.

ArgumentoTipoDescrição
actorstringobrigatório.
labelstringobrigatório.
uniquebooleanMake the label unique in the level by appending a number when needed. Padrão true.

Retorna: actor, message.

actor.set_lightmap_resolution (risco 2, altera, requer mundo, smoke)​

Overrides the lightmap resolution of a static mesh component.

ArgumentoTipoDescrição
actorstringobrigatório.
resolutionintegerobrigatório. Lightmap resolution in texels (power of two, e.g. 64).
overridebooleanEnable the per-component override. Padrão true.

Retorna: actor, message.

actor.set_location (risco 2, altera, requer mundo, smoke)​

Moves an actor to a world or local location.

ArgumentoTipoDescrição
actorstringobrigatório.
location{x,y,z}obrigatório.
spacestring"world" (default) or "local" (relative to the attach parent).
sweepbooleanSweep to the target location instead of teleporting. Padrão false.
teleportbooleanTeleport physics state instead of interpolating. Padrão true.

Retorna: location, rotation, scale, actor, message.

actor.set_lod (risco 2, altera, requer mundo, smoke)​

Forces an LOD level and/or a minimum LOD on a static mesh actor.

ArgumentoTipoDescrição
actorstringobrigatório.
forcedLodintegerForce this LOD index; -1 restores automatic LOD selection. Padrão -1.
minLodintegerLowest LOD the component may use; -1 removes the override. Padrão -1.

Retorna: actor, message.

actor.set_material_slot (risco 2, altera, requer mundo, smoke)​

Sets the material override of one slot of a mesh actor.

ArgumentoTipoDescrição
actorstringobrigatório.
slotintegerobrigatório.
materialstringMaterial asset path; empty clears the override.

Retorna: values, count, message.

actor.set_materials (risco 2, altera, requer mundo, smoke)​

Sets the material overrides of every slot of a mesh actor, in order.

ArgumentoTipoDescrição
actorstringobrigatório.
materialsarray of stringobrigatório. Material asset paths, one per slot in order; an empty entry leaves that slot unchanged.

Retorna: values, count, message.

actor.set_mesh_mobility (risco 2, altera, requer mundo, smoke)​

Sets the mobility of the mesh component of an actor.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
mobilitystringobrigatório. Static, Stationary or Movable.

Retorna: actors, count, total, message.

actor.set_mobility (risco 2, altera, requer mundo, smoke)​

Sets the mobility (Static/Stationary/Movable) of the root and primitive components of actors.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
mobilitystringobrigatório. Static, Stationary or Movable.

Retorna: actors, count, total, message.

actor.set_nanite (risco 2, altera, UE 5.2+, requer mundo, smoke)​

Enables or disables Nanite rendering for a static mesh component (bForceDisableNanite).

ArgumentoTipoDescrição
actorstringobrigatório.
enabledbooleanFalse sets bForceDisableNanite on the component. Padrão true.

Retorna: actor, message.

actor.set_pivot_offset (risco 2, altera, requer mundo, smoke)​

Sets the editor pivot offset of an actor.

ArgumentoTipoDescrição
actorstringobrigatório.
offset{x,y,z}obrigatório. Pivot offset in local space.

Retorna: location, rotation, scale, actor, message.

actor.set_properties (risco 2, altera, requer mundo, smoke)​

Writes several properties of an actor in one transaction.

ArgumentoTipoDescrição
actorstringobrigatório.
propertiesarray of UeaKeyValueobrigatório. Property path / value pairs.

Retorna: values, count, message.

actor.set_properties_many (risco 2, altera, requer mundo, dryRun, smoke)​

Writes several properties on every actor of a list or of a filter.

ArgumentoTipoDescrição
actorsarray of string
propertiesarray of UeaKeyValueobrigatório.
dryRunbooleanPadrão false.

Retorna: message, count, items.

actor.set_property (risco 2, altera, requer mundo, smoke)​

Writes one property of an actor or of one of its components.

ArgumentoTipoDescrição
actorstringobrigatório.
propertystringobrigatório.
valuestringobrigatório. Value in Unreal text form ("42", "true", "(X=1,Y=2,Z=3)", "/Game/Path/Asset.Asset").

Retorna: value, number, result, message.

actor.set_property_many (risco 2, altera, requer mundo, dryRun, smoke)​

Writes one property on every actor of a list or of a filter.

ArgumentoTipoDescrição
actorsarray of stringExplicit actor list; when empty the class/name/tag/folder filter is used.
propertystringobrigatório.
valuestringobrigatório.
dryRunbooleanPadrão false.

Retorna: message, count, items.

actor.set_render_settings (risco 2, altera, requer mundo, smoke)​

Sets visibility, main-pass/custom-depth rendering, cull distance and translucency sort priority.

ArgumentoTipoDescrição
actorstringobrigatório.
visiblebooleanPadrão true.
hasVisiblebooleanPadrão false.
renderInMainPassbooleanPadrão true.
hasRenderInMainPassbooleanPadrão false.
renderCustomDepthbooleanPadrão false.
hasRenderCustomDepthbooleanPadrão false.
customDepthStencilintegerPadrão -1.
cullDistancenumberMaximum draw distance in centimetres; -1 leaves it alone, 0 = unlimited. Padrão -1.0.
translucencySortPriorityintegerPadrão 0.
hasTranslucencySortPrioritybooleanPadrão false.

Retorna: values, count, message.

actor.set_root_component (risco 2, altera, requer mundo, smoke)​

Promotes an existing scene component of an actor to be its root component.

ArgumentoTipoDescrição
actorstringobrigatório.
componentstringobrigatório. Existing scene component of the actor to promote to root.

Retorna: component, properties, message.

actor.set_rotation (risco 2, altera, requer mundo, smoke)​

Sets the rotation of an actor (x=pitch, y=yaw, z=roll in degrees).

ArgumentoTipoDescrição
actorstringobrigatório.
rotation{x,y,z}obrigatório. x=pitch, y=yaw, z=roll in degrees.
spacestring
teleportbooleanPadrão true.

Retorna: location, rotation, scale, actor, message.

actor.set_scale (risco 2, altera, requer mundo, smoke)​

Sets the scale of an actor.

ArgumentoTipoDescrição
actorstringobrigatório.
scale{x,y,z}obrigatório.
spacestring

Retorna: location, rotation, scale, actor, message.

actor.set_skeletal_mesh (risco 2, altera, requer mundo)​

Assigns a SkeletalMesh asset to a skeletal mesh actor. Not smoke-tested: no skeletal mesh ships in engine content on every supported engine.

ArgumentoTipoDescrição
actorstringobrigatório.
meshstringobrigatório.

Retorna: actor, message.

actor.set_sound (risco 2, altera, requer mundo, smoke)​

Sets the sound asset, volume, pitch, auto-activate flag and attenuation of an AmbientSound.

ArgumentoTipoDescrição
actorstringobrigatório.
soundstringSoundBase asset path.
volumenumberVolume multiplier; -1 leaves it unchanged. Padrão -1.0.
pitchnumberPitch multiplier; -1 leaves it unchanged. Padrão -1.0.
autoActivatebooleanPadrão true.
hasAutoActivatebooleanPadrão false.
attenuationstringSoundAttenuation asset path.

Retorna: actor, message.

actor.set_static_mesh (risco 2, altera, requer mundo, smoke)​

Assigns a StaticMesh asset to the static mesh component of an actor.

ArgumentoTipoDescrição
actorstringobrigatório.
meshstringobrigatório.

Retorna: actor, message.

actor.set_tags (risco 2, altera, requer mundo, smoke)​

Replaces the tag list of one or more actors.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
tagsarray of stringThe complete new tag list (replaces the existing tags).

Retorna: actors, count, total, message.

actor.set_tags_many (risco 2, altera, requer mundo, smoke)​

Replaces (or extends) the tags of every actor of a list or of a filter.

ArgumentoTipoDescrição
actorsarray of string
tagsarray of string
addbooleanAdd the tags instead of replacing the existing list. Padrão false.

Retorna: message, count, items.

actor.set_text (risco 2, altera, requer mundo, smoke)​

Sets the string, size, colour, alignment and material of a TextRenderActor.

ArgumentoTipoDescrição
actorstringobrigatório.
textstring
sizenumberWorld size of the glyphs; 0 leaves it unchanged. Padrão 0.0.
colorstring"R,G,B" or "R,G,B,A" with components in 0..1.
alignmentstringHorizontal alignment: left, center or right.
materialstringText material asset path.

Retorna: actor, message.

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

Sets any combination of location, rotation and scale in one call.

ArgumentoTipoDescrição
actorstringobrigatório.
location{x,y,z}
hasLocationbooleanPadrão false.
rotation{x,y,z}
hasRotationbooleanPadrão false.
scale{x,y,z}
hasScalebooleanPadrão false.
spacestring
sweepbooleanPadrão false.
teleportbooleanPadrão true.

Retorna: location, rotation, scale, actor, message.

actor.set_transform_many (risco 2, altera, requer mundo, smoke)​

Applies the same location/rotation/scale to several actors at once.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
location{x,y,z}
hasLocationbooleanPadrão false.
rotation{x,y,z}
hasRotationbooleanPadrão false.
scale{x,y,z}
hasScalebooleanPadrão false.
spacestring

Retorna: actors, count, total, message.

actor.snap_to_actor (risco 2, altera, requer mundo, smoke)​

Places an actor on top of another one, using their bounding boxes.

ArgumentoTipoDescrição
actorstringobrigatório.
targetstringobrigatório. Actor to sit on top of.
useBoundsbooleanPadrão true.

Retorna: location, rotation, scale, actor, message.

actor.snap_to_floor (risco 2, altera, requer mundo, smoke)​

Drops actors straight down onto the first blocking surface (line trace, optionally aligning to the normal).

ArgumentoTipoDescrição
actorsarray of stringobrigatório.
alignbooleanAlso rotate the actor to the surface normal. Padrão false.
useBoundsbooleanRest the bottom of the bounding box on the surface instead of the pivot. Padrão true.
maxDistancenumberHow far down to trace, in centimetres. Padrão 100000.0.

Retorna: actors, count, total, message.

actor.snapshot_transforms (risco 1, requer mundo, smoke)​

Records the transforms of actors in a named in-memory snapshot (not saved with the level).

ArgumentoTipoDescrição
namestringobrigatório. Snapshot name.
actorsarray of stringActors to record; empty records the whole level.

Retorna: message, count, items.

actor.spawn (risco 2, altera, requer mundo, smoke)​

Spawns an actor from a class, Blueprint or asset path and applies label, folder, tags and properties.

ArgumentoTipoDescrição
classstringobrigatório. Class name, class path, Blueprint path or asset path (StaticMesh, SkeletalMesh, Sound, ParticleSystem).
namestringLabel for the new actor (also used as the object name when free).
location{x,y,z}
rotation{x,y,z}x=pitch, y=yaw, z=roll in degrees.
scale{x,y,z}Scale; (0,0,0) is treated as (1,1,1).
folderstringOutliner folder to place the actor in.
tagsarray of string
propertiesarray of UeaKeyValueProperty assignments applied after spawning; keys may be "Prop", "Sub.Prop" or "Component.Prop".
selectbooleanSelect the new actor in the editor. Padrão false.

Retorna: actor, message.

actor.spawn_at_actor (risco 2, altera, requer mundo, smoke)​

Spawns an actor at the transform of another actor plus an offset.

ArgumentoTipoDescrição
classstringobrigatório. Class, Blueprint or asset path to spawn.
atstringobrigatório. Reference actor whose transform is used.
offset{x,y,z}World offset added to the reference location.
inheritRotationbooleanCopy the reference actor's rotation too. Padrão true.
namestring
folderstring

Retorna: actor, message.

actor.spawn_camera (risco 2, altera, requer mundo, smoke)​

Spawns a CameraActor or a CineCameraActor.

ArgumentoTipoDescrição
namestring
location{x,y,z}
rotation{x,y,z}
fovnumberHorizontal field of view in degrees (ignored for cine cameras). Padrão 90.0.
cinebooleanSpawn a CineCameraActor instead of a plain CameraActor. Padrão false.
aspectnumberConstrained aspect ratio; 0 leaves the default. Padrão 0.0.
folderstring

Retorna: actor, message.

actor.spawn_circle (risco 2, altera, requer mundo, smoke)​

Spawns actors evenly spaced on a horizontal circle.

ArgumentoTipoDescrição
classstring
meshstring
countintegerobrigatório. How many actors to place on the circle.
radiusnumberobrigatório. Circle radius in centimetres.
center{x,y,z}
faceCenterbooleanRotate every actor so that +X points at the centre. Padrão false.
namePrefixstring
folderstring

Retorna: actors, count, total, message.

actor.spawn_decal (risco 2, altera, requer mundo, smoke)​

Spawns a DecalActor; the material is optional so the decal can be configured later.

ArgumentoTipoDescrição
materialstringMaterial or material instance to project; optional, assign it later with actor.set_decal.
namestring
location{x,y,z}
rotation{x,y,z}
size{x,y,z}Decal box extent; (0,0,0) keeps the default.
sortOrderintegerPadrão 0.
folderstring

Retorna: actor, message.

actor.spawn_empty (risco 2, altera, requer mundo, smoke)​

Spawns a bare AActor with a SceneComponent root, useful as an attachment pivot.

ArgumentoTipoDescrição
namestring
location{x,y,z}
rotation{x,y,z}
folderstring

Retorna: actor, message.

actor.spawn_grid (risco 2, altera, requer mundo, smoke)​

Spawns a rows x columns grid of actors or mesh actors with a fixed spacing.

ArgumentoTipoDescrição
classstringClass or Blueprint to spawn; leave empty and set "mesh" to spawn static mesh actors.
meshstringStaticMesh asset path; used when "class" is empty.
rowsintegerobrigatório.
columnsintegerobrigatório.
spacingnumberobrigatório. Distance between neighbours in centimetres.
origin{x,y,z}World location of the first element.
namePrefixstringLabel prefix; the index is appended ("Grid_0_0").
folderstring

Retorna: actors, count, total, message.

actor.spawn_many (risco 2, altera, requer mundo, smoke)​

Spawns many actors in one transaction from a list of specs.

ArgumentoTipoDescrição
specsarray of UeaActSpawnSpecobrigatório. One entry per actor to spawn.

Retorna: actors, count, total, message.

actor.spawn_mesh (risco 2, altera, requer mundo, smoke)​

Spawns a StaticMeshActor or SkeletalMeshActor for a mesh asset, optionally with a material and a mobility.

ArgumentoTipoDescrição
meshstringobrigatório. StaticMesh or SkeletalMesh asset path (e.g. "/Engine/BasicShapes/Cube").
namestring
location{x,y,z}
rotation{x,y,z}
scale{x,y,z}
folderstring
tagsarray of string
materialstringMaterial applied to every slot.
mobilitystringStatic, Stationary or Movable (default Static for static meshes).
selectbooleanPadrão false.

Retorna: actor, message.

actor.spawn_player_start (risco 2, altera, requer mundo, smoke)​

Spawns a PlayerStart.

ArgumentoTipoDescrição
namestring
location{x,y,z}
rotation{x,y,z}
tagstringPlayer start tag ("Player0").
folderstring

Retorna: actor, message.

actor.spawn_random_in_box (risco 2, altera, requer mundo, smoke)​

Spawns actors at random positions inside a box, optionally with a random yaw.

ArgumentoTipoDescrição
classstring
meshstring
countintegerobrigatório.
min{x,y,z}obrigatório.
max{x,y,z}obrigatório.
randomYawbooleanGive every actor a random yaw. Padrão false.
seedintegerRandom seed; 0 picks a time-based seed. Padrão 0.
namePrefixstring
folderstring

Retorna: actors, count, total, message.

actor.spawn_sound (risco 2, altera, requer mundo, smoke)​

Spawns an AmbientSound; the sound asset is optional so it can be assigned later.

ArgumentoTipoDescrição
soundstringSoundBase asset (SoundCue, SoundWave, MetaSound); optional, assign it later with actor.set_sound.
namestring
location{x,y,z}
autoActivatebooleanPadrão true.
volumenumberVolume multiplier (1 = unchanged). Padrão 1.0.
folderstring

Retorna: actor, message.

actor.spawn_text (risco 2, altera, requer mundo, smoke)​

Spawns a TextRenderActor showing a string.

ArgumentoTipoDescrição
textstringobrigatório.
namestring
location{x,y,z}
rotation{x,y,z}
sizenumberWorld size of the glyphs (default 26). Padrão 26.0.
colorstringColour as "R,G,B" or "R,G,B,A" with components in 0..1.
folderstring

Retorna: actor, message.

actor.sweep_box (risco 0, requer mundo, smoke)​

Box sweep against the editor world.

ArgumentoTipoDescrição
start{x,y,z}obrigatório.
end{x,y,z}obrigatório.
extent{x,y,z}obrigatório. Half-extent of the swept box in centimetres.
channelstring
ignorearray of string

Retorna: hit, hits, count, message.

actor.ungroup (risco 2, altera, requer mundo, smoke)​

Removes actors from their group, deleting the group when it becomes empty.

ArgumentoTipoDescrição
actorsarray of stringobrigatório.

Retorna: message, count, items.

actor.unlock_group (risco 1, altera, requer mundo, smoke)​

Unlocks a group so its members can be selected individually.

ArgumentoTipoDescrição
groupstringobrigatório. Group actor label/name, or any actor belonging to the group.

Retorna: group, message.

actor.validate (risco 0, requer mundo, smoke)​

Reports missing assets, degenerate scales and other per-actor problems of the level.

ArgumentoTipoDescrição
actorsarray of stringActors to validate; empty validates the whole level.

Retorna: issues, errors, warnings, checked, message.