Base Actor

An Actor is an object which can be spawned and destroyed through Lua.
Actors support 3D transformations such as translation (location), rotation, and scale.

An Actor is the base for several entities, and all those entities share the same Methods and Events described in this page.

👪Base Class

This is a Base Class. Base Classes are abstract definitions used to share common methods and events between related child classes, thus you cannot spawn it directly.

Classes that share methods and events from this Base Class: Billboard, Blueprint, Cable, Character, CharacterSimple, Decal, Gizmo, Grenade, InstancedStaticMesh, Light, Melee, Particle, Prop, SceneCapture, StaticMesh, Sound, TextRender, Text3D, Trigger, VehicleWheeled, VehicleWater, Weapon, Widget3D.

🧑‍💻API Source

This page is auto-generated! The Functions, Properties and Events described here are defined in our GitHub's API Repository! Feel free to commit suggestions and changes to the source .json API files!

---

🗿 Static Functions

This class doesn't have own static functions.

🦠 Functions

caution

Some of the following methods may not work on certain Actor classes.

	Returns	Name	Description
		AddActorTag	Adiciona uma Unreal Actor Tag neste Ator
		AddAngularImpulse	Realiza um impulso angular neste Actor. Bom por um impulso instantâneo
		AddImpulse	Add an impulse to this Actor. Good for one time instant burst
	boolean	AttachTo	Attaches this Actor to any other Actor, optionally at a specific bone
		Detach	Detaches this Actor from AttachedTo Actor
	table of string	GetActorTags	Gets all Unreal Actor Tags on this Actor
	Vector	GetAngularForce	Gets this Actor's angular force (set by SetAngularForce())
	table of Base Actor	GetAttachedEntities	Gets all Actors attached to this Actor
	Base Actor or nil	GetAttachedTo	Gets the Actor this Actor is attached to
	table	GetBounds	Gets this Actor's bounds
	CollisionType	GetCollision	Obtém o tipo de colisão deste ator
	integer	GetDimension	Obtém a dimensão deste ator
	float	GetDistanceFromCamera	Obtém a distância deste Ator da Câmera
	Vector	GetForce	Gets this Actor's force (set by SetForce())
	Vector	GetLocation	Gets this Actor's location in the game world
	Player or nil	GetNetworkAuthority	Gets this Actor's Network Authority Player
	Vector	GetRelativeLocation	Gets this Actor's Relative Location if it's attached
	Rotator	GetRelativeRotation	Gets this Actor's Relative Rotation if it's attached
	Rotator	GetRotation	Gets this Actor's angle in the game world
	Vector	GetScale	Gets this Actor's scale
	float	GetScreenPercentage	Gets the percentage of this Actor size in the screen
	table	GetSocketTransform	Gets a Socket Transform in world space given a bone or socket name
	Vector	GetVelocity	Gets this Actor's current velocity
	boolean	HasNetworkAuthority	Returns true if the local Player is currently the Network Authority of this Actor
	boolean	IsGravityEnabled	Returns true if gravity is enabled on this Actor
	boolean	IsInWater	Returns true if this Actor is in water
	boolean	IsNetworkDistributed	Returns true if this Actor is currently network distributed
	boolean	IsVisible	Returns true if this Actor is visible
		RemoveActorTag	Removes an Unreal Actor Tag from this Actor
		RotateTo	Smoothly rotates this actor to an angle over a certain time
		SetAngularForce	Adds a permanent angular force to this Actor, set to Vector(0, 0, 0) to cancel
		SetCastShadow	Sets this Actor's to cast shadows or not
		SetCollision	Sets this Actor's collision type
		SetDimension	Sets this Actor's Dimension
		SetForce	Adds a permanent force to this Actor, set to Vector(0, 0, 0) to cancel
		SetGravityEnabled	Sets whether gravity is enabled on this Actor
		SetHighlightEnabled	Sets whether the highlight is enabled on this Actor, and which highlight index to use
		SetLifeSpan	Sets the time (in seconds) before this Actor is destroyed. After this time has passed, the actor will be automatically destroyed.
		SetLocation	Sets this Actor's location in the game world
		SetNetworkAuthority	Sets the Player to have network authority over this Actor
		SetNetworkAuthorityAutoDistributed	Sets if this Actor will auto distribute the network authority between players
		SetOutlineEnabled	Sets whether the outline is enabled on this Actor, and which outline index to use
		SetRelativeLocation	Sets this Actor's relative location in local space (only if this actor is attached)
		SetRelativeRotation	Sets this Actor's relative rotation in local space (only if this actor is attached)
		SetRenderCullDistance	Sets this Actor's render cull distance
		SetRotation	Sets this Actor's rotation in the game world
		SetScale	Sets this Actor's scale
		SetVisibility	Sets whether the actor is visible or not
		TranslateTo	Smoothly moves this actor to a location over a certain time
	boolean	WasRecentlyRendered	Gets if this Actor was recently rendered on screen

---

AddActorTag

Adiciona uma Unreal Actor Tag neste Ator

my_actor:AddActorTag(tag)

Parameters

Type	Parameter	Default	Description
string	tag	Required parameter	No description provided

See also RemoveActorTag, GetActorTags.

---

AddAngularImpulse

Realiza um impulso angular neste Actor. Bom por um impulso instantâneo

my_actor:AddAngularImpulse(angular_impulse, velocity_change?)

Parameters

Type	Parameter	Default	Description
Vector	angular_impulse	Required parameter	Magnitude and direction of impulse to apply. Direction is axis of rotation. In Radians
boolean	velocity_change?	false	Whether to ignore mass

---

AddImpulse

Add an impulse to this Actor. Good for one time instant burst

my_actor:AddImpulse(impulse, velocity_change?)

Parameters

Type	Parameter	Default	Description
Vector	impulse	Required parameter	Magnitude and direction of impulse to apply
boolean	velocity_change?	false	Whether to ignore mass

---

AttachTo

Attaches this Actor to any other Actor, optionally at a specific bone

local attached_successfully = my_actor:AttachTo(other, attachment_rule?, bone_name?, lifespan_when_detached?, use_absolute_rotation?)

Parameters

Type	Parameter	Default	Description
Base Actor	other	Required parameter	Other actor to attach
AttachmentRule	attachment_rule?	SnapToTarget	How to attach
string	bone_name?		Which bone to attach to. If empty it will be attached to the Actor, otherwise to the Mesh at the bone/socket
float	lifespan_when_detached?	-1	Seconds before destroying this Actor when detached, setting it to 0 will automatically destroy this actor when detached, setting it to 10 will destroy this after 10 seconds when detached
boolean	use_absolute_rotation?	false	Whether to force attached object to use absolute rotation (will not follow parent)

Returns

Type	Description
boolean	se foi attachado com sucesso

---

Detach

Detaches this Actor from AttachedTo Actor

my_actor:Detach()

---

GetActorTags

Gets all Unreal Actor Tags on this Actor

local ret = my_actor:GetActorTags()

Returns

Type	Description
table of string	No description provided

See also AddActorTag, RemoveActorTag.

---

GetAngularForce

Gets this Actor's angular force (set by SetAngularForce())

local angular_force = my_actor:GetAngularForce()

Returns

Type	Description
Vector	angular_force

See also SetAngularForce.

---

GetAttachedEntities

Gets all Actors attached to this Actor

local ret = my_actor:GetAttachedEntities()

Returns

Type	Description
table of Base Actor	No description provided

---

GetAttachedTo

Gets the Actor this Actor is attached to

local ret = my_actor:GetAttachedTo()

Returns

Type	Description
Base Actor or nil	No description provided

---

GetBounds

Gets this Actor's bounds

local ret = my_actor:GetBounds()

Returns

Type	Description
table	with this format

---

GetCollision

Obtém o tipo de colisão deste ator

local collision_type = my_actor:GetCollision()

Returns

Type	Description
CollisionType	collision_type

See also SetCollision.

---

GetDimension

Obtém a dimensão deste ator

local dimension = my_actor:GetDimension()

Returns

Type	Description
integer	dimension

See also SetDimension, DimensionChange.

---

GetDistanceFromCamera

Obtém a distância deste Ator da Câmera

local ret = my_actor:GetDistanceFromCamera()

Returns

Type	Description
float	No description provided

---

GetForce

Gets this Actor's force (set by SetForce())

local force = my_actor:GetForce()

Returns

Type	Description
Vector	force

See also SetForce.

---

GetLocation

Gets this Actor's location in the game world

local location = my_actor:GetLocation()

Returns

Type	Description
Vector	location

See also SetLocation.

---

GetNetworkAuthority

Gets this Actor's Network Authority Player

local ret = my_actor:GetNetworkAuthority()

Returns

Type	Description
Player or nil	No description provided

See also SetNetworkAuthority.

---

GetRelativeLocation

Gets this Actor's Relative Location if it's attached

local relative_location = my_actor:GetRelativeLocation()

Returns

Type	Description
Vector	relative_location

See also SetRelativeLocation.

---

GetRelativeRotation

Gets this Actor's Relative Rotation if it's attached

local relative_rotation = my_actor:GetRelativeRotation()

Returns

Type	Description
Rotator	relative_rotation

See also SetRelativeRotation.

---

GetRotation

Gets this Actor's angle in the game world

local rotation = my_actor:GetRotation()

Returns

Type	Description
Rotator	rotation

See also SetRotation.

---

GetScale

Gets this Actor's scale

local scale = my_actor:GetScale()

Returns

Type	Description
Vector	scale

See also SetScale.

---

GetScreenPercentage

Gets the percentage of this Actor size in the screen

local ret = my_actor:GetScreenPercentage()

Returns

Type	Description
float	No description provided

---

GetSocketTransform

Gets a Socket Transform in world space given a bone or socket name

local ret = my_actor:GetSocketTransform(socket_name)

Parameters

Type	Parameter	Default	Description
string	socket_name	Required parameter	No description provided

Returns

Type	Description
table	with this format

---

GetVelocity

Gets this Actor's current velocity

local velocity = my_actor:GetVelocity()

Returns

Type	Description
Vector	velocity

---

HasNetworkAuthority

Returns true if the local Player is currently the Network Authority of this Actor

local ret = my_actor:HasNetworkAuthority()

Returns

Type	Description
boolean	No description provided

---

IsGravityEnabled

Returns true if gravity is enabled on this Actor

local gravity_enabled = my_actor:IsGravityEnabled()

Returns

Type	Description
boolean	gravity_enabled

See also SetGravityEnabled.

---

IsInWater

Returns true if this Actor is in water

local ret = my_actor:IsInWater()

Returns

Type	Description
boolean	No description provided

---

IsNetworkDistributed

Returns true if this Actor is currently network distributed. Only actors being network distributed can have their network authority set
Entities have NetworkDistributed automatically disabled when: Attached, Possessed, Grabbed, Picked Up or Driving

local ret = my_actor:IsNetworkDistributed()

Returns

Type	Description
boolean	No description provided

See also SetNetworkAuthorityAutoDistributed, SetNetworkAuthority.

---

IsVisible

Returns true if this Actor is visible

local is_visible = my_actor:IsVisible()

Returns

Type	Description
boolean	is_visible

---

RemoveActorTag

Removes an Unreal Actor Tag from this Actor

my_actor:RemoveActorTag(tag)

Parameters

Type	Parameter	Default	Description
string	tag	Required parameter	No description provided

See also AddActorTag, GetActorTags.

---

RotateTo

Smoothly rotates this actor to an angle over a certain time

my_actor:RotateTo(rotation, time, exp?)

Parameters

Type	Parameter	Default	Description
Rotator	rotation	Required parameter	No description provided
float	time	Required parameter	Time to interpolate from current location to target location
float	exp?	0	Exponent used to smooth interpolation. Use 0 for linear movement

---

SetAngularForce

Adds a permanent angular force to this Actor, set to Vector(0, 0, 0) to cancel

my_actor:SetAngularForce(angular_force)

Parameters

Type	Parameter	Default	Description
Vector	angular_force	Required parameter	No description provided

See also GetAngularForce.

---

SetCastShadow

Sets this Actor's to cast shadows or not

my_actor:SetCastShadow(cast_shadow)

Parameters

Type	Parameter	Default	Description
boolean	cast_shadow	Required parameter	No description provided

---

SetCollision

Sets this Actor's collision type

my_actor:SetCollision(collision_type)

Parameters

Type	Parameter	Default	Description
CollisionType	collision_type	Required parameter	No description provided

See also GetCollision.

---

SetDimension

Sets this Actor's Dimension

my_actor:SetDimension(dimension)

Parameters

Type	Parameter	Default	Description
integer	dimension	Required parameter	No description provided

See also GetDimension, DimensionChange.

---

SetForce

Adds a permanent force to this Actor, set to Vector(0, 0, 0) to cancel

my_actor:SetForce(force, is_local?)

Parameters

Type	Parameter	Default	Description
Vector	force	Required parameter	No description provided
boolean	is_local?	true	Whether to apply the force in local space

See also GetForce.

---

SetGravityEnabled

Sets whether gravity is enabled on this Actor

my_actor:SetGravityEnabled(gravity_enabled)

Parameters

Type	Parameter	Default	Description
boolean	gravity_enabled	Required parameter	No description provided

See also IsGravityEnabled.

---

SetHighlightEnabled

Sets whether the highlight is enabled on this Actor, and which highlight index to use. This will apply the highlight on every attached entity too

my_actor:SetHighlightEnabled(is_enabled, index?)

Parameters

Type	Parameter	Default	Description
boolean	is_enabled	Required parameter	No description provided
integer	index?	0	Index to use (should be 0, 1 or 2)

See also Client.SetHighlightColor().

---

SetLifeSpan

Sets the time (in seconds) before this Actor is destroyed. After this time has passed, the actor will be automatically destroyed.

my_actor:SetLifeSpan(seconds)

Parameters

Type	Parameter	Default	Description
float	seconds	Required parameter	Seconds before being destroyed

---

SetLocation

Sets this Actor's location in the game world

my_actor:SetLocation(location)

Parameters

Type	Parameter	Default	Description
Vector	location	Required parameter	No description provided

See also GetLocation.

---

SetNetworkAuthority

Sets the Player to have network authority over this Actor. This Player will be manually assigned to handle this Actor's physics and share its location with other clients. The authority assignment will still be overridden by the game automatically

Please refer to Network Authority for more information

my_actor:SetNetworkAuthority(player?)

Parameters

Type	Parameter	Default	Description
Player	player?	nil	New player which will assume the Network Authority of this Actor

See also SetNetworkAuthorityAutoDistributed, IsNetworkDistributed, GetNetworkAuthority.

---

SetNetworkAuthorityAutoDistributed

Sets if this Actor will auto distribute the network authority between players when idle

Please refer to Network Authority for more information

my_actor:SetNetworkAuthorityAutoDistributed(auto_distribute)

Parameters

Type	Parameter	Default	Description
boolean	auto_distribute	Required parameter	If this Actor will be auto network distributed

See also SetNetworkAuthority, IsNetworkDistributed.

---

SetOutlineEnabled

Sets whether the outline is enabled on this Actor, and which outline index to use. This will apply the outline on every attached entity too

my_actor:SetOutlineEnabled(is_enabled, index?)

Parameters

Type	Parameter	Default	Description
boolean	is_enabled	Required parameter	No description provided
integer	index?	0	Index to use (should be 0, 1 or 2)

See also Client.SetOutlineColor().

---

SetRelativeLocation

Sets this Actor's relative location in local space (only if this actor is attached)

my_actor:SetRelativeLocation(relative_location)

Parameters

Type	Parameter	Default	Description
Vector	relative_location	Required parameter	No description provided

See also GetRelativeLocation.

---

SetRelativeRotation

Sets this Actor's relative rotation in local space (only if this actor is attached)

my_actor:SetRelativeRotation(relative_rotation)

Parameters

Type	Parameter	Default	Description
Rotator	relative_rotation	Required parameter	No description provided

See also GetRelativeRotation.

---

SetRenderCullDistance

Sets this Actor's render cull distance. Note: this will only affect the rendering distance, the entity will still be spawned and synced normally regardless of this distance

my_actor:SetRenderCullDistance(max_distance)

Parameters

Type	Parameter	Default	Description
integer	max_distance	Required parameter	No description provided

---

SetRotation

Sets this Actor's rotation in the game world

my_actor:SetRotation(rotation)

Parameters

Type	Parameter	Default	Description
Rotator	rotation	Required parameter	No description provided

See also GetRotation.

---

SetScale

Sets this Actor's scale

my_actor:SetScale(scale)

Parameters

Type	Parameter	Default	Description
Vector	scale	Required parameter	No description provided

See also GetScale.

---

SetVisibility

Sets whether the actor is visible or not

my_actor:SetVisibility(is_visible)

Parameters

Type	Parameter	Default	Description
boolean	is_visible	Required parameter	No description provided

---

TranslateTo

Smoothly moves this actor to a location over a certain time

my_actor:TranslateTo(location, time, exp?)

Parameters

Type	Parameter	Default	Description
Vector	location	Required parameter	No description provided
float	time	Required parameter	Time to interpolate from current location to target location
float	exp?	0	Exponent used to smooth interpolation. Use 0 for linear movement

---

WasRecentlyRendered

Gets if this Actor was recently rendered on screen

local ret = my_actor:WasRecentlyRendered()

Returns

Type	Description
boolean	No description provided

🚀 Events

	Name	Description
	DimensionChange	Triggered when an Actor changes it's dimension

---

DimensionChange

Triggered when an Actor changes it's dimension

Actor.Subscribe("DimensionChange", function(self, old_dimension, new_dimension)
	-- DimensionChange was called
end)

Arguments

Type	Argument	Description
Base Actor	self	No description provided
integer	old_dimension	No description provided
integer	new_dimension	No description provided

See also SetDimension, GetDimension.