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:
| Class | Theme |
|---|---|
UUeaKit_Actor | query, spawn, duplicate, delete, clipboard, labels, tags, flags, reflection |
UUeaKit_ActorTransform | location/rotation/scale, alignment, distribution, snapping, mirroring |
UUeaKit_ActorComponents | instance components on level actors |
UUeaKit_ActorHierarchy | attachment, outliner folders, groups, selection |
UUeaKit_ActorMesh | static/skeletal/instanced meshes, decals, text, cameras, sounds |
UUeaKit_ActorBulk | bulk 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
actor.list {"limit": 20}— what is in the level (addclassFilter,nameContains,tag,folder,includeBounds).actor.spawn_mesh {"mesh": "/Engine/BasicShapes/Cube", "name": "Crate", "location": {"z": 100}}.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
| Tool | Purpose |
|---|---|
actor.list | Paged listing with class/name/tag/folder/sublevel/hidden filters. |
actor.get / actor.exists | Full description (optionally components and properties) / existence check. |
actor.count_by_class / actor.list_tags | Histograms of the level or of one folder. |
actor.find_by_tag / actor.find_by_class / actor.find_by_label | By tag, class (subclasses optional) or */? wildcard label. |
actor.find_in_radius / actor.find_in_box / actor.get_nearest / actor.get_distance | Spatial queries. |
actor.get_bounds | Combined and per-actor bounding boxes. |
actor.get_outliner_path / actor.get_guid / actor.get_by_guid | Outliner path and persistent GUID. |
Spawn, duplicate, delete
| Tool | Purpose |
|---|---|
actor.spawn | From a class, a Blueprint or an asset path; applies label, folder, tags, properties. |
actor.spawn_mesh | StaticMesh -> AStaticMeshActor, SkeletalMesh -> ASkeletalMeshActor, with material and mobility. |
actor.spawn_many / actor.spawn_at_actor | A list of specs in one transaction / at another actor's transform. |
actor.spawn_grid / actor.spawn_circle / actor.spawn_random_in_box | Procedural placement (namePrefix, seed). |
actor.spawn_player_start / actor.spawn_camera / actor.spawn_text / actor.spawn_decal / actor.spawn_sound / actor.spawn_empty | Typed spawners. cine: true gives a ACineCameraActor. |
actor.duplicate / actor.duplicate_many | Copies with a cumulative offset. |
actor.delete / actor.delete_many / actor.delete_by_filter | delete_by_filter is Risk 5 and honours dryRun. |
actor.copy_to_clipboard / actor.paste_from_clipboard | T3D text in and out of the editor clipboard. |
Labels, tags, flags, reflection
| Tool | Purpose |
|---|---|
actor.set_label / actor.rename_many / actor.relabel_by_class | rename_many uses {base}, {n} and {class}; relabel_by_class honours dryRun. |
actor.set_tags / actor.add_tag / actor.remove_tag / actor.has_tag | Actor tags. |
actor.set_hidden / actor.set_mobility | Editor and/or game visibility; mobility on every scene component. |
actor.set_flags | canBeDamaged, 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_property | Reflection over the actor and its components. |
actor.call_function | Calls 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.ruleiskeepWorld(default),keepRelativeorsnapToTarget. - 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(hierarchicalfor 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 honourdryRun). - Layout:
actor.export,export_folder,import. - Conversion:
actor.replace_with,convert_to_blueprint(harvestfor 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
actor.spawn_grid {"mesh": "/Engine/BasicShapes/Cube", "rows": 5, "columns": 5, "spacing": 300, "namePrefix": "Floor", "folder": "Arena/Floor"}actor.spawn_player_start {"name": "Start", "location": {"z": 200}, "folder": "Arena"}actor.spawn_camera {"name": "Overview", "location": {"x": -1500, "z": 900}, "fov": 75, "folder": "Arena"}actor.look_at {"actor": "Overview", "target": "Floor_2_2"}actor.spawn_circle {"mesh": "/Engine/BasicShapes/Sphere", "count": 8, "radius": 600, "faceCenter": true, "namePrefix": "Pillar", "folder": "Arena/Props"}actor.snap_to_floor {"actors": ["folder:Arena/Props"]}actor.set_tags_many {"folder": "Arena", "tags": ["arena"], "add": true}actor.get_stats {}to check the triangle budget, thenlevel.save(level kit).
Recipe: organise an imported level
actor.find_unlabeled {}thenactor.relabel_by_class {"dryRun": true}to preview, then withoutdryRun.actor.select_by_filter {"classFilter": "StaticMeshActor"}andactor.set_folder_many {"classFilter": "StaticMeshActor", "path": "Geometry"}.actor.find_at_origin {}andactor.find_duplicates {}to spot mistakes.actor.validate {}for missing meshes/materials and degenerate scales.actor.get_outliner_tree {"limit": 20}for the final shape.
Recipe: instanced meshes for performance
actor.find_by_class {"class": "StaticMeshActor"}and group the ones sharing a mesh.actor.instances_from_actors {"actors": ["tag:foliage"], "deleteSource": true, "hierarchical": true, "name": "ISM_Foliage"}actor.get_instances {"actor": "ISM_Foliage", "limit": 20}/actor.add_instancesto extend it.actor.instances_to_actors {"actor": "ISM_Foliage"}to go back to individual actors when editing.
Recipe: export a layout and re-import it elsewhere
actor.export_folder {"folder": "Arena", "properties": ["Tags"], "pretty": true}-> JSON string.- Open the destination level (level kit).
actor.import {"json": "<that JSON>", "offset": {"x": 5000}, "folder": "ArenaCopy"}.
Recipe: turn a prototype actor into a Blueprint
- Build the actor with
actor.spawn_empty+actor.add_componentcalls. actor.convert_to_blueprint {"actors": ["Prototype"], "folder": "/Game/Blueprints", "name": "BP_Prototype", "replaceInLevel": true}- Continue in the
bpkit (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, soedit.undoreverts 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
AActorhas no root component, which would make it useless for transforms, attachment andactor.convert_to_blueprint, so the kit adds a movableDefaultSceneRoot(the same thing the editor's "Empty Actor" placement does).AInfoactors (GameMode, WorldSettings, …) are left transformless, as the engine intends. - Static mobility refuses transform edits.
actor.spawn_meshdefaults toStatic; passmobility: "Movable"(or callactor.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 beProp,Struct.Prop,Component.Propand array elements withProp[0].- Labels are not object names.
actor.set_labelchanges only the outliner label; the object name stays as it was spawned.actor.getreturns both. - Folders are plain path strings (
"Props/Crates"). On 5.1+ they are mapped toFFolderinternally. A folder with no actors disappears when the level is reloaded;actor.delete_foldersimply moves its actors out. - Groups need grouping mode. If
actor.groupreports that no group was created, callactor.set_grouping_active {"active": true}first. actor.add_componentcreates instance components. Native, Blueprint and root components cannot be removed from a level actor; use thebpkit for the Blueprint's construction script instead.actor.remove_componentre-parents the component's children before destroying it.- A non-root scene component can never be parentless.
actor.detach_componenttherefore 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.detachon whole actors does detach normally.) actor.replace_withgoes 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_mesheswrites an asset and runs a full bake; it is Risk 3 and can take a while on large selections.actor.snapshot_transformslives 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_boxandsnap_to_floor. actor.move_to_camera,actor.frame_selectedandactor.raycast_from_cameraneed an interactive level viewport and fail withE_EDITOR_STATEin 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
MaxAutoRiskrequieren"_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 argumentodryRun. smoke = cubierto poredit.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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
class | string | obligatorio. Component class ("StaticMeshComponent", "PointLightComponent", ...). |
name | string | Name for the new component; a unique one is generated when empty. |
parent | string | Existing scene component to attach to; empty attaches to the root. |
socket | string | Socket on the parent component. |
location | {x,y,z} | |
rotation | {x,y,z} | |
scale | {x,y,z} | |
properties | array of UeaKeyValue |
Devuelve: component, properties, message.
actor.add_instances (riesgo 2, modifica, requiere mundo, smoke)
Adds instances to an instanced static mesh actor.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
transforms | array of UeaActTransformSpec | obligatorio. |
worldSpace | boolean | Treat 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
tag | string | obligatorio. |
Devuelve: actors, count, total, message.
actor.add_to_group (riesgo 2, modifica, requiere mundo, smoke)
Adds actors to an existing group.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
group | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
target | string | obligatorio. Actor whose transform is copied. |
location | boolean | Valor predeterminado true. |
rotation | boolean | Valor predeterminado false. |
scale | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
gridSize | number | Grid 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | Explicit actor list; when empty the class/name/tag/folder filter is used. |
material | string | obligatorio. |
slot | integer | Material slot; -1 applies to every slot. Valor predeterminado -1. |
dryRun | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
parent | string | obligatorio. |
socket | string | Socket on the parent's root component. |
rule | string | keepWorld (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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
parent | string | obligatorio. Scene component of the same actor to attach to. |
socket | string | |
rule | string | keepWorld (default), keepRelative or snapToTarget. |
Devuelve: component, properties, message.
actor.attach_many (riesgo 2, modifica, requiere mundo, smoke)
Attaches several actors to the same parent.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
parent | string | obligatorio. |
socket | string | |
rule | string |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
function | string | obligatorio. UFUNCTION name on the actor. |
args | array of string | Arguments 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
folder | string | obligatorio. Content folder for the new Blueprint asset. |
name | string | obligatorio. |
replaceInLevel | boolean | Replace the source actors with an instance of the new Blueprint. Valor predeterminado false. |
harvest | boolean | Harvest 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.
| Argumento | Tipo | Descripción |
|---|---|---|
from | string | obligatorio. Actor to copy components from. |
to | string | obligatorio. Actor to paste them onto. |
components | array of string | Component 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
folder | string | Outliner 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).
| Argumento | Tipo | Descripción |
|---|---|---|
path | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
mesh | string | obligatorio. |
name | string | |
hierarchical | boolean | Use a HierarchicalInstancedStaticMeshComponent (LOD support) instead of a plain ISM. Valor predeterminado false. |
location | {x,y,z} | |
folder | string |
Devuelve: actor, message.
actor.delete (riesgo 3, modifica, destructivo, requiere mundo, smoke)
Deletes one actor from the level.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
dryRun | boolean | Only 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.
| Argumento | Tipo | Descripción |
|---|---|---|
path | string | obligatorio. |
moveActorsToParent | boolean | Move 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
Devuelve: message, count, items.
actor.deselect (riesgo 1, requiere mundo, smoke)
Removes actors from the editor selection.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
add | boolean | Add to the current selection instead of replacing it. Valor predeterminado false. |
selectHidden | boolean | Allow 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
keepWorld | boolean | Keep 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
axis | string | obligatorio. "x", "y" or "z". |
spacing | number | Fixed distance between neighbours; 0 spreads them evenly between the outermost two. Valor predeterminado 0.0. |
between | boolean | Spread 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
offset | {x,y,z} | World offset applied to each copy (cumulative when count > 1). |
name | string | Label of the copy; only used when count is 1. |
count | integer | How 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. 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).
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | Actors to export; empty exports the whole level. |
properties | array of string | Extra property paths to record for every actor. |
pretty | boolean | Pretty-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.
| Argumento | Tipo | Descripción |
|---|---|---|
folder | string | obligatorio. |
properties | array of string | |
pretty | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
tolerance | number | Distance from the world origin below which an actor counts as "at origin". Valor predeterminado 1.0. |
classFilter | string |
Devuelve: actors, count, total, message.
actor.find_by_class (riesgo 0, requiere mundo, smoke)
Every actor of a class (subclasses included by default).
| Argumento | Tipo | Descripción |
|---|---|---|
class | string | obligatorio. Class name, class path or Blueprint asset path. |
includeSubclasses | boolean | Also 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_*").
| Argumento | Tipo | Descripción |
|---|---|---|
pattern | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
tag | string | obligatorio. |
Devuelve: actors, count, total, message.
actor.find_duplicates (riesgo 0, requiere mundo, smoke)
Actors that share class, mesh and transform with another actor.
| Argumento | Tipo | Descripción |
|---|---|---|
tolerance | number | Distance below which two locations count as identical, in centimetres. Valor predeterminado 1.0. |
folder | string |
Devuelve: actors, count, total, message.
actor.find_in_box (riesgo 0, requiere mundo, smoke)
Actors whose origin lies inside an axis-aligned box.
| Argumento | Tipo | Descripció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. |
classFilter | string | Optional 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.
| Argumento | Tipo | Descripción |
|---|---|---|
center | {x,y,z} | obligatorio. World-space centre of the sphere. |
radius | number | obligatorio. Radius in centimetres. |
classFilter | string | Optional 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.
| Argumento | Tipo | Descripción |
|---|---|---|
folder | string | Outliner 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.
| Argumento | Tipo | Descripció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. |
classFilter | string | Optional 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.
| Argumento | Tipo | Descripción |
|---|---|---|
classFilter | string | |
threshold | number | Maximum distance between bounding-box centres to count as overlapping, in centimetres. Valor predeterminado 10.0. |
limit | integer | Valor 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).
| Argumento | Tipo | Descripción |
|---|---|---|
folder | string | Outliner 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | Actors 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
includeComponents | boolean | Also list the actor's components. Valor predeterminado false. |
includeProperties | boolean | Also 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | Actors to measure; empty = every actor of the level. |
onlyColliding | boolean | Only 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.
| Argumento | Tipo | Descripción |
|---|---|---|
guid | string | obligatorio. |
Devuelve: actor, message.
actor.get_children (riesgo 0, requiere mundo, smoke)
The actors attached to an actor, optionally recursively.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
recursive | boolean | Include 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
includeProperties | boolean | Valor predeterminado false. |
Devuelve: component, properties, message.
actor.get_component_bounds (riesgo 0, requiere mundo, smoke)
World bounding box of one component.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | Component 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | Component 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
property | string | obligatorio. |
Devuelve: value, number, result, message.
actor.get_distance (riesgo 0, requiere mundo, smoke)
Distance in centimetres between the origins of two actors.
| Argumento | Tipo | Descripción |
|---|---|---|
a | string | obligatorio. |
b | string | obligatorio. |
Devuelve: value, number, result, message.
actor.get_folder_actors (riesgo 0, requiere mundo, smoke)
The actors of an outliner folder, optionally including subfolders.
| Argumento | Tipo | Descripción |
|---|---|---|
path | string | obligatorio. |
recursive | boolean | Include 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.
| Argumento | Tipo | Descripción |
|---|---|---|
group | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
limit | integer | Valor predeterminado 100. |
offset | integer | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
to | string | Reference actor; when empty the point in "point" is used. |
point | {x,y,z} | Reference point used when "to" is empty. |
classFilter | string | Optional class name/substring filter. |
count | integer | How 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").
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
folder | string | Root folder; empty starts at the outliner root. |
depth | integer | Maximum folder depth (0 = unlimited). Valor predeterminado 0. |
limit | integer | Maximum 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
properties | array of string | Property 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").
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
property | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
to | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
includeComponents | boolean | Also 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | |
socket | string | obligatorio. |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
folder | string | Outliner 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
name | string | Label for the new group actor. |
Devuelve: group, message.
actor.has_tag (riesgo 0, requiere mundo, smoke)
Whether an actor carries a tag.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
tag | string | obligatorio. |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
json | string | obligatorio. JSON produced by actor.export. |
offset | {x,y,z} | World offset added to every imported actor. |
folder | string | Override 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. Static mesh actors sharing one mesh. |
deleteSource | boolean | Delete the source actors after the conversion. Valor predeterminado true. |
name | string | |
hierarchical | boolean | Valor predeterminado false. |
folder | string |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. Actor carrying an instanced static mesh component. |
deleteSource | boolean | Delete the instanced actor afterwards. Valor predeterminado false. |
namePrefix | string | |
folder | string |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
start | {x,y,z} | obligatorio. |
end | {x,y,z} | obligatorio. |
channel | string | Trace channel: Visibility (default), Camera, WorldStatic, WorldDynamic, Pawn, PhysicsBody. |
ignore | array of string | Actors to ignore. |
multi | boolean | Return 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.
| Argumento | Tipo | Descripción |
|---|---|---|
sublevel | string | Only actors of this sublevel (level object name). |
hiddenOnly | boolean | Only actors currently hidden in the editor. Valor predeterminado false. |
limit | integer | Maximum actors returned (default 100, 0 = no limit). Valor predeterminado 100. |
offset | integer | Index of the first actor returned. Valor predeterminado 0. |
includeBounds | boolean | Also 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
nameContains | string | |
includeValues | boolean | Valor predeterminado true. |
limit | integer | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
sceneOnly | boolean | Only 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
nameContains | string | Only properties whose name contains this substring. |
includeValues | boolean | Include the values as well as the names/types. Valor predeterminado true. |
limit | integer | Maximum 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).
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | Component 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.
| Argumento | Tipo | Descripción |
|---|---|---|
group | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
target | string | Target actor; when empty the point in "point" is used. |
point | {x,y,z} | |
axis | string | Which local axis points at the target: "x" (default), "y", "z", "-x", "-y" or "-z". |
keepPitch | boolean | Keep 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
source | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
folder | string | obligatorio. Content folder for the merged static mesh. |
name | string | obligatorio. |
replaceSource | boolean | Delete the source actors and spawn one actor with the merged mesh. Valor predeterminado false. |
mergeMaterials | boolean | Bake the materials into a single atlas material. Valor predeterminado false. |
pivotAtOrigin | boolean | Put 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).
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
axis | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | Actors 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. |
space | string | "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.
| Argumento | Tipo | Descripción |
|---|---|---|
path | string | obligatorio. |
newParent | string | New 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | Actors 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.
| Argumento | Tipo | Descripción |
|---|---|---|
center | {x,y,z} | obligatorio. |
extent | {x,y,z} | obligatorio. Half-extent of the box in centimetres. |
channel | string |
Devuelve: actors, count, total, message.
actor.overlap_sphere (riesgo 0, requiere mundo, smoke)
Actors overlapping a world-space sphere.
| Argumento | Tipo | Descripción |
|---|---|---|
center | {x,y,z} | obligatorio. |
radius | number | obligatorio. |
channel | string |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
text | string | Actor text produced by actor.copy_to_clipboard; empty pastes the system clipboard. |
offset | boolean | Offset 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
from | {x,y,z} | obligatorio. World point the trace starts from. |
direction | {x,y,z} | Trace direction; (0,0,0) means straight down. |
maxDistance | number | Trace length in centimetres. Valor predeterminado 100000.0. |
align | boolean | Align 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
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. |
seed | integer | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
maxDistance | number | Trace length in centimetres. Valor predeterminado 100000.0. |
channel | string |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
folder | string | |
dryRun | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
Devuelve: message, count, items.
actor.remove_from_group (riesgo 2, modifica, requiere mundo, smoke)
Removes actors from a group.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
group | string | obligatorio. Group actor label or name. |
Devuelve: group, message.
actor.remove_instances (riesgo 3, modifica, destructivo, requiere mundo, smoke)
Removes instances by index.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
indices | array of integer | obligatorio. |
Devuelve: instances, count, total, mesh, message.
actor.remove_tag (riesgo 2, modifica, requiere mundo, smoke)
Removes a tag from one or more actors.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
tag | string | obligatorio. |
Devuelve: actors, count, total, message.
actor.rename_component (riesgo 2, modifica, requiere mundo, smoke)
Renames an instance component.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
newName | string | obligatorio. |
Devuelve: component, properties, message.
actor.rename_folder (riesgo 1, modifica, requiere mundo, smoke)
Renames or moves an outliner folder and every actor inside it.
| Argumento | Tipo | Descripción |
|---|---|---|
path | string | obligatorio. |
newPath | string | obligatorio. |
Devuelve: folders, count, message.
actor.rename_many (riesgo 2, modifica, requiere mundo, smoke)
Relabels several actors from a pattern using {base}, {n} and {class}.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
pattern | string | obligatorio. Label pattern; {base} = current label, {n} = index, {class} = class name. |
start | integer | First 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).
| Argumento | Tipo | Descripción |
|---|---|---|
from | string | obligatorio. StaticMesh currently used. |
to | string | obligatorio. StaticMesh to switch to. |
folder | string | Restrict to this outliner folder. |
dryRun | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
class | string | Target class name or path. |
blueprint | string | Target Blueprint asset path (alternative to class). |
keepTransform | boolean | Valor predeterminado true. |
keepLabel | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
property | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
name | string | obligatorio. |
remove | boolean | Forget 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).
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | Actors 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. |
space | string | "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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | Actors 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. |
space | string | "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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
add | boolean | Add to the current selection instead of replacing it. Valor predeterminado false. |
selectHidden | boolean | Allow 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.
| Argumento | Tipo | Descripción |
|---|---|---|
add | boolean | Valor 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).
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | Parent actors; empty uses the current selection. |
recursive | boolean | Valor predeterminado false. |
add | boolean | Valor predeterminado false. |
Devuelve: actors, components, count, message.
actor.select_component (riesgo 1, requiere mundo, smoke)
Selects one component of an actor (component selection mode).
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
min | {x,y,z} | obligatorio. |
max | {x,y,z} | obligatorio. |
add | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | Actors 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
animBlueprint | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
asset | string | obligatorio. AnimSequence or other UAnimationAsset path. |
loop | boolean | Valor predeterminado true. |
playing | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
fov | number | Horizontal field of view in degrees; 0 leaves it unchanged. Valor predeterminado 0.0. |
aspect | number | Valor predeterminado 0.0. |
constrainAspect | boolean | Valor predeterminado false. |
hasConstrainAspect | boolean | Valor predeterminado false. |
projectionMode | string | Perspective or Orthographic. |
orthoWidth | number | Width of the orthographic view in centimetres; 0 leaves it unchanged. Valor predeterminado 0.0. |
postProcessBlendWeight | number | 0..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).
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
castShadow | boolean | Valor predeterminado true. |
hasCastShadow | boolean | Valor predeterminado false. |
castDynamic | boolean | Valor predeterminado true. |
hasCastDynamic | boolean | Valor predeterminado false. |
castStatic | boolean | Valor predeterminado true. |
hasCastStatic | boolean | Valor predeterminado false. |
castHiddenShadow | boolean | Valor predeterminado false. |
hasCastHiddenShadow | boolean | Valor predeterminado false. |
castInsetShadow | boolean | Valor predeterminado false. |
hasCastInsetShadow | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
focalLength | number | Focal length in millimetres; 0 leaves it unchanged. Valor predeterminado 0.0. |
aperture | number | F-stop; 0 leaves it unchanged. Valor predeterminado 0.0. |
focusDistance | number | Manual focus distance in centimetres; 0 leaves it unchanged. Valor predeterminado 0.0. |
sensorWidth | number | Sensor width in millimetres; 0 leaves it unchanged. Valor predeterminado 0.0. |
sensorHeight | number | Valor predeterminado 0.0. |
lensPreset | string | Named 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).
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
useComplexAsSimple | boolean | Use the render mesh for collision. Valor predeterminado false. |
useSimpleAsComplex | boolean | Use 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
enabled | string | NoCollision, QueryOnly, PhysicsOnly or QueryAndPhysics. |
profile | string | Collision profile name ("BlockAll", "OverlapAll", ...). |
objectType | string | Object type channel ("WorldStatic", "WorldDynamic", ...). |
responses | array of UeaActChannelResponse | |
generateOverlapEvents | boolean | Valor predeterminado false. |
hasGenerateOverlapEvents | boolean | Valor predeterminado false. |
Devuelve: component, properties, message.
actor.set_component_hidden_in_game (riesgo 2, modifica, requiere mundo, smoke)
Sets bHiddenInGame on a scene component.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
value | boolean | obligatorio. |
propagate | boolean | Apply 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
slot | integer | Material slot index. Valor predeterminado 0. |
material | string | Material 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
mesh | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
mobility | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
simulate | boolean | Valor predeterminado false. |
hasSimulate | boolean | Valor predeterminado false. |
mass | number | Mass override in kilograms; 0 removes the override. Valor predeterminado 0.0. |
gravity | boolean | Valor predeterminado true. |
hasGravity | boolean | Valor predeterminado false. |
linearDamping | number | Valor predeterminado -1.0. |
angularDamping | number | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
properties | array of UeaKeyValue | obligatorio. |
Devuelve: values, count, message.
actor.set_component_property (riesgo 2, modifica, requiere mundo, smoke)
Writes one property of a component.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
property | string | obligatorio. |
value | string | obligatorio. |
Devuelve: value, number, result, message.
actor.set_component_tags (riesgo 2, modifica, requiere mundo, smoke)
Replaces the component tags of a component.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
tags | array 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
enabled | boolean | Valor predeterminado true. |
interval | number | Seconds 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
location | {x,y,z} | |
hasLocation | boolean | Valor predeterminado false. |
rotation | {x,y,z} | |
hasRotation | boolean | Valor predeterminado false. |
scale | {x,y,z} | |
hasScale | boolean | Valor predeterminado false. |
world | boolean | Interpret 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. |
value | boolean | obligatorio. |
propagate | boolean | Apply 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
material | string | |
size | {x,y,z} | Decal box extent; (0,0,0) leaves it unchanged. |
sortOrder | integer | Valor predeterminado 0. |
hasSortOrder | boolean | Valor predeterminado false. |
fadeScreenSize | number | Valor 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).
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
canBeDamaged | boolean | Set only the flags you pass; the others are left alone (use the has* flags below). Valor predeterminado true. |
hasCanBeDamaged | boolean | Valor predeterminado false. |
replicates | boolean | Valor predeterminado false. |
hasReplicates | boolean | Valor predeterminado false. |
netLoadOnClient | boolean | Valor predeterminado true. |
hasNetLoadOnClient | boolean | Valor predeterminado false. |
tickEnabled | boolean | Valor predeterminado true. |
hasTickEnabled | boolean | Valor predeterminado false. |
lifeSpan | number | Seconds before the actor destroys itself in game; 0 = never. Valor predeterminado 0.0. |
hasLifeSpan | boolean | Valor predeterminado false. |
netDormancy | string | Never, Awake, Initial, DormantAll or DormantPartial. |
enableCollision | boolean | Valor predeterminado true. |
hasEnableCollision | boolean | Valor predeterminado false. |
alwaysRelevant | boolean | Valor predeterminado false. |
hasAlwaysRelevant | boolean | Valor predeterminado false. |
autoDestroyWhenFinished | boolean | Valor predeterminado false. |
hasAutoDestroyWhenFinished | boolean | Valor 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).
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
path | string | Destination 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | |
path | string | Destination 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.
| Argumento | Tipo | Descripción |
|---|---|---|
active | boolean | obligatorio. |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
hidden | boolean | obligatorio. |
inEditor | boolean | Apply to the editor viewport (temporarily hidden). Valor predeterminado true. |
inGame | boolean | Apply 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | |
hidden | boolean | obligatorio. |
inEditor | boolean | Valor predeterminado true. |
inGame | boolean | Valor predeterminado false. |
Devuelve: message, count, items.
actor.set_instance_transform (riesgo 2, modifica, requiere mundo, smoke)
Sets the transform of one instance.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
index | integer | obligatorio. |
location | {x,y,z} | |
rotation | {x,y,z} | |
scale | {x,y,z} | |
worldSpace | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
label | string | obligatorio. |
unique | boolean | Make 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
resolution | integer | obligatorio. Lightmap resolution in texels (power of two, e.g. 64). |
override | boolean | Enable 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
location | {x,y,z} | obligatorio. |
space | string | "world" (default) or "local" (relative to the attach parent). |
sweep | boolean | Sweep to the target location instead of teleporting. Valor predeterminado false. |
teleport | boolean | Teleport 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
forcedLod | integer | Force this LOD index; -1 restores automatic LOD selection. Valor predeterminado -1. |
minLod | integer | Lowest 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
slot | integer | obligatorio. |
material | string | Material 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
materials | array of string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
mobility | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
mobility | string | obligatorio. 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).
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
enabled | boolean | False 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
properties | array of UeaKeyValue | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | |
properties | array of UeaKeyValue | obligatorio. |
dryRun | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
property | string | obligatorio. |
value | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | Explicit actor list; when empty the class/name/tag/folder filter is used. |
property | string | obligatorio. |
value | string | obligatorio. |
dryRun | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
visible | boolean | Valor predeterminado true. |
hasVisible | boolean | Valor predeterminado false. |
renderInMainPass | boolean | Valor predeterminado true. |
hasRenderInMainPass | boolean | Valor predeterminado false. |
renderCustomDepth | boolean | Valor predeterminado false. |
hasRenderCustomDepth | boolean | Valor predeterminado false. |
customDepthStencil | integer | Valor predeterminado -1. |
cullDistance | number | Maximum draw distance in centimetres; -1 leaves it alone, 0 = unlimited. Valor predeterminado -1.0. |
translucencySortPriority | integer | Valor predeterminado 0. |
hasTranslucencySortPriority | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
component | string | obligatorio. 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).
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
rotation | {x,y,z} | obligatorio. x=pitch, y=yaw, z=roll in degrees. |
space | string | |
teleport | boolean | Valor predeterminado true. |
Devuelve: location, rotation, scale, actor, message.
actor.set_scale (riesgo 2, modifica, requiere mundo, smoke)
Sets the scale of an actor.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
scale | {x,y,z} | obligatorio. |
space | string |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
mesh | string | obligatorio. |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
sound | string | SoundBase asset path. |
volume | number | Volume multiplier; -1 leaves it unchanged. Valor predeterminado -1.0. |
pitch | number | Pitch multiplier; -1 leaves it unchanged. Valor predeterminado -1.0. |
autoActivate | boolean | Valor predeterminado true. |
hasAutoActivate | boolean | Valor predeterminado false. |
attenuation | string | SoundAttenuation 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
mesh | string | obligatorio. |
Devuelve: actor, message.
actor.set_tags (riesgo 2, modifica, requiere mundo, smoke)
Replaces the tag list of one or more actors.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
tags | array of string | The 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | |
tags | array of string | |
add | boolean | Add 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
text | string | |
size | number | World size of the glyphs; 0 leaves it unchanged. Valor predeterminado 0.0. |
color | string | "R,G,B" or "R,G,B,A" with components in 0..1. |
alignment | string | Horizontal alignment: left, center or right. |
material | string | Text 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
location | {x,y,z} | |
hasLocation | boolean | Valor predeterminado false. |
rotation | {x,y,z} | |
hasRotation | boolean | Valor predeterminado false. |
scale | {x,y,z} | |
hasScale | boolean | Valor predeterminado false. |
space | string | |
sweep | boolean | Valor predeterminado false. |
teleport | boolean | Valor 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
location | {x,y,z} | |
hasLocation | boolean | Valor predeterminado false. |
rotation | {x,y,z} | |
hasRotation | boolean | Valor predeterminado false. |
scale | {x,y,z} | |
hasScale | boolean | Valor predeterminado false. |
space | string |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
actor | string | obligatorio. |
target | string | obligatorio. Actor to sit on top of. |
useBounds | boolean | Valor 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).
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
align | boolean | Also rotate the actor to the surface normal. Valor predeterminado false. |
useBounds | boolean | Rest the bottom of the bounding box on the surface instead of the pivot. Valor predeterminado true. |
maxDistance | number | How 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).
| Argumento | Tipo | Descripción |
|---|---|---|
name | string | obligatorio. Snapshot name. |
actors | array of string | Actors 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.
| Argumento | Tipo | Descripción |
|---|---|---|
class | string | obligatorio. Class name, class path, Blueprint path or asset path (StaticMesh, SkeletalMesh, Sound, ParticleSystem). |
name | string | Label 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). |
folder | string | Outliner folder to place the actor in. |
tags | array of string | |
properties | array of UeaKeyValue | Property assignments applied after spawning; keys may be "Prop", "Sub.Prop" or "Component.Prop". |
select | boolean | Select 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.
| Argumento | Tipo | Descripción |
|---|---|---|
class | string | obligatorio. Class, Blueprint or asset path to spawn. |
at | string | obligatorio. Reference actor whose transform is used. |
offset | {x,y,z} | World offset added to the reference location. |
inheritRotation | boolean | Copy the reference actor's rotation too. Valor predeterminado true. |
name | string | |
folder | string |
Devuelve: actor, message.
actor.spawn_camera (riesgo 2, modifica, requiere mundo, smoke)
Spawns a CameraActor or a CineCameraActor.
| Argumento | Tipo | Descripción |
|---|---|---|
name | string | |
location | {x,y,z} | |
rotation | {x,y,z} | |
fov | number | Horizontal field of view in degrees (ignored for cine cameras). Valor predeterminado 90.0. |
cine | boolean | Spawn a CineCameraActor instead of a plain CameraActor. Valor predeterminado false. |
aspect | number | Constrained aspect ratio; 0 leaves the default. Valor predeterminado 0.0. |
folder | string |
Devuelve: actor, message.
actor.spawn_circle (riesgo 2, modifica, requiere mundo, smoke)
Spawns actors evenly spaced on a horizontal circle.
| Argumento | Tipo | Descripción |
|---|---|---|
class | string | |
mesh | string | |
count | integer | obligatorio. How many actors to place on the circle. |
radius | number | obligatorio. Circle radius in centimetres. |
center | {x,y,z} | |
faceCenter | boolean | Rotate every actor so that +X points at the centre. Valor predeterminado false. |
namePrefix | string | |
folder | string |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
material | string | Material or material instance to project; optional, assign it later with actor.set_decal. |
name | string | |
location | {x,y,z} | |
rotation | {x,y,z} | |
size | {x,y,z} | Decal box extent; (0,0,0) keeps the default. |
sortOrder | integer | Valor predeterminado 0. |
folder | string |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
name | string | |
location | {x,y,z} | |
rotation | {x,y,z} | |
folder | string |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
class | string | Class or Blueprint to spawn; leave empty and set "mesh" to spawn static mesh actors. |
mesh | string | StaticMesh asset path; used when "class" is empty. |
rows | integer | obligatorio. |
columns | integer | obligatorio. |
spacing | number | obligatorio. Distance between neighbours in centimetres. |
origin | {x,y,z} | World location of the first element. |
namePrefix | string | Label prefix; the index is appended ("Grid_0_0"). |
folder | string |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
specs | array of UeaActSpawnSpec | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
mesh | string | obligatorio. StaticMesh or SkeletalMesh asset path (e.g. "/Engine/BasicShapes/Cube"). |
name | string | |
location | {x,y,z} | |
rotation | {x,y,z} | |
scale | {x,y,z} | |
folder | string | |
tags | array of string | |
material | string | Material applied to every slot. |
mobility | string | Static, Stationary or Movable (default Static for static meshes). |
select | boolean | Valor predeterminado false. |
Devuelve: actor, message.
actor.spawn_player_start (riesgo 2, modifica, requiere mundo, smoke)
Spawns a PlayerStart.
| Argumento | Tipo | Descripción |
|---|---|---|
name | string | |
location | {x,y,z} | |
rotation | {x,y,z} | |
tag | string | Player start tag ("Player0"). |
folder | string |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
class | string | |
mesh | string | |
count | integer | obligatorio. |
min | {x,y,z} | obligatorio. |
max | {x,y,z} | obligatorio. |
randomYaw | boolean | Give every actor a random yaw. Valor predeterminado false. |
seed | integer | Random seed; 0 picks a time-based seed. Valor predeterminado 0. |
namePrefix | string | |
folder | string |
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.
| Argumento | Tipo | Descripción |
|---|---|---|
sound | string | SoundBase asset (SoundCue, SoundWave, MetaSound); optional, assign it later with actor.set_sound. |
name | string | |
location | {x,y,z} | |
autoActivate | boolean | Valor predeterminado true. |
volume | number | Volume multiplier (1 = unchanged). Valor predeterminado 1.0. |
folder | string |
Devuelve: actor, message.
actor.spawn_text (riesgo 2, modifica, requiere mundo, smoke)
Spawns a TextRenderActor showing a string.
| Argumento | Tipo | Descripción |
|---|---|---|
text | string | obligatorio. |
name | string | |
location | {x,y,z} | |
rotation | {x,y,z} | |
size | number | World size of the glyphs (default 26). Valor predeterminado 26.0. |
color | string | Colour as "R,G,B" or "R,G,B,A" with components in 0..1. |
folder | string |
Devuelve: actor, message.
actor.sweep_box (riesgo 0, requiere mundo, smoke)
Box sweep against the editor world.
| Argumento | Tipo | Descripción |
|---|---|---|
start | {x,y,z} | obligatorio. |
end | {x,y,z} | obligatorio. |
extent | {x,y,z} | obligatorio. Half-extent of the swept box in centimetres. |
channel | string | |
ignore | array 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | obligatorio. |
Devuelve: message, count, items.
actor.unlock_group (riesgo 1, modifica, requiere mundo, smoke)
Unlocks a group so its members can be selected individually.
| Argumento | Tipo | Descripción |
|---|---|---|
group | string | obligatorio. 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.
| Argumento | Tipo | Descripción |
|---|---|---|
actors | array of string | Actors to validate; empty validates the whole level. |
Devuelve: issues, errors, warnings, checked, message.