Saltar al contenido principal

Kit actor

197 herramientas. Generado a partir del código fuente del plugin; no lo edites a mano.

Las descripciones de las herramientas y de los argumentos se muestran en inglés porque reflejan el schema de las herramientas (el mismo texto que el agente recibe en tools/list).

Guía​

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.

Herramientas​

Leyenda. riesgo 0 = solo lectura, 1 = operación inofensiva del editor, 2 = modifica un asset, 3 = elimina/reemplaza un asset, 4 = proyecto/configuración/build, 5 = potencialmente destructivo (las llamadas por encima de MaxAutoRisk requieren "_confirm": true). modifica = se ejecuta en una transacción (edit.undo la revierte). requiere PIE / requiere mundo = se rechaza sin una sesión PIE / sin un nivel abierto. requiere el plugin = no disponible cuando el plugin está desactivado. dryRun = acepta el argumento dryRun. smoke = cubierto por edit.self_test.

actor.add_component (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
classstringobligatorio. 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

Devuelve: component, properties, message.

actor.add_instances (riesgo 2, modifica, requiere mundo, smoke)​

Adds instances to an instanced static mesh actor.

ArgumentoTipoDescripción
actorstringobligatorio.
transformsarray of UeaActTransformSpecobligatorio.
worldSpacebooleanTreat the transforms as world-space (default) instead of component-relative. Valor predeterminado true.

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

actor.add_tag (riesgo 2, modifica, requiere mundo, smoke)​

Adds a tag to one or more actors.

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
tagstringobligatorio.

Devuelve: actors, count, total, message.

actor.add_to_group (riesgo 2, modifica, requiere mundo, smoke)​

Adds actors to an existing group.

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
groupstringobligatorio. Group actor label or name.

Devuelve: group, message.

actor.align_to_actor (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
targetstringobligatorio. Actor whose transform is copied.
locationbooleanValor predeterminado true.
rotationbooleanValor predeterminado false.
scalebooleanValor predeterminado false.

Devuelve: actors, count, total, message.

actor.align_to_grid (riesgo 2, modifica, requiere mundo, smoke)​

Rounds the location of actors to a grid step.

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
gridSizenumberGrid step in centimetres. Valor predeterminado 10.0.

Devuelve: actors, count, total, message.

actor.apply_material_many (riesgo 2, modifica, requiere mundo, dryRun, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringExplicit actor list; when empty the class/name/tag/folder filter is used.
materialstringobligatorio.
slotintegerMaterial slot; -1 applies to every slot. Valor predeterminado -1.
dryRunbooleanValor predeterminado false.

Devuelve: message, count, items.

actor.arrange_line (riesgo 2, modifica, requiere mundo, smoke)​

Places actors evenly on the segment between two world points.

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
start{x,y,z}obligatorio.
end{x,y,z}obligatorio.

Devuelve: actors, count, total, message.

actor.attach (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
parentstringobligatorio.
socketstringSocket on the parent's root component.
rulestringkeepWorld (default), keepRelative or snapToTarget.

Devuelve: actor, message.

actor.attach_component (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
parentstringobligatorio. Scene component of the same actor to attach to.
socketstring
rulestringkeepWorld (default), keepRelative or snapToTarget.

Devuelve: component, properties, message.

actor.attach_many (riesgo 2, modifica, requiere mundo, smoke)​

Attaches several actors to the same parent.

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
parentstringobligatorio.
socketstring
rulestring

Devuelve: actors, count, total, message.

actor.call_function (riesgo 3, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
functionstringobligatorio. UFUNCTION name on the actor.
argsarray of stringArguments in declaration order, in Unreal text form.

Devuelve: values, count, message.

actor.clear_instances (riesgo 3, modifica, destructivo, requiere mundo, smoke)​

Removes every instance of an instanced static mesh actor.

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, object name, unique class name or unique name prefix.

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

actor.convert_to_blueprint (riesgo 3, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
folderstringobligatorio. Content folder for the new Blueprint asset.
namestringobligatorio.
replaceInLevelbooleanReplace the source actors with an instance of the new Blueprint. Valor predeterminado false.
harvestbooleanHarvest the components of every actor into a single Blueprint. Valor predeterminado false.

Devuelve: value, number, result, message.

actor.copy_components (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
fromstringobligatorio. Actor to copy components from.
tostringobligatorio. Actor to paste them onto.
componentsarray of stringComponent names to copy; empty copies every non-native scene component.

Devuelve: components, count, message.

actor.copy_to_clipboard (riesgo 1, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.

Devuelve: value, number, result, message.

actor.count_by_class (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
folderstringOutliner folder path; empty means the whole level.

Devuelve: values, count, message.

actor.create_folder (riesgo 1, modifica, requiere mundo, smoke)​

Creates an outliner folder (and its missing parents).

ArgumentoTipoDescripción
pathstringobligatorio. Outliner folder path, e.g. "Props/Crates".

Devuelve: folders, count, message.

actor.create_instanced_mesh (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
meshstringobligatorio.
namestring
hierarchicalbooleanUse a HierarchicalInstancedStaticMeshComponent (LOD support) instead of a plain ISM. Valor predeterminado false.
location{x,y,z}
folderstring

Devuelve: actor, message.

actor.delete (riesgo 3, modifica, destructivo, requiere mundo, smoke)​

Deletes one actor from the level.

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, object name, unique class name or unique name prefix.

Devuelve: message, count, items.

actor.delete_by_filter (riesgo 5, modifica, destructivo, requiere mundo, dryRun, smoke)​

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

ArgumentoTipoDescripción
dryRunbooleanOnly report what would be deleted. Valor predeterminado false.

Devuelve: message, count, items.

actor.delete_folder (riesgo 2, modifica, destructivo, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
pathstringobligatorio.
moveActorsToParentbooleanMove the actors of the folder to its parent instead of to the root. Valor predeterminado true.

Devuelve: message, count, items.

actor.delete_many (riesgo 3, modifica, destructivo, requiere mundo, smoke)​

Deletes several actors in one transaction.

ArgumentoTipoDescripción
actorsarray of stringobligatorio.

Devuelve: message, count, items.

actor.deselect (riesgo 1, requiere mundo, smoke)​

Removes actors from the editor selection.

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
addbooleanAdd to the current selection instead of replacing it. Valor predeterminado false.
selectHiddenbooleanAllow selecting hidden actors. Valor predeterminado true.

Devuelve: actors, components, count, message.

actor.detach (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
keepWorldbooleanKeep the current world transform after detaching. Valor predeterminado true.

Devuelve: actors, count, total, message.

actor.detach_component (riesgo 2, modifica, requiere 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.

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.

Devuelve: component, properties, message.

actor.distribute (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
axisstringobligatorio. "x", "y" or "z".
spacingnumberFixed distance between neighbours; 0 spreads them evenly between the outermost two. Valor predeterminado 0.0.
betweenbooleanSpread evenly between the current extremes (ignores spacing). Valor predeterminado false.

Devuelve: actors, count, total, message.

actor.duplicate (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
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. Valor predeterminado 1.

Devuelve: actors, count, total, message.

actor.duplicate_many (riesgo 2, modifica, requiere mundo, smoke)​

Duplicates several actors at once with a shared offset.

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
offset{x,y,z}

Devuelve: actors, count, total, message.

actor.exists (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, object name, unique class name or unique name prefix.

Devuelve: value, number, result, message.

actor.export (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringActors to export; empty exports the whole level.
propertiesarray of stringExtra property paths to record for every actor.
prettybooleanPretty-print the JSON. Valor predeterminado false.

Devuelve: json, count, message.

actor.export_folder (riesgo 0, requiere mundo, smoke)​

Exports every actor of an outliner folder as JSON.

ArgumentoTipoDescripción
folderstringobligatorio.
propertiesarray of string
prettybooleanValor predeterminado false.

Devuelve: json, count, message.

actor.find_at_origin (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
tolerancenumberDistance from the world origin below which an actor counts as "at origin". Valor predeterminado 1.0.
classFilterstring

Devuelve: actors, count, total, message.

actor.find_by_class (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
classstringobligatorio. Class name, class path or Blueprint asset path.
includeSubclassesbooleanAlso match subclasses. Valor predeterminado true.

Devuelve: actors, count, total, message.

actor.find_by_label (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
patternstringobligatorio. Label pattern; supports the wildcards * and ? (e.g. "Smoke_*").

Devuelve: actors, count, total, message.

actor.find_by_tag (riesgo 0, requiere mundo, smoke)​

Every actor carrying the given tag.

ArgumentoTipoDescripción
tagstringobligatorio.

Devuelve: actors, count, total, message.

actor.find_duplicates (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
tolerancenumberDistance below which two locations count as identical, in centimetres. Valor predeterminado 1.0.
folderstring

Devuelve: actors, count, total, message.

actor.find_in_box (riesgo 0, requiere mundo, smoke)​

Actors whose origin lies inside an axis-aligned box.

ArgumentoTipoDescripción
min{x,y,z}obligatorio. Minimum corner of the world-space box.
max{x,y,z}obligatorio. Maximum corner of the world-space box.
classFilterstringOptional class name/substring filter.

Devuelve: actors, count, total, message.

actor.find_in_radius (riesgo 0, requiere mundo, smoke)​

Actors whose origin lies inside a sphere.

ArgumentoTipoDescripción
center{x,y,z}obligatorio. World-space centre of the sphere.
radiusnumberobligatorio. Radius in centimetres.
classFilterstringOptional class name/substring filter.

Devuelve: actors, count, total, message.

actor.find_missing_assets (riesgo 0, requiere mundo, smoke)​

Actors whose mesh or material references are null.

ArgumentoTipoDescripción
folderstringOutliner folder path; empty means the whole level.

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

actor.find_outside_bounds (riesgo 0, requiere mundo, smoke)​

Actors whose origin lies outside a world-space box.

ArgumentoTipoDescripción
min{x,y,z}obligatorio. Minimum corner of the world-space box.
max{x,y,z}obligatorio. Maximum corner of the world-space box.
classFilterstringOptional class name/substring filter.

Devuelve: actors, count, total, message.

actor.find_overlapping (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
classFilterstring
thresholdnumberMaximum distance between bounding-box centres to count as overlapping, in centimetres. Valor predeterminado 10.0.
limitintegerValor predeterminado 100.

Devuelve: actors, count, total, message.

actor.find_unlabeled (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
folderstringOutliner folder path; empty means the whole level.

Devuelve: actors, count, total, message.

actor.focus_camera (riesgo 1, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringActors to act on; empty = the current selection.

Devuelve: message, count, items.

actor.frame_selected (riesgo 1, requiere mundo)​

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

Sin argumentos.

Devuelve: message, count, items.

actor.get (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
includeComponentsbooleanAlso list the actor's components. Valor predeterminado false.
includePropertiesbooleanAlso list the actor's editable properties and their current values. Valor predeterminado false.

Devuelve: actor, components, properties, message.

actor.get_bounds (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringActors to measure; empty = every actor of the level.
onlyCollidingbooleanOnly take colliding components into account. Valor predeterminado false.

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

actor.get_by_guid (riesgo 0, requiere mundo)​

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

ArgumentoTipoDescripción
guidstringobligatorio.

Devuelve: actor, message.

actor.get_children (riesgo 0, requiere mundo, smoke)​

The actors attached to an actor, optionally recursively.

ArgumentoTipoDescripción
actorstringobligatorio.
recursivebooleanInclude grandchildren. Valor predeterminado false.

Devuelve: actors, count, total, message.

actor.get_component (riesgo 0, requiere mundo, smoke)​

Details of one component, optionally with its property values.

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
includePropertiesbooleanValor predeterminado false.

Devuelve: component, properties, message.

actor.get_component_bounds (riesgo 0, requiere mundo, smoke)​

World bounding box of one component.

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringComponent name; empty uses the root component.

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

actor.get_component_materials (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringComponent name; empty uses the root component.

Devuelve: values, count, message.

actor.get_component_property (riesgo 0, requiere mundo, smoke)​

Reads one property of a component.

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
propertystringobligatorio.

Devuelve: value, number, result, message.

actor.get_distance (riesgo 0, requiere mundo, smoke)​

Distance in centimetres between the origins of two actors.

ArgumentoTipoDescripción
astringobligatorio.
bstringobligatorio.

Devuelve: value, number, result, message.

actor.get_folder_actors (riesgo 0, requiere mundo, smoke)​

The actors of an outliner folder, optionally including subfolders.

ArgumentoTipoDescripción
pathstringobligatorio.
recursivebooleanInclude the actors of subfolders. Valor predeterminado true.

Devuelve: actors, count, total, message.

actor.get_group (riesgo 0, requiere mundo, smoke)​

The group an actor belongs to, with its members.

ArgumentoTipoDescripción
groupstringobligatorio. Group actor label/name, or any actor belonging to the group.

Devuelve: group, message.

actor.get_guid (riesgo 0, requiere mundo, smoke)​

Persistent GUID of an actor.

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, object name, unique class name or unique name prefix.

Devuelve: value, number, result, message.

actor.get_instances (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
limitintegerValor predeterminado 100.
offsetintegerValor predeterminado 0.

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

actor.get_nearest (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
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. Valor predeterminado 1.

Devuelve: actors, count, total, message.

actor.get_outliner_path (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, object name, unique class name or unique name prefix.

Devuelve: value, number, result, message.

actor.get_outliner_tree (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
folderstringRoot folder; empty starts at the outliner root.
depthintegerMaximum folder depth (0 = unlimited). Valor predeterminado 0.
limitintegerMaximum actors listed per folder. Valor predeterminado 50.

Devuelve: json, count, message.

actor.get_parent (riesgo 0, requiere mundo, smoke)​

The attach parent of an actor, if any.

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, object name, unique class name or unique name prefix.

Devuelve: actor, message.

actor.get_properties (riesgo 0, requiere mundo, smoke)​

Reads several properties of an actor at once.

ArgumentoTipoDescripción
actorstringobligatorio.
propertiesarray of stringProperty paths to read.

Devuelve: values, count, message.

actor.get_property (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
propertystringobligatorio. Property path: "Prop", "Struct.Prop", "ComponentName.Prop", arrays with "Prop[0]".

Devuelve: value, number, result, message.

actor.get_relative_transform (riesgo 0, requiere mundo, smoke)​

Transform of one actor expressed in the space of another.

ArgumentoTipoDescripción
actorstringobligatorio.
tostringobligatorio. Actor the transform is expressed relative to.

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

actor.get_root_component (riesgo 0, requiere mundo, smoke)​

The root component of an actor.

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, object name, unique class name or unique name prefix.

Devuelve: component, properties, message.

actor.get_selected (riesgo 0, requiere mundo, smoke)​

The currently selected actors, optionally with their components.

ArgumentoTipoDescripción
includeComponentsbooleanAlso list the components of the selected actors. Valor predeterminado false.

Devuelve: actors, components, count, message.

actor.get_selected_components (riesgo 0, requiere mundo, smoke)​

The components currently selected in the editor.

Sin argumentos.

Devuelve: actors, components, count, message.

actor.get_skeletal_info (riesgo 0, requiere mundo)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, object name, unique class name or unique name prefix.

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

actor.get_socket_transform (riesgo 0, requiere mundo, smoke)​

World transform of one socket of an actor.

ArgumentoTipoDescripción
actorstringobligatorio.
componentstring
socketstringobligatorio.

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

actor.get_static_mesh_info (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, object name, unique class name or unique name prefix.

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

actor.get_stats (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
folderstringOutliner folder path; empty means the whole level.

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

actor.get_transform (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, object name, unique class name or unique name prefix.

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

actor.group (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
namestringLabel for the new group actor.

Devuelve: group, message.

actor.has_tag (riesgo 0, requiere mundo, smoke)​

Whether an actor carries a tag.

ArgumentoTipoDescripción
actorstringobligatorio.
tagstringobligatorio.

Devuelve: value, number, result, message.

actor.import (riesgo 2, modifica, requiere 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.

ArgumentoTipoDescripción
jsonstringobligatorio. JSON produced by actor.export.
offset{x,y,z}World offset added to every imported actor.
folderstringOverride the outliner folder of every imported actor.

Devuelve: actors, count, total, message.

actor.instances_from_actors (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio. Static mesh actors sharing one mesh.
deleteSourcebooleanDelete the source actors after the conversion. Valor predeterminado true.
namestring
hierarchicalbooleanValor predeterminado false.
folderstring

Devuelve: actor, message.

actor.instances_to_actors (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor carrying an instanced static mesh component.
deleteSourcebooleanDelete the instanced actor afterwards. Valor predeterminado false.
namePrefixstring
folderstring

Devuelve: actors, count, total, message.

actor.invert_selection (riesgo 1, requiere mundo, smoke)​

Inverts the editor selection.

Sin argumentos.

Devuelve: actors, components, count, message.

actor.line_trace (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
start{x,y,z}obligatorio.
end{x,y,z}obligatorio.
channelstringTrace channel: Visibility (default), Camera, WorldStatic, WorldDynamic, Pawn, PhysicsBody.
ignorearray of stringActors to ignore.
multibooleanReturn every hit instead of the first one. Valor predeterminado false.

Devuelve: hit, hits, count, message.

actor.list (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
sublevelstringOnly actors of this sublevel (level object name).
hiddenOnlybooleanOnly actors currently hidden in the editor. Valor predeterminado false.
limitintegerMaximum actors returned (default 100, 0 = no limit). Valor predeterminado 100.
offsetintegerIndex of the first actor returned. Valor predeterminado 0.
includeBoundsbooleanAlso compute and return the bounding box of every actor (slower). Valor predeterminado false.

Devuelve: actors, count, total, message.

actor.list_component_properties (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
nameContainsstring
includeValuesbooleanValor predeterminado true.
limitintegerValor predeterminado 200.

Devuelve: values, count, message.

actor.list_components (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
sceneOnlybooleanOnly components deriving from USceneComponent. Valor predeterminado false.

Devuelve: components, count, message.

actor.list_folders (riesgo 0, requiere mundo, smoke)​

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

Sin argumentos.

Devuelve: folders, count, message.

actor.list_groups (riesgo 0, requiere mundo, smoke)​

Every actor group of the level with its members.

Sin argumentos.

Devuelve: groups, count, groupingActive, message.

actor.list_material_slots (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, object name, unique class name or unique name prefix.

Devuelve: values, count, message.

actor.list_properties (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
nameContainsstringOnly properties whose name contains this substring.
includeValuesbooleanInclude the values as well as the names/types. Valor predeterminado true.
limitintegerMaximum properties returned (0 = all). Valor predeterminado 200.

Devuelve: values, count, message.

actor.list_sockets (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringComponent name; empty uses the root component.

Devuelve: values, count, message.

actor.list_tags (riesgo 0, requiere mundo, smoke)​

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

Sin argumentos.

Devuelve: values, count, message.

actor.lock_group (riesgo 1, modifica, requiere mundo, smoke)​

Locks a group so its members are selected together.

ArgumentoTipoDescripción
groupstringobligatorio. Group actor label/name, or any actor belonging to the group.

Devuelve: group, message.

actor.look_at (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
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). Valor predeterminado false.

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

actor.match_transform (riesgo 2, modifica, requiere mundo, smoke)​

Copies the whole world transform of one actor onto another.

ArgumentoTipoDescripción
actorstringobligatorio.
sourcestringobligatorio. Actor whose full transform is copied.

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

actor.merge_static_meshes (riesgo 3, modifica, requiere mundo)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
folderstringobligatorio. Content folder for the merged static mesh.
namestringobligatorio.
replaceSourcebooleanDelete the source actors and spawn one actor with the merged mesh. Valor predeterminado false.
mergeMaterialsbooleanBake the materials into a single atlas material. Valor predeterminado false.
pivotAtOriginbooleanPut the merged mesh pivot at the world origin instead of the bounds centre. Valor predeterminado false.

Devuelve: value, number, result, message.

actor.mirror (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
axisstringobligatorio. Mirror plane normal: "x", "y" or "z".
origin{x,y,z}Point the mirror plane passes through.

Devuelve: actors, count, total, message.

actor.move_by (riesgo 2, modifica, requiere mundo, smoke)​

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

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

Devuelve: actors, count, total, message.

actor.move_folder (riesgo 1, modifica, requiere mundo, smoke)​

Reparents an outliner folder under another folder.

ArgumentoTipoDescripción
pathstringobligatorio.
newParentstringNew parent folder; empty moves the folder to the root.

Devuelve: folders, count, message.

actor.move_to_camera (riesgo 2, modifica, requiere mundo)​

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

ArgumentoTipoDescripción
actorsarray of stringActors to act on; empty = the current selection.

Devuelve: actors, count, total, message.

actor.overlap_box (riesgo 0, requiere mundo, smoke)​

Actors overlapping a world-space box.

ArgumentoTipoDescripción
center{x,y,z}obligatorio.
extent{x,y,z}obligatorio. Half-extent of the box in centimetres.
channelstring

Devuelve: actors, count, total, message.

actor.overlap_sphere (riesgo 0, requiere mundo, smoke)​

Actors overlapping a world-space sphere.

ArgumentoTipoDescripción
center{x,y,z}obligatorio.
radiusnumberobligatorio.
channelstring

Devuelve: actors, count, total, message.

actor.paste_from_clipboard (riesgo 2, modifica, requiere mundo)​

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

ArgumentoTipoDescripción
textstringActor text produced by actor.copy_to_clipboard; empty pastes the system clipboard.
offsetbooleanOffset the pasted actors. Valor predeterminado false.

Devuelve: actors, count, total, message.

actor.place_on_surface (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
from{x,y,z}obligatorio. World point the trace starts from.
direction{x,y,z}Trace direction; (0,0,0) means straight down.
maxDistancenumberTrace length in centimetres. Valor predeterminado 100000.0.
alignbooleanAlign the actor to the hit normal. Valor predeterminado false.

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

actor.randomize_transform (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
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.
seedintegerValor predeterminado 0.

Devuelve: actors, count, total, message.

actor.raycast_from_camera (riesgo 0, requiere mundo)​

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

ArgumentoTipoDescripción
maxDistancenumberTrace length in centimetres. Valor predeterminado 100000.0.
channelstring

Devuelve: hit, hits, count, message.

actor.relabel_by_class (riesgo 2, modifica, requiere mundo, dryRun, smoke)​

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

ArgumentoTipoDescripción
folderstring
dryRunbooleanValor predeterminado false.

Devuelve: message, count, items.

actor.remove_component (riesgo 3, modifica, destructivo, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.

Devuelve: message, count, items.

actor.remove_from_group (riesgo 2, modifica, requiere mundo, smoke)​

Removes actors from a group.

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
groupstringobligatorio. Group actor label or name.

Devuelve: group, message.

actor.remove_instances (riesgo 3, modifica, destructivo, requiere mundo, smoke)​

Removes instances by index.

ArgumentoTipoDescripción
actorstringobligatorio.
indicesarray of integerobligatorio.

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

actor.remove_tag (riesgo 2, modifica, requiere mundo, smoke)​

Removes a tag from one or more actors.

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
tagstringobligatorio.

Devuelve: actors, count, total, message.

actor.rename_component (riesgo 2, modifica, requiere mundo, smoke)​

Renames an instance component.

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
newNamestringobligatorio.

Devuelve: component, properties, message.

actor.rename_folder (riesgo 1, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
pathstringobligatorio.
newPathstringobligatorio.

Devuelve: folders, count, message.

actor.rename_many (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
patternstringobligatorio. Label pattern; {base} = current label, {n} = index, {class} = class name.
startintegerFirst value of {n}. Valor predeterminado 1.

Devuelve: actors, count, total, message.

actor.replace_mesh_many (riesgo 2, modifica, requiere mundo, dryRun, smoke)​

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

ArgumentoTipoDescripción
fromstringobligatorio. StaticMesh currently used.
tostringobligatorio. StaticMesh to switch to.
folderstringRestrict to this outliner folder.
dryRunbooleanValor predeterminado false.

Devuelve: message, count, items.

actor.replace_with (riesgo 3, modifica, destructivo, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
classstringTarget class name or path.
blueprintstringTarget Blueprint asset path (alternative to class).
keepTransformbooleanValor predeterminado true.
keepLabelbooleanValor predeterminado true.

Devuelve: actors, count, total, message.

actor.reset_property (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
propertystringobligatorio. Property path: "Prop", "Struct.Prop", "ComponentName.Prop", arrays with "Prop[0]".

Devuelve: value, number, result, message.

actor.restore_transforms (riesgo 2, modifica, requiere mundo, smoke)​

Restores the transforms recorded by actor.snapshot_transforms.

ArgumentoTipoDescripción
namestringobligatorio.
removebooleanForget the snapshot after restoring it. Valor predeterminado false.

Devuelve: actors, count, total, message.

actor.rotate_by (riesgo 2, modifica, requiere mundo, smoke)​

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

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

Devuelve: actors, count, total, message.

actor.scale_by (riesgo 2, modifica, requiere mundo, smoke)​

Multiplies the scale of actors component-wise.

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

Devuelve: actors, count, total, message.

actor.select (riesgo 1, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
addbooleanAdd to the current selection instead of replacing it. Valor predeterminado false.
selectHiddenbooleanAllow selecting hidden actors. Valor predeterminado true.

Devuelve: actors, components, count, message.

actor.select_by_filter (riesgo 1, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
addbooleanValor predeterminado false.

Devuelve: actors, components, count, message.

actor.select_children (riesgo 1, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringParent actors; empty uses the current selection.
recursivebooleanValor predeterminado false.
addbooleanValor predeterminado false.

Devuelve: actors, components, count, message.

actor.select_component (riesgo 1, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.

Devuelve: actors, components, count, message.

actor.select_in_box (riesgo 1, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
min{x,y,z}obligatorio.
max{x,y,z}obligatorio.
addbooleanValor predeterminado false.

Devuelve: actors, components, count, message.

actor.select_none (riesgo 1, requiere mundo, smoke)​

Clears the editor selection.

Sin argumentos.

Devuelve: actors, components, count, message.

actor.select_parent (riesgo 1, requiere mundo, smoke)​

Selects the attach parents of the selected actors.

ArgumentoTipoDescripción
actorsarray of stringActors to act on; empty = the current selection.

Devuelve: actors, components, count, message.

actor.select_similar (riesgo 1, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio. Actor label, object name, unique class name or unique name prefix.

Devuelve: actors, components, count, message.

actor.set_anim_blueprint (riesgo 2, modifica, requiere mundo)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
animBlueprintstringobligatorio. Animation Blueprint asset path.

Devuelve: actor, message.

actor.set_animation_asset (riesgo 2, modifica, requiere mundo)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
assetstringobligatorio. AnimSequence or other UAnimationAsset path.
loopbooleanValor predeterminado true.
playingbooleanValor predeterminado true.

Devuelve: actor, message.

actor.set_camera (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
fovnumberHorizontal field of view in degrees; 0 leaves it unchanged. Valor predeterminado 0.0.
aspectnumberValor predeterminado 0.0.
constrainAspectbooleanValor predeterminado false.
hasConstrainAspectbooleanValor predeterminado false.
projectionModestringPerspective or Orthographic.
orthoWidthnumberWidth of the orthographic view in centimetres; 0 leaves it unchanged. Valor predeterminado 0.0.
postProcessBlendWeightnumber0..1; -1 leaves it unchanged. Valor predeterminado -1.0.

Devuelve: actor, message.

actor.set_cast_shadow (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
castShadowbooleanValor predeterminado true.
hasCastShadowbooleanValor predeterminado false.
castDynamicbooleanValor predeterminado true.
hasCastDynamicbooleanValor predeterminado false.
castStaticbooleanValor predeterminado true.
hasCastStaticbooleanValor predeterminado false.
castHiddenShadowbooleanValor predeterminado false.
hasCastHiddenShadowbooleanValor predeterminado false.
castInsetShadowbooleanValor predeterminado false.
hasCastInsetShadowbooleanValor predeterminado false.

Devuelve: values, count, message.

actor.set_cine_camera (riesgo 2, modifica, requiere 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.

ArgumentoTipoDescripción
actorstringobligatorio.
focalLengthnumberFocal length in millimetres; 0 leaves it unchanged. Valor predeterminado 0.0.
aperturenumberF-stop; 0 leaves it unchanged. Valor predeterminado 0.0.
focusDistancenumberManual focus distance in centimetres; 0 leaves it unchanged. Valor predeterminado 0.0.
sensorWidthnumberSensor width in millimetres; 0 leaves it unchanged. Valor predeterminado 0.0.
sensorHeightnumberValor predeterminado 0.0.
lensPresetstringNamed lens preset from the project's cine camera settings.

Devuelve: actor, message.

actor.set_collision_complexity (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
useComplexAsSimplebooleanUse the render mesh for collision. Valor predeterminado false.
useSimpleAsComplexbooleanUse the simple collision primitives for complex queries. Valor predeterminado false.

Devuelve: actor, message.

actor.set_component_collision (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
enabledstringNoCollision, QueryOnly, PhysicsOnly or QueryAndPhysics.
profilestringCollision profile name ("BlockAll", "OverlapAll", ...).
objectTypestringObject type channel ("WorldStatic", "WorldDynamic", ...).
responsesarray of UeaActChannelResponse
generateOverlapEventsbooleanValor predeterminado false.
hasGenerateOverlapEventsbooleanValor predeterminado false.

Devuelve: component, properties, message.

actor.set_component_hidden_in_game (riesgo 2, modifica, requiere mundo, smoke)​

Sets bHiddenInGame on a scene component.

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
valuebooleanobligatorio.
propagatebooleanApply to child components as well. Valor predeterminado false.

Devuelve: component, properties, message.

actor.set_component_material (riesgo 2, modifica, requiere mundo, smoke)​

Overrides the material of one slot of a mesh component.

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
slotintegerMaterial slot index. Valor predeterminado 0.
materialstringMaterial asset path; empty clears the override.

Devuelve: component, properties, message.

actor.set_component_mesh (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
meshstringobligatorio. StaticMesh or SkeletalMesh asset path.

Devuelve: component, properties, message.

actor.set_component_mobility (riesgo 2, modifica, requiere mundo, smoke)​

Sets the mobility of a scene component.

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
mobilitystringobligatorio. Static, Stationary or Movable.

Devuelve: component, properties, message.

actor.set_component_physics (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
simulatebooleanValor predeterminado false.
hasSimulatebooleanValor predeterminado false.
massnumberMass override in kilograms; 0 removes the override. Valor predeterminado 0.0.
gravitybooleanValor predeterminado true.
hasGravitybooleanValor predeterminado false.
linearDampingnumberValor predeterminado -1.0.
angularDampingnumberValor predeterminado -1.0.

Devuelve: component, properties, message.

actor.set_component_properties (riesgo 2, modifica, requiere mundo, smoke)​

Writes several properties of a component in one transaction.

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
propertiesarray of UeaKeyValueobligatorio.

Devuelve: values, count, message.

actor.set_component_property (riesgo 2, modifica, requiere mundo, smoke)​

Writes one property of a component.

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
propertystringobligatorio.
valuestringobligatorio.

Devuelve: value, number, result, message.

actor.set_component_tags (riesgo 2, modifica, requiere mundo, smoke)​

Replaces the component tags of a component.

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
tagsarray of string

Devuelve: component, properties, message.

actor.set_component_tick (riesgo 2, modifica, requiere mundo, smoke)​

Enables or disables component ticking and sets the tick interval.

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
enabledbooleanValor predeterminado true.
intervalnumberSeconds between ticks; 0 = every frame. Valor predeterminado 0.0.

Devuelve: component, properties, message.

actor.set_component_transform (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
location{x,y,z}
hasLocationbooleanValor predeterminado false.
rotation{x,y,z}
hasRotationbooleanValor predeterminado false.
scale{x,y,z}
hasScalebooleanValor predeterminado false.
worldbooleanInterpret the values as world-space instead of relative to the parent. Valor predeterminado false.

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

actor.set_component_visibility (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio.
valuebooleanobligatorio.
propagatebooleanApply to child components as well. Valor predeterminado false.

Devuelve: component, properties, message.

actor.set_decal (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
materialstring
size{x,y,z}Decal box extent; (0,0,0) leaves it unchanged.
sortOrderintegerValor predeterminado 0.
hasSortOrderbooleanValor predeterminado false.
fadeScreenSizenumberValor predeterminado -1.0.

Devuelve: actor, message.

actor.set_flags (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
canBeDamagedbooleanSet only the flags you pass; the others are left alone (use the has* flags below). Valor predeterminado true.
hasCanBeDamagedbooleanValor predeterminado false.
replicatesbooleanValor predeterminado false.
hasReplicatesbooleanValor predeterminado false.
netLoadOnClientbooleanValor predeterminado true.
hasNetLoadOnClientbooleanValor predeterminado false.
tickEnabledbooleanValor predeterminado true.
hasTickEnabledbooleanValor predeterminado false.
lifeSpannumberSeconds before the actor destroys itself in game; 0 = never. Valor predeterminado 0.0.
hasLifeSpanbooleanValor predeterminado false.
netDormancystringNever, Awake, Initial, DormantAll or DormantPartial.
enableCollisionbooleanValor predeterminado true.
hasEnableCollisionbooleanValor predeterminado false.
alwaysRelevantbooleanValor predeterminado false.
hasAlwaysRelevantbooleanValor predeterminado false.
autoDestroyWhenFinishedbooleanValor predeterminado false.
hasAutoDestroyWhenFinishedbooleanValor predeterminado false.

Devuelve: values, count, message.

actor.set_folder (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
pathstringDestination folder; empty moves the actors to the outliner root.

Devuelve: actors, count, total, message.

actor.set_folder_many (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of string
pathstringDestination folder; empty moves to the outliner root.

Devuelve: message, count, items.

actor.set_grouping_active (riesgo 1, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
activebooleanobligatorio.

Devuelve: groups, count, groupingActive, message.

actor.set_hidden (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
hiddenbooleanobligatorio.
inEditorbooleanApply to the editor viewport (temporarily hidden). Valor predeterminado true.
inGamebooleanApply to the game (bHidden / SetActorHiddenInGame). Valor predeterminado false.

Devuelve: actors, count, total, message.

actor.set_hidden_many (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of string
hiddenbooleanobligatorio.
inEditorbooleanValor predeterminado true.
inGamebooleanValor predeterminado false.

Devuelve: message, count, items.

actor.set_instance_transform (riesgo 2, modifica, requiere mundo, smoke)​

Sets the transform of one instance.

ArgumentoTipoDescripción
actorstringobligatorio.
indexintegerobligatorio.
location{x,y,z}
rotation{x,y,z}
scale{x,y,z}
worldSpacebooleanValor predeterminado true.

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

actor.set_label (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
labelstringobligatorio.
uniquebooleanMake the label unique in the level by appending a number when needed. Valor predeterminado true.

Devuelve: actor, message.

actor.set_lightmap_resolution (riesgo 2, modifica, requiere mundo, smoke)​

Overrides the lightmap resolution of a static mesh component.

ArgumentoTipoDescripción
actorstringobligatorio.
resolutionintegerobligatorio. Lightmap resolution in texels (power of two, e.g. 64).
overridebooleanEnable the per-component override. Valor predeterminado true.

Devuelve: actor, message.

actor.set_location (riesgo 2, modifica, requiere mundo, smoke)​

Moves an actor to a world or local location.

ArgumentoTipoDescripción
actorstringobligatorio.
location{x,y,z}obligatorio.
spacestring"world" (default) or "local" (relative to the attach parent).
sweepbooleanSweep to the target location instead of teleporting. Valor predeterminado false.
teleportbooleanTeleport physics state instead of interpolating. Valor predeterminado true.

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

actor.set_lod (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
forcedLodintegerForce this LOD index; -1 restores automatic LOD selection. Valor predeterminado -1.
minLodintegerLowest LOD the component may use; -1 removes the override. Valor predeterminado -1.

Devuelve: actor, message.

actor.set_material_slot (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
slotintegerobligatorio.
materialstringMaterial asset path; empty clears the override.

Devuelve: values, count, message.

actor.set_materials (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
materialsarray of stringobligatorio. Material asset paths, one per slot in order; an empty entry leaves that slot unchanged.

Devuelve: values, count, message.

actor.set_mesh_mobility (riesgo 2, modifica, requiere mundo, smoke)​

Sets the mobility of the mesh component of an actor.

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
mobilitystringobligatorio. Static, Stationary or Movable.

Devuelve: actors, count, total, message.

actor.set_mobility (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
mobilitystringobligatorio. Static, Stationary or Movable.

Devuelve: actors, count, total, message.

actor.set_nanite (riesgo 2, modifica, UE 5.2+, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
enabledbooleanFalse sets bForceDisableNanite on the component. Valor predeterminado true.

Devuelve: actor, message.

actor.set_pivot_offset (riesgo 2, modifica, requiere mundo, smoke)​

Sets the editor pivot offset of an actor.

ArgumentoTipoDescripción
actorstringobligatorio.
offset{x,y,z}obligatorio. Pivot offset in local space.

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

actor.set_properties (riesgo 2, modifica, requiere mundo, smoke)​

Writes several properties of an actor in one transaction.

ArgumentoTipoDescripción
actorstringobligatorio.
propertiesarray of UeaKeyValueobligatorio. Property path / value pairs.

Devuelve: values, count, message.

actor.set_properties_many (riesgo 2, modifica, requiere mundo, dryRun, smoke)​

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

ArgumentoTipoDescripción
actorsarray of string
propertiesarray of UeaKeyValueobligatorio.
dryRunbooleanValor predeterminado false.

Devuelve: message, count, items.

actor.set_property (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
propertystringobligatorio.
valuestringobligatorio. Value in Unreal text form ("42", "true", "(X=1,Y=2,Z=3)", "/Game/Path/Asset.Asset").

Devuelve: value, number, result, message.

actor.set_property_many (riesgo 2, modifica, requiere mundo, dryRun, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringExplicit actor list; when empty the class/name/tag/folder filter is used.
propertystringobligatorio.
valuestringobligatorio.
dryRunbooleanValor predeterminado false.

Devuelve: message, count, items.

actor.set_render_settings (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
visiblebooleanValor predeterminado true.
hasVisiblebooleanValor predeterminado false.
renderInMainPassbooleanValor predeterminado true.
hasRenderInMainPassbooleanValor predeterminado false.
renderCustomDepthbooleanValor predeterminado false.
hasRenderCustomDepthbooleanValor predeterminado false.
customDepthStencilintegerValor predeterminado -1.
cullDistancenumberMaximum draw distance in centimetres; -1 leaves it alone, 0 = unlimited. Valor predeterminado -1.0.
translucencySortPriorityintegerValor predeterminado 0.
hasTranslucencySortPrioritybooleanValor predeterminado false.

Devuelve: values, count, message.

actor.set_root_component (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
componentstringobligatorio. Existing scene component of the actor to promote to root.

Devuelve: component, properties, message.

actor.set_rotation (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
rotation{x,y,z}obligatorio. x=pitch, y=yaw, z=roll in degrees.
spacestring
teleportbooleanValor predeterminado true.

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

actor.set_scale (riesgo 2, modifica, requiere mundo, smoke)​

Sets the scale of an actor.

ArgumentoTipoDescripción
actorstringobligatorio.
scale{x,y,z}obligatorio.
spacestring

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

actor.set_skeletal_mesh (riesgo 2, modifica, requiere mundo)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
meshstringobligatorio.

Devuelve: actor, message.

actor.set_sound (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
soundstringSoundBase asset path.
volumenumberVolume multiplier; -1 leaves it unchanged. Valor predeterminado -1.0.
pitchnumberPitch multiplier; -1 leaves it unchanged. Valor predeterminado -1.0.
autoActivatebooleanValor predeterminado true.
hasAutoActivatebooleanValor predeterminado false.
attenuationstringSoundAttenuation asset path.

Devuelve: actor, message.

actor.set_static_mesh (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
meshstringobligatorio.

Devuelve: actor, message.

actor.set_tags (riesgo 2, modifica, requiere mundo, smoke)​

Replaces the tag list of one or more actors.

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
tagsarray of stringThe complete new tag list (replaces the existing tags).

Devuelve: actors, count, total, message.

actor.set_tags_many (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of string
tagsarray of string
addbooleanAdd the tags instead of replacing the existing list. Valor predeterminado false.

Devuelve: message, count, items.

actor.set_text (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
textstring
sizenumberWorld size of the glyphs; 0 leaves it unchanged. Valor predeterminado 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.

Devuelve: actor, message.

actor.set_transform (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
location{x,y,z}
hasLocationbooleanValor predeterminado false.
rotation{x,y,z}
hasRotationbooleanValor predeterminado false.
scale{x,y,z}
hasScalebooleanValor predeterminado false.
spacestring
sweepbooleanValor predeterminado false.
teleportbooleanValor predeterminado true.

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

actor.set_transform_many (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
location{x,y,z}
hasLocationbooleanValor predeterminado false.
rotation{x,y,z}
hasRotationbooleanValor predeterminado false.
scale{x,y,z}
hasScalebooleanValor predeterminado false.
spacestring

Devuelve: actors, count, total, message.

actor.snap_to_actor (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorstringobligatorio.
targetstringobligatorio. Actor to sit on top of.
useBoundsbooleanValor predeterminado true.

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

actor.snap_to_floor (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.
alignbooleanAlso rotate the actor to the surface normal. Valor predeterminado false.
useBoundsbooleanRest the bottom of the bounding box on the surface instead of the pivot. Valor predeterminado true.
maxDistancenumberHow far down to trace, in centimetres. Valor predeterminado 100000.0.

Devuelve: actors, count, total, message.

actor.snapshot_transforms (riesgo 1, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
namestringobligatorio. Snapshot name.
actorsarray of stringActors to record; empty records the whole level.

Devuelve: message, count, items.

actor.spawn (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
classstringobligatorio. 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. Valor predeterminado false.

Devuelve: actor, message.

actor.spawn_at_actor (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
classstringobligatorio. Class, Blueprint or asset path to spawn.
atstringobligatorio. Reference actor whose transform is used.
offset{x,y,z}World offset added to the reference location.
inheritRotationbooleanCopy the reference actor's rotation too. Valor predeterminado true.
namestring
folderstring

Devuelve: actor, message.

actor.spawn_camera (riesgo 2, modifica, requiere mundo, smoke)​

Spawns a CameraActor or a CineCameraActor.

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

Devuelve: actor, message.

actor.spawn_circle (riesgo 2, modifica, requiere mundo, smoke)​

Spawns actors evenly spaced on a horizontal circle.

ArgumentoTipoDescripción
classstring
meshstring
countintegerobligatorio. How many actors to place on the circle.
radiusnumberobligatorio. Circle radius in centimetres.
center{x,y,z}
faceCenterbooleanRotate every actor so that +X points at the centre. Valor predeterminado false.
namePrefixstring
folderstring

Devuelve: actors, count, total, message.

actor.spawn_decal (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
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.
sortOrderintegerValor predeterminado 0.
folderstring

Devuelve: actor, message.

actor.spawn_empty (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
namestring
location{x,y,z}
rotation{x,y,z}
folderstring

Devuelve: actor, message.

actor.spawn_grid (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
classstringClass or Blueprint to spawn; leave empty and set "mesh" to spawn static mesh actors.
meshstringStaticMesh asset path; used when "class" is empty.
rowsintegerobligatorio.
columnsintegerobligatorio.
spacingnumberobligatorio. 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

Devuelve: actors, count, total, message.

actor.spawn_many (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
specsarray of UeaActSpawnSpecobligatorio. One entry per actor to spawn.

Devuelve: actors, count, total, message.

actor.spawn_mesh (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
meshstringobligatorio. 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).
selectbooleanValor predeterminado false.

Devuelve: actor, message.

actor.spawn_player_start (riesgo 2, modifica, requiere mundo, smoke)​

Spawns a PlayerStart.

ArgumentoTipoDescripción
namestring
location{x,y,z}
rotation{x,y,z}
tagstringPlayer start tag ("Player0").
folderstring

Devuelve: actor, message.

actor.spawn_random_in_box (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
classstring
meshstring
countintegerobligatorio.
min{x,y,z}obligatorio.
max{x,y,z}obligatorio.
randomYawbooleanGive every actor a random yaw. Valor predeterminado false.
seedintegerRandom seed; 0 picks a time-based seed. Valor predeterminado 0.
namePrefixstring
folderstring

Devuelve: actors, count, total, message.

actor.spawn_sound (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
soundstringSoundBase asset (SoundCue, SoundWave, MetaSound); optional, assign it later with actor.set_sound.
namestring
location{x,y,z}
autoActivatebooleanValor predeterminado true.
volumenumberVolume multiplier (1 = unchanged). Valor predeterminado 1.0.
folderstring

Devuelve: actor, message.

actor.spawn_text (riesgo 2, modifica, requiere mundo, smoke)​

Spawns a TextRenderActor showing a string.

ArgumentoTipoDescripción
textstringobligatorio.
namestring
location{x,y,z}
rotation{x,y,z}
sizenumberWorld size of the glyphs (default 26). Valor predeterminado 26.0.
colorstringColour as "R,G,B" or "R,G,B,A" with components in 0..1.
folderstring

Devuelve: actor, message.

actor.sweep_box (riesgo 0, requiere mundo, smoke)​

Box sweep against the editor world.

ArgumentoTipoDescripción
start{x,y,z}obligatorio.
end{x,y,z}obligatorio.
extent{x,y,z}obligatorio. Half-extent of the swept box in centimetres.
channelstring
ignorearray of string

Devuelve: hit, hits, count, message.

actor.ungroup (riesgo 2, modifica, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringobligatorio.

Devuelve: message, count, items.

actor.unlock_group (riesgo 1, modifica, requiere mundo, smoke)​

Unlocks a group so its members can be selected individually.

ArgumentoTipoDescripción
groupstringobligatorio. Group actor label/name, or any actor belonging to the group.

Devuelve: group, message.

actor.validate (riesgo 0, requiere mundo, smoke)​

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

ArgumentoTipoDescripción
actorsarray of stringActors to validate; empty validates the whole level.

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