Player

This page describes the player API

Get players

playerList()

Retrieves all online player IDs.

Details

Remarks

Arguments

Type	Description

Returns

Player IDs collection.

Example

Spawn

playerSpawn(player)

Spawns the player.

Details

Remarks

Subsequent calls will re-spawn the player.

Make sure you set health to a valid value, since Spawn method doesn't take care of that.

Arguments

Type	Description
player	Player ID

Returns

0 if successful, -1 if failed

Example

​Despawn

playerDespawn(player)

Removes the player from the map.

Details

Remarks

Useful when you want to create a spectator mode in your game.

Arguments

Type	Description
player	Player ID

Returns

0 if successful, -1 if failed

Example

Invalid

playerInvalid(player)

Checks whether the player ID is invalid.

Details

Remarks

None.

Arguments

Type	Description
player	Player ID

Returns

0 if invalid

Example

Kick

playerKick(player, string)

Kicks the player from the game.

Details

Remarks

Useful when you want to create a spectator mode in your game.

Arguments

Type	Description
player	Player ID
string	Reason

Returns

0 if successful, -1 if failed

Example

Kill

playerKill(player)

Force kills the player.

Details

Remarks

Kills the player naturally.

Arguments

Type	Description
player	Player ID

Returns

0 if successful, -1 if failed

Example

Play anim

playerDespawn(player, string)

Removes the player from the map.

Details

Remarks

There is no animation list provided, search game folder for possible animation names.

Arguments

Type	Description
player	Player ID
string	Animation file name

Returns

0 if successful, -1 if failed

Example

Set model

playerModelSet(player, string)

Changes the player model.

Details

Remarks

You can use models from the following listing.

Arguments

Type	Description
player	Player ID
string	Model name

Returns

0 if successful, -1 if failed

Example

Set health

playerHealthSet(player, float)

Sets the player health.

Details

Remarks

At the moment, this method expects a raw value the game uses to specify health. Maximum health is based off of the mission data, so some maps use value 200, while others can be over 600.

We will make sure health is uniform on the server-side, but right now, you need to set health to 200 if you want full health on freeride map.

Arguments

Type	Description
player	Player ID
float	Health value

Returns

0 if successful, -1 if failed

Example

Set position

playerPositionSet(player, vec3)

Sets the player position.

Details

Remarks

None.

Arguments

Type	Description
player	Player ID
vec3	Array of 3 float values

Returns

0 if successful, -1 if failed

Example

Set direction

playerDirectionSet(player, vec3)

Sets the player's forward direction vector.

Details

Remarks

None.

Arguments

Type	Description
player	Player ID
vec3	Array of 3 float values

Returns

0 if successful, -1 if failed

Example

Set heading

playerHeadingSet(player, float)

Sets the player heading angle.

Details

Remarks

Uses a ±180 degree format.

Arguments

Type	Description
player	Player ID
float	±180 degree angle

Returns

0 if successful, -1 if failed

Example

Get name

playerNameGet(player)

Retrieves the player name.

Details

Remarks

None.

Arguments

Type	Description
player	Player ID

Returns

string player name

Example

Get model

playerModelGet(player)

Retrieves the player's model.

Details

Remarks

None.

Arguments

Type	Description
player	Player ID

Returns

string player model name

Example

Get health

playerHealthGet(player)

Retrieves the current player's health.

Details

Remarks

At the moment, this method returns a raw value the game uses to specify health. Maximum health is based off of the mission data, so some maps use value 200, while others can be over 600.

We will make sure health is uniform on the server-side, but right now, you need to be aware that full health differs per mission and freeride uses value of 200.

Arguments

Type	Description
player	Player ID

Returns

float player health

Example

Get heading

playerHeadingGet(player)

Retrieves the player's heading angle.

Details

Remarks

Uses a ±180 degree format.

Arguments

Type	Description
player	Player ID

Returns

float heading angle

Example

Get position

playerPositionGet(player)

Retrieves the player position.

Details

Remarks

None.

Arguments

Type	Description
player	Player ID

Returns

vec3 array of 3 float values

Example

Get direction

playerDirectionGet(player)

Retrieves the player direction.

Details

Remarks

Retrieves the player's forward vector direction.

Arguments

Type	Description
player	Player ID

Returns

vec3 array of 3 float values

Example

Visibility

There are several visibility options you can set for the player:

Name	Description
VISIBILITY_NAME	Player nameplate visibility
VISIBILITY_ICON	Player's blip visibility on the map

Get visibility

playerVisibilityGet(player, visibility_type)

Retrieves the current player's visibility.

Details

Remarks

None.

Arguments

Type	Description
player	Player ID
visibility_type	Visibility option

Returns

int player visibility option value

Example

Set visibility

playerVisibilitySet(player, visibility_type, int)

Sets the current player's visibility setting.

Details

Remarks

None.

Arguments

Type	Description
player	Player ID
visibility_type	Visibility option
int	Visibility state

Returns

0 if successful

Example