Object - Meteor 2 Scripting Functions

int createObject(string objectName, vector2 pos, float angle, uint8 aiType, uint8 side, string overrideName, bool moving, bool locked, bool multiplayerRespawn)

Create an object.

int objectID = createObject(
    "Solider_Pvt_Rifle.ob",
    vector2(100, 100),
    0.0,
    AI_ROAMING,
    1,
    "",
    false,
    false,
    false
);
print("Created object " + objectID);

deleteObject

void deleteObject(int objectID)

Delete an object (server only).

// Delete object ID 10
deleteObject(10);

createObject

void setHidden(int objectID, bool value)

Set the hidden status of an object.

// Hide object ID 0
setHidden(0, true);

getHidden

bool getHidden(int objectID)

Get the hidden status of an object.

if (getHidden(0))
{
print("Object is hidden");
}
else
{
print("Object is visible");
}

setHidden

void showTeleport(int objectID)

Perform a teleport effect on an object.
This function:
- Plays a teleport sound effect.
- Shows the object.
- Damages objects underneath the object.

showTeleport(0);

uint8 getSide(int objectID)

Get the side of an object.

uint8 side = getSide(0);
print("Object is on side " + side);

setSide setSideID

void setSide(int objectID, uint8 side)

Set the side of an object.

// Set object ID 0 to side 1
setSide(0, 1);

getSide setSideID

float getHits(int objectID)

Get the hits (health) of an object.

float hits = getHits(0);
print("Object has " + hits + " health");

setHits

void setHits(int objectID, float hits)

Set the hits (health) of an object.

setHits(0, 500);

getHits

bool getIndestructible(int objectID)

Get the indestructible status of an object.

if (getIndestructible(0))
{
print("Object is indestructible");
}
else
{
print("Object is destructible");
}

setIndestructible

void setIndestructible(int objectID, bool indestructible)

Set the indestructible status of an object.

// Make object ID 0 indestructible
setIndestructible(0, true);

getIndestructible

float getSpeed(int objectID)

Get the current speed of an object.

float speed = getSpeed(PLAYER_OBJECT);
print("Player is moving at " + metresPerSecond + " km/h");

The speed is returned in kilometres per hour.

setSpeed getMaxSpeed

void setSpeed(int objectID, float speed)

Set the current speed of an object.

// Set the player speed to 50 km/h
setSpeed(PLAYER_OBJECT, 50.0f);

The speed is expected in kilometres per hour.

getSpeed setMaxSpeed

float getMaxSpeed(int objectID)

Get the maximum speed of an object.

float maxSpeed = getMaxSpeed(PLAYER_OBJECT);
print("Player maximum speed is " + maxSpeed + " km/h");

The maximum speed is returned in kilometres per hour.

setMaxSpeed getSpeed getDefaultMaxSpeed

void setMaxSpeed(int objectID, float speed)

Set the maximum speed of an object.

// Set the player maximum speed to 100 km/h
setMaxSpeed(PLAYER_OBJECT, 100.0f);

The maximum speed is expected in kilometres per hour.

getMaxSpeed setSpeed getDefaultMaxSpeed

float getDefaultMaxSpeed(int objectID)

Get the default maximum speed of an object.

float defaultMaxSpeed = getMaxSpeed(PLAYER_OBJECT);
print("Player default maximum speed is " + defaultMaxSpeed + " km/h");

The default maximum speed is returned in kilometres per hour.

getMaxSpeed getSpeed

uint8 getAiType(int objectID)

Get the AI type of an object.

uint8 aiType = getAiType(0);
print("Object AI type is " + aiType);

The possible values of aiType are AI_NONE, AI_ROAMING, AI_GUARDING, AI_IDLE and AI_GOTO.

setAiType

void setAiType(int objectID, uint8 aiType)

Set the AI type of an object.

setAiType(0, AI_GUARDING);

The possible values of aiType are AI_NONE, AI_ROAMING, AI_GUARDING, AI_IDLE and AI_GOTO.

getAiType

int getWanderChance(int objectID)

Get an object's wander chance (0 to 100).

print(getWanderChance(0));

setWanderChance

void setWanderChance(int objectID, int wanderChance)

Set an object's wander chance.

setWanderChance(0, 50);

wanderChance value must be between 0 (never wanders) and 100 (always wanders).

getWanderChance

bool getLocked(int objectID)

Get the locked status of an object.

if (getLocked(0))
{
print("Object is locked");
}
else
{
print("Object is unlocked");
}

setLocked

void setLocked(int objectID, bool locked)

Set the locked status of an object.

setLocked(0, true);

getLocked

bool getActive(int objectID)

Get the active status of an object.

if (getActive(0))
{
print("Object is active");
}
else
{
print("Object is inactive");
}

getForceActive setForceActive

bool getForceActive(int objectID)

Get the force active status of an object.

if (getForceActive(0))
{
print("Object is force active");
}
else
{
print("Object is not force active");
}

setForceActive getActive

void setForceActive(int objectID, bool forceActive)

Set the force active status of an object (server only).

setForceActive(0, true);

Setting forceActive prevents an object from sleeping when out of view.

getForceActive getActive

bool isEnemyNear(int objectID, float maxDistance=-1)

Determine if any enemies are nearby an object.

if (isEnemyNear(PLAYER_OBJECT))
{
print("One or more enemies are nearby");
}
else
{
print("No enemies are nearby");
}

maxDistance is optional (leave blank to use default value).
Similar to isEnemyVisible except without line of sight test.
Underwater enemies are detected.
Range will differ between object types.

isEnemyVisible

bool isEnemyVisible(int objectID)

Determine if an object can see any enemies.

if (isEnemyVisible(PLAYER_OBJECT))
{
print("One or more enemies are visible");
}
else
{
print("No enemies are visible");
}

Underwater enemies are not detected.

isEnemyNear

bool isTarget(int objectID)

Determine if an object is currently being targeted by an enemy.

if (isTarget(PLAYER_OBJECT))
{
print("Player is being targeted");
}
else
{
print("Player is not being targeted");
}

Does not detect healing by medics or engineers.
This function can be slow and should be called every frame from onUpdate. Use onTick or check at intervals instead.

getNoTarget setNoTarget

bool getNoTarget(int objectID)

Get the no target status of an object.

if (getNoTarget(PLAYER_OBJECT))
{
print("Player cannot be targeted");
}
else
{
print("Player can be targeted");
}

setNoTarget isTarget

void setNoTarget(int objectID, bool noTarget)

Set the no target status of an object.

setNoTarget(PLAYER_OBJECT, true);

Setting noTarget prevents AI from targetting an object.

getNoTarget isTarget

bool objectExists(int objectID)

Get whether an object exists.

if (objectExists(0))
{
print("Object 0 exists");
}
else
{
print("Object 0 doesn't exist");
}

string getTypeName(int objectTypeNumber)

Get an object type name from a object type number.

string typeName = getTypeName(0);
print("Type number 0 is " + typeName);

getTypeNameNumber getTypeNumber

int getTypeNameNumber(string objectTypeName)

Get an object type number from a object type name.

int typeNumber = getTypeNameNumber("hoverboard.ob");
print("Hoverboard is type number " + typeNumber);

getTypeNumber getTypeName

int getTypeNumber(int objectID)

Get an object type number from an object.

int typeNumber = getTypeNumber(PLAYER_OBJECT);
print("Player is type number " + typeNumber);

getTypeNameNumber getTypeName

void setFollow(int objectID, int objectToFollowID)

Set an object to follow another object (server only).

// Make object ID 0 follow object ID 1
setFollow(0, 1);

Set objectToFollowID to -1 to stop following.

bool isOverWater(int objectID)

Is an object over water?

print(isOverWater(PLAYER_OBJECT));

isSwimming

bool isSwimming(int objectID)

Is an object swimming?

print(isSwimming(PLAYER_OBJECT));

Only applies to human objects.

isOverWater getSwimmingEnabled setSwimmingEnabled

void getHasWetsuit(bool hasWetsuit)

Determine if the specified unit has a wetsuit.

bool playerHasWetsuit = getHasWetsuit(PLAYER_OBJECT);
print("playerHasWetsuit = " + playerHasWetsuit);

setHasWetsuit

void setHasWetsuit(bool hasWetsuit)

Give or take wetsuit from the specified unit.

// give player wetsuit
setHasWetsuit(PLAYER_OBJECT, true);
print("playerHasWetsuit = " + getHasWetsuit(PLAYER_OBJECT));

Server only.
Works for any unit or player.

getHasWetsuit

void resetRespawnCoords(int objectID)

Update the respawn coordinates of an object to it's current coordinates (server only).

resetRespawnCoords(0);

string getDisplayName(int objectID)

Get the display name of an object.

string displayName = getDisplayName(PLAYER_OBJECT);
print("Player display name is " + displayName);

getPlayerName

vector2 getTypeSize(string resourceName)

Get the size of an object type in pixels.

// show non-rotated image size and largest rotated bounds size of Car01.ob
vector2 carSize = getTypeSize("Car01.ob");
print("Non-rotated size = " + carSize);
vector2 carMaxRotatedSize = carSize * 1.41;
print("Max rotated size = " + carMaxRotatedSize);

An "object type" is a type of object not an actual object instance so no existing object is required.
Returned size is simply the still sprite size without rotation.

void attachObject(int objectID, int parentID, vector2 offset)

Attach an object to another object.

// attach object ID 10 to player
attachObject(10, getLocalPlayerObject(), vector2(0,0));

Attached objects have no physics.
Objects cannot be attached to already attached objects.

detachObject getAttachedObjects getAttachedToParent

void detachObject(int objectID)

Detach an attached object from it's parent.

// detach object ID 10 from it's parent
detachObject(10);

attachObject getAttachedObjects getAttachedToParent

array getAttachedObjects(int parentID)

Get a list of object IDs that are attached to the specified parent object.

// print object IDs attached to player
array<int> objectIDs = getAttachedObjects(getLocalPlayerObject());
for (uint i = 0; i < objectIDs.length(); i++)
{
print(objectIDs[i]);
}

attachObject detachObject getAttachedToParent

int getAttachedToParent(int objectID)

Get an attached object's parent object ID.

// print parent object ID for object ID 10
int parentObjectID = getAttachedToParent(10);
print(parentObjectID);

Returns -1 if not attached to a parent object.

attachObject detachObject getAttachedObjects