Skip to content

Entity Client

A library with useful functions to manage entity client side

JO Functions

jo.entity.create()

Create a new entity at specified location

Syntax

lua
jo.entity.create(model, coords, heading, networked, fadeDuration)

Parameters

model : string

The model name of the entity to create

coords : vector3

The coordinates where the entity will be created

heading : number

The heading direction for the entity

networked : boolean Optional

Whether the entity should be networked
default: false

fadeDuration : integer Optional

Duration of the fade-in effect in ms
default: 0

Return Value

Type : integer

The created entity ID

Example

lua
local entity = jo.entity.create('re_kidnappedvictim_females_01', vec3(1294.0, -512.3, 30.0), 90.0, true)
print(entity)

jo.entity.createWithMouse()

Create an entity that follows the mouse cursor for placement

Syntax

lua
jo.entity.createWithMouse(model, keepEntity, networked)

Parameters

model : string

The model name of the entity to create

keepEntity : boolean Optional

Whether to keep the entity after placement
default:true

networked : boolean Optional

Whether the entity should be networked
default:false

Return Value

Type : integer,vector3,number

The created entity ID, final position, final heading

Example

lua
local entityId, position, heading = jo.entity.createWithMouse('p_armchair01x', true, false)
print("Created entity: " .. entityId)
print("Position: " .. tostring(position))
print("Heading: " .. heading)

jo.entity.delete()

Delete an entity if it exists

Syntax

lua
jo.entity.delete(entity)

Parameters

entity : integer

The entity ID to delete

Example

lua
local entity = 23494
jo.entity.delete(entity)

jo.entity.fadeAndDelete()

Fade out an entity and then delete it

Syntax

lua
jo.entity.fadeAndDelete(entity, duration)

Parameters

entity : integer

The entity ID to fade and delete

duration : integer Optional

Duration of the fade effect in ms
default:1000

Example

lua
local entity = 32454
local duraiton = 1000
jo.entity.fadeAndDelete(entity, duration)

jo.entity.fadeIn()

Fade in an entity from transparent to fully visible

Syntax

lua
jo.entity.fadeIn(entity, duration)

Parameters

entity : integer

The entity ID to fade in

duration : integer Optional

Duration of the fade effect in ms
default:1000

Example

lua
local entity = 12345  -- Assume this is a valid entity ID
local duration = 2000 -- 2 seconds fade in time
jo.entity.fadeIn(entity, duration)

jo.entity.fadeOut()

Fade out an entity from visible to transparent

Syntax

lua
jo.entity.fadeOut(entity, duration)

Parameters

entity : integer

The entity ID to fade out

duration : integer Optional

Duration of the fade effect in ms - default:1000

Example

lua
local entity = 12345  -- Assume this is a valid entity ID
local duration = 2000 -- 2 seconds fade out time
jo.entity.fadeOut(entity, duration)

jo.entity.requestControl()



Request control of an entity and wait until it's granted

Syntax

lua
jo.entity.requestControl(entity)

Parameters

entity : integer

The entity ID to request control of

Example

lua
local entity = 23494
jo.entity.requestControl(entity)

Last updated: