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🧑‍💻API Source

👪Base Class

This is a Base Class, an abstract definition that shares common methods and events with it's child classes. You cannot spawn it, and you cannot call anything on the Base Class name itself. Use any class that inherits it.

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.

---

🗿 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())
	float	GetAngularVelocity	Returns the angular velocity of this Actor
	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
	float	GetMass	Returns the mass of this Actor
	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
		SetDistanceOptimizationMultiplier	Sets this Actor's distance optimization multiplier
		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

---

Optimal

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.

---

Optimal

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

---

Optimal

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

---

Moderate

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	if it was attached successfully

---

Optimal

Detach

Detaches this Actor from AttachedTo Actor

my_actor:Detach()

---

Moderate

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.

---

Optimal

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.

---

Optimal

GetAngularVelocity

Returns the angular velocity of this Actor

local angular_velocity = my_actor:GetAngularVelocity()

Returns

Type	Description
float	angular_velocity

---

Moderate

GetAttachedEntities

Gets all Actors attached to this Actor

local ret = my_actor:GetAttachedEntities(recursively?)

Parameters

Type	Parameter	Default	Description
boolean	recursively?	false	Also returns the Actors attached to the attached Actors

Returns

Type	Description
table of Base Actor	No description provided

---

Optimal

GetAttachedTo

Gets the Actor this Actor is attached to

local ret = my_actor:GetAttachedTo()

Returns

Type	Description
Base Actor or nil	No description provided

---

Moderate

GetBounds

Gets this Actor's bounds

local ret = my_actor:GetBounds()

Returns

Type	Description
table	with this format

---

Optimal

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.

---

Optimal

GetDimension

Obtém a dimensão deste ator

local dimension = my_actor:GetDimension()

Returns

Type	Description
integer	dimension

See also SetDimension, DimensionChange.

---

Optimal

GetDistanceFromCamera

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

local ret = my_actor:GetDistanceFromCamera()

Returns

Type	Description
float	No description provided

---

Optimal

GetForce

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

local force = my_actor:GetForce()

Returns

Type	Description
Vector	force

See also SetForce.

---

Optimal

GetLocation

Gets this Actor's location in the game world

local location = my_actor:GetLocation()

Returns

Type	Description
Vector	location

See also SetLocation.

---

Optimal

GetMass

Returns the mass of this Actor

local mass = my_actor:GetMass()

Returns

Type	Description
float	mass

---

Optimal

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.

---

Optimal

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.

---

Optimal

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.

---

Optimal

GetRotation

Gets this Actor's angle in the game world

local rotation = my_actor:GetRotation()

Returns

Type	Description
Rotator	rotation

See also SetRotation.

---

Optimal

GetScale

Gets this Actor's scale

local scale = my_actor:GetScale()

Returns

Type	Description
Vector	scale

See also SetScale.

---

Optimal

GetScreenPercentage

Gets the percentage of this Actor size in the screen

local ret = my_actor:GetScreenPercentage()

Returns

Type	Description
float	No description provided

---

Moderate

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

---

Optimal

GetVelocity

Gets this Actor's current velocity

local velocity = my_actor:GetVelocity()

Returns

Type	Description
Vector	velocity

---

Optimal

HasNetworkAuthority

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

local has_network_authority = my_actor:HasNetworkAuthority()

Returns

Type	Description
boolean	has_network_authority

---

Optimal

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.

---

Optimal

IsInWater

Returns true if this Actor is in water. Only Actors that simulate physics work for this function, such as Prop, Vehicle, Pickables and Character only.

local in_water = my_actor:IsInWater()

Returns

Type	Description
boolean	in_water

---

Optimal

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.

---

Optimal

IsVisible

Returns true if this Actor is visible

local is_visible = my_actor:IsVisible()

Returns

Type	Description
boolean	is_visible

---

Optimal

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.

---

Optimal

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

---

Optimal

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.

---

Moderate

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

---

Optimal

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.

---

Moderate

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.

---

Optimal

SetDistanceOptimizationMultiplier

Sets this Actor's distance optimization multiplier.
A value of 0 disables optimization. Values under 1 decrease the effect, while values over 1 increase it

my_actor:SetDistanceOptimizationMultiplier(multiplier)

Parameters

Type	Parameter	Default	Description
float	multiplier	Required parameter	No description provided

---

Optimal

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.

---

Optimal

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.

---

Optimal

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().

---

Optimal

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

---

Moderate

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.

---

Moderate

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, NetworkAuthorityChange.

---

Optimal

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.

---

Optimal

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().

---

Moderate

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.

---

Moderate

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.

---

Moderate

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

---

Moderate

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.

---

Slow

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.

---

Optimal

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

---

Optimal

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

---

Moderate

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 its dimension
	EnterWater	Triggered when an Actor enters a water body
	LeaveWater	Triggered when an Actor leaves a water body
	NetworkAuthorityChange	Triggered when an Actor changes its network authority Player
	NetworkAuthorityChange	Triggered when the local Player gets/loses network authority over this actor

---

DimensionChange

Triggered when an Actor changes its dimension

<AnyActorClass>.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.

---

EnterWater

Triggered when an Actor enters a water body. Only Actors that simulate physics trigger this event, such as Prop, Vehicle, Pickables and Character only.

<AnyActorClass>.Subscribe("EnterWater", function(self)
	-- EnterWater was called
end)

Arguments

Type	Argument	Description
Base Actor	self	No description provided

See also IsInWater.

---

LeaveWater

Triggered when an Actor leaves a water body. Only Actors that simulate physics trigger this event, such as Prop, Vehicle, Pickables and Character only.

<AnyActorClass>.Subscribe("LeaveWater", function(self)
	-- LeaveWater was called
end)

Arguments

Type	Argument	Description
Base Actor	self	No description provided

See also IsInWater.

---

NetworkAuthorityChange

Triggered when an Actor changes its network authority Player

<AnyActorClass>.Subscribe("NetworkAuthorityChange", function(self, old_network_authority, new_network_authority)
	-- NetworkAuthorityChange was called
end)

Arguments

Type	Argument	Description
Base Actor	self	No description provided
Player or nil	old_network_authority	The old Network Authority Player, if any
Player or nil	new_network_authority	The new Network Authority Player, if any

See also SetNetworkAuthority, GetNetworkAuthority.

---

NetworkAuthorityChange

Triggered when the local Player gets/loses network authority over this actor

<AnyActorClass>.Subscribe("NetworkAuthorityChange", function(self, is_network_authority)
	-- NetworkAuthorityChange was called
end)

Arguments

Type	Argument	Description
Base Actor	self	No description provided
boolean	is_network_authority	Whether the local Player is now the Network Authority of this Actor

See also SetNetworkAuthority, GetNetworkAuthority.