Description

This read-only variable holds the unique identifying number for the instance. Every instance that you create is given a number that is used internally to identify this instance and this variable is what you can use to reference it. The id is also returned (and can be stored in a variable) when an instance is created using instance_create_layer.

NOTE: The value of this variable is not the same as the identifier that the instance is given in the room editor and is also different to the instance_id array which contains all the ids of all the currently active instances.

Syntax:

id;

Returns:

Real (integer - instance ID value)

Example:

for(var i = 0; i < instance_count; i++;)
    {
    if instance_id[i] != id
        {
        instance_id[i].scr += 5;
        }
    }

The above code adds 5 to the "scr" variable for every active instance in the room except the one running the code. It does this by looping through ALL the active instances (using the "instance_id" array to return each active instances ID) and comparing them against the built in "id" variable, which is the ID of the original instance running the code.