editor.actor

Actor manipulation (spawn, destroy, transform, properties)

`editor.actor.spawn`

Spawns a new actor of the given class in the editor world.

Parameters:

Name	Type	Required	Description
`class`	string	Yes	Actor class name (e.g. "StaticMeshActor", "PointLight")
`location`	object	No	{x, y, z} spawn location (default 0,0,0)
`rotation`	object	No	{pitch, yaw, roll} spawn rotation (default 0,0,0)

Returns:

Name	Type	Description
`success`	bool	Whether spawn succeeded
`name`	string	Actor display label
`class`	string	Actual class name
`path`	string	Full object path

Example Request:

{
  "jsonrpc": "2.0", "id": 1, "method": "editor.actor.spawn",
  "params": { "class": "PointLight", "location": { "x": 100, "y": 0, "z": 200 } }
}

Example Response:

{
  "jsonrpc": "2.0", "id": 1,
  "result": { "success": true, "name": "PointLight", "class": "PointLight", "path": "/Game/Maps/Level.Level:PersistentLevel.PointLight_0" }
}

`editor.actor.destroy`

Destroys an actor by its object path.

Parameters:

Name	Type	Required	Description
`path`	string	Yes	Full actor object path

Returns:

Name	Type	Description
`success`	bool	Whether destruction succeeded

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.actor.destroy", "params": { "path": "/Game/Maps/Level.Level:PersistentLevel.PointLight_0" } }

`editor.actor.select`

Selects an actor by path, optionally adding to existing selection.

Parameters:

Name	Type	Required	Description
`path`	string	Yes	Full actor object path
`add_to_selection`	bool	No	If true, add to selection instead of replacing (default false)

Returns:

Name	Type	Description
`success`	bool	Whether selection succeeded
`name`	string	Actor display label
`path`	string	Actor path

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.actor.select", "params": { "path": "/Game/Maps/Level.Level:PersistentLevel.Cube" } }

`editor.actor.selectAll`

Selects all actors in the current level.

No parameters.

Returns:

Name	Type	Description
`success`	bool	Always true
`count`	number	Number of actors selected

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.actor.selectAll" }

`editor.actor.deselectAll`

Clears the actor selection.

No parameters.

Returns:

Name	Type	Description
`success`	bool	Always true

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.actor.deselectAll" }

`editor.actor.getTransform`

Returns the world transform (location, rotation, scale) of an actor.

Parameters:

Name	Type	Required	Description
`path`	string	Yes	Full actor object path

Returns:

Name	Type	Description
`location`	object	{x, y, z}
`rotation`	object	{pitch, yaw, roll}
`scale`	object	{x, y, z}
`name`	string	Actor display label

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.actor.getTransform", "params": { "path": "/Game/Maps/Level.Level:PersistentLevel.Cube" } }

`editor.actor.setTransform`

Sets the location, rotation, and/or scale of an actor. Only provided fields are changed.

Parameters:

Name	Type	Required	Description
`path`	string	Yes	Full actor object path
`location`	object	No	{x, y, z} new location
`rotation`	object	No	{pitch, yaw, roll} new rotation
`scale`	object	No	{x, y, z} new scale

Returns:

Name	Type	Description
`success`	bool	Whether transform was applied
`name`	string	Actor display label

Example Request:

{
  "jsonrpc": "2.0", "id": 1, "method": "editor.actor.setTransform",
  "params": { "path": "/Game/Maps/Level.Level:PersistentLevel.Cube", "location": { "x": 500, "y": 0, "z": 100 } }
}

`editor.actor.getProperties`

Returns UProperty values for an actor.

Parameters:

Name	Type	Required	Description
`path`	string	Yes	Full actor object path
`editable_only`	bool	No	Only return EditAnywhere/VisibleAnywhere properties (default true)

Returns:

Name	Type	Description
`actor`	string	Actor display label
`class`	string	Actor class name
`count`	number	Number of properties returned
`properties`	array	Each: {name, type, value}

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.actor.getProperties", "params": { "path": "/Game/Maps/Level.Level:PersistentLevel.Cube" } }

`editor.actor.setProperty`

Sets a single UProperty value on an actor using UE text import format.

Parameters:

Name	Type	Required	Description
`path`	string	Yes	Full actor object path
`property`	string	Yes	Property name
`value`	string	Yes	Value in UE text format (e.g. "(R=1.0,G=0.0,B=0.0,A=1.0)")

Returns:

Name	Type	Description
`success`	bool	Whether property was set
`property`	string	Property name
`value`	string	Value that was set

Example Request:

{
  "jsonrpc": "2.0", "id": 1, "method": "editor.actor.setProperty",
  "params": { "path": "/Game/Maps/Level.Level:PersistentLevel.PointLight_0", "property": "Intensity", "value": "5000.0" }
}

`editor.actor.duplicate`

Duplicates an actor, optionally with a position offset.

Parameters:

Name	Type	Required	Description
`path`	string	Yes	Full actor object path
`offset`	object	No	{x, y, z} offset from original (default 0,0,0)

Returns:

Name	Type	Description
`success`	bool	Whether duplication succeeded
`name`	string	Duplicated actor display label
`class`	string	Duplicated actor class name
`path`	string	Full object path of the new actor

Example Request:

{
  "jsonrpc": "2.0", "id": 1, "method": "editor.actor.duplicate",
  "params": { "path": "/Game/Maps/Level.Level:PersistentLevel.Cube", "offset": { "x": 200, "y": 0, "z": 0 } }
}

`editor.actor.getComponents`

Returns all components attached to an actor.

Parameters:

Name	Type	Required	Description
`path`	string	Yes	Full actor object path

Returns:

Name	Type	Description
`actor`	string	Actor display label
`count`	number	Number of components
`components`	array	Each: {name, class, is_scene_component, relative_location?, is_root?}

Example Request:

{ "jsonrpc": "2.0", "id": 1, "method": "editor.actor.getComponents", "params": { "path": "/Game/Maps/Level.Level:PersistentLevel.Cube" } }

`editor.actor.addComponent`

Adds a new component of the specified class to an actor.

Parameters:

Name	Type	Required	Description
`path`	string	Yes	Full actor object path
`class`	string	Yes	Component class name (e.g. "PointLightComponent", "AudioComponent")

Returns:

Name	Type	Description
`success`	bool	Whether component was added
`name`	string	New component instance name
`class`	string	Component class name

Example Request:

{
  "jsonrpc": "2.0", "id": 1, "method": "editor.actor.addComponent",
  "params": { "path": "/Game/Maps/Level.Level:PersistentLevel.Cube", "class": "PointLightComponent" }
}