Effects - Meteor 2 Scripting Functions

int getGraphicsQualityLevel()

Get the graphics quality level from the local options.

if(getGraphicsQualityLevel() < GQ_HIGH)
{
print("Graphics quality level is below high quality");
}

The quality level should be from 0 to 3 with the following constants defined.
GQ_LOW = 0
GQ_MEDIUM = 1
GQ_HIGH = 2 (default)
GQ_ULTRA = 3

void createExplosion(vector2 pos, float height, float radius, float damage, float armourPenetration, int ownerID)

Create an in-game explosion.

// create exlosion at ground level height
createExplosion(getPos(PLAYER_OBJECT), 0, 20, 100, 50, PLAYER_OBJECT);

// create exlosion at in the air.
createExplosion(getPos(PLAYER_OBJECT), getAirHeight(), 20, 100, 50, PLAYER_OBJECT);

armourPenetration is 0 to 100.
Can be called from server or client.

void addPulse(vector2 pos, vector2 velocity, vector2 size, vector2 maxSize, string col, float growRate, float alphaMultiplier)

Add a visual pulse effect particle.

// create example pulse
addPulse(getPos(PLAYER_OBJECT), vector2(0, 0), vector2(4, 4), vector2(400, 400), "#FA4B19", 800, 0.9);

Visual only. Can be called from server and client and is synced to currently connected players.

void fade(string text, float fadeOutSeconds, float fadedSeconds, float fadeInSeconds)

Fades out the screen, displays a message and fades back in.

// fade out over 1 seconds, show text for 3 seconds, fade in over 1 second
fade("Later that day...", 1, 3, 1);

// instantly turn screen black, wait 2 seconds, fade in over 2 seconds
fade("", 0, 2, 2);

Only affects the local computer.
Player controls are disabled while fading and while faded.

getCinematicBarsEnabled setCinematicBarsEnabled

void flash(float lifetime, string col)

Light up the world for a short time.

// light up night sky for 1 second
flash(1, "#FFFFFF");

Only affects the local computer.
col is specified in HTML style ("#RRGGBB" hex values), colours may also contain 2 additional optional characters for alpha (e.g. "#FFFFFF80" is transparent white).
Lifetime is in seconds.

bool getCinematicBarsEnabled()

Gets whether the cinematic bars are enabled.

if(getCinematicBarsEnabled())
{
print("Cinematic bars are enabled.");
}
else
{
print("Cinematic bars are disabled.");
}

setCinematicBarsEnabled fade

void setCinematicBarsEnabled(bool enabled)

Sets whether the cinematic bars are enabled.

// enable cinematic bars
setCinematicBarsEnabled(true);

Only affects the local player.
Player controls are disabled while cinematic bars are enabled.

getCinematicBarsEnabled fade

bool getMaxWildlifeDistance()

Get the maximum wildlife particle distance.

print(getMaxWildlifeDistance());

Wildlife particles further than this distance from the game window centre will be culled automatically.

addWildlifeParticle

void addWildlifeParticle(vector2 spawnPos, uint filenameHash)

Spawn a wildlife particle (e.g. insect or bird).

unsigned birdHash = createStringHashLowerCase("Wildlife_Bird01.ini");
vector2 playerPos = getPos(PLAYER_OBJECT);
for(int i=0; i<10; i++)
{
addWildlifeParticle(playerPos, birdHash);
}

The particle filename is required as a hash for better performance. Use createStringHashLowerCase() to generate a filename hash once before any loops.

getMaxWildlifeDistance createStringHashLowerCase getWildlifeParticleInstanceCount

int getWildlifeParticleInstanceCount(uint filenameHash)

Get the current particles instance count of a willife particle type.

unsigned birdHash = createStringHashLowerCase("Wildlife_Bird01.ini");
int birdsCount = getWildlifeParticleInstanceCount(birdHash);
print("Birds count: " + birdsCount);

addWildlifeParticle createStringHashLowerCase

void addPlantParticle(vector2 spawnPos, uint filenameHash)

Spawn a plant particle (e.g. grass or flower).

unsigned grassHash = createStringHashLowerCase("Plant_Grass01.ini");
vector2 playerPos = getPos(PLAYER_OBJECT);
for(int i=0; i<10; i++)
{
addPlantParticle(playerPos, grassHash);
}

The particle filename is required as a hash for better performance. Use createStringHashLowerCase() to generate a filename hash once before any loops.

createStringHashLowerCase getPlantParticleInstanceCount

int getPlantParticleInstanceCount(uint filenameHash)

Get the current particles instance count of a plant particle type.

unsigned grassHash = createStringHashLowerCase("Plant_Grass01.ini");
int grassHash = getPlantParticleInstanceCount(grassHash);
print("Grass count: " + birdsCount);

addWildlifeParticle createStringHashLowerCase

bool isAddFireFrame()

Determine if fire particles should be added this frame.

Fire particles can be added during any frame but this function provides a convenient way of timing them consistently.

addFireParticle

void addFireParticle(vector2 pos, float maxSize, float height=0, float lightLifetime=-1)

Add a fire particle.

void onUpdate(float deltaTime)
{
    if(isAddFireFrame())
    {
        addFireParticle(getPos(PLAYER_OBJECT), 10);
    }
}

isAddFireFrame addSmokeParticle

void isFireNear(vector2 pos, float maxDistance)

Determine if there is a fire nearby.

print(isFireNear(getPos(PLAYER_OBJECT), 100));

getNearestFirePos

vector2 getNearestFirePos(vector2 pos, float maxDistance)

Get the position of the nearest fire.

print(getNearestFirePos(getPos(PLAYER_OBJECT), 100));

Returns vector2(0,0) if no fire was found within a maxDistance radius.

isFireNear

bool isAddSmokeFrame()

Determine if smoke particles should be added this frame.

Smoke particles can be added during any frame but this function provides a convenient way of timing them consistently.

addSmokeParticle

void addSmokeParticle(vector2 pos, float size, string smokeCol, float growRate=0.95, float decayRate=0.5, vector2 smokeVelocity=vector2(0,0))

Add a fire particle.

void onUpdate(float deltaTime)
{
    if(isAddSmokeFrame())
    {
        addSmokeParticle(getPos(PLAYER_OBJECT), 10, "#A0A0A0");
    }
}

smokeCol is specified in HTML style ("#RRGGBB" hex values), colours may also contain 2 additional optional characters for alpha (e.g. "#FFFFFF80" is transparent white).

isAddSmokeFrame addFireParticle

void addSpriteParticle(int spriteNumber, vector2 pos, float height, float angle, float scale, float speed, float growRate, float lifetime)

Add a particle from a sprite.

int particleSpriteNumber = 0;

void onStart()
{
    particleSpriteNumber = spriteTypeNameToNumber("effects\\shrapnel.spr");
}

void onUpdate(float deltaTime)
{
    vector2 pos = vector2(100, 100);
    float angle = randomDir();
    float height = 10;
    float scale = 0.5;
    float speed = 2;
    float growRate = 1.5; // growth during whole lifetime
    float lifetime = 3;

    addParticle(particleSpriteNumber, pos, angle, height, scale, speed, growRate, lifetime);
}

Currently only supports visual particles (no physics or collision).

spriteTypeNameToNumber

void drawLight(vector2 pos, float angle, vector2 size, string colour, bool effectLight)

Draw a basic ellipse light.

void onUpdate(float deltaTime)
{
drawLight(getPos(PLAYER_OBJECT), getDir(PLAYER_OBJECT), vector2(30, 100), "#FF0000", true);
}

colour is specified in HTML style ("#RRGGBB" hex values), colours may also contain 2 additional optional characters for alpha (e.g. "#FFFFFF80" is transparent white).
Set effectLight to true to show the light in the daytime and brigter during the night.