Skip to content

llEjectFromLand

void llEjectFromLand(key AvatarID)

Ejects AvatarID from land that you own.

Ejects AvatarID from land that the object owner (group or resident) owns.

Parameters

AvatarID (key)

Technical Details

Return Type: void
Energy: 10

Eject Avatar by Partial Name Match

This example demonstrates a practical chat-based ejection system that uses partial name matching to eject avatars from your land. It’s designed for fast enforcement on PvP sims.

// Eject system that responds to chat commands
// Usage: /1 eject shenan (will eject avatars whose names contain "shenan")

string msg;
string name;

default
{
    on_rez(integer n)
    {
        llResetScript();
    }

    state_entry()
    {
        llListen(1, "", llGetOwner(), "");
        llListen(0, "", llGetOwner(), "");
    }

    listen(integer n, string m, key k, string msg)
    {
        if (llGetSubString(msg, 0, 5) == "eject ")
        {
            name = llToLower(llStringTrim(llDeleteSubString(msg, 0, 5), STRING_TRIM));
            llSensor("", "", AGENT, 96, PI);
        }
    }

    sensor(integer n)
    {
        integer i = 0;
        for (;i<n;++i)
        {
            if (llOverMyLand(llDetectedKey(i)))
            {
                if (~llSubStringIndex(llToLower(llDetectedName(i)), name))
                {
                    llOwnerSay("ejecting " + llDetectedName(i));
                    llEjectFromLand(llDetectedKey(i));
                }
            }
        }
    }

    no_sensor()
    {
        llOwnerSay("Avatar not found.");
    }
}

Caveats

Be careful when using partial name matching: if you search for a common substring, you may eject multiple avatars unintentionally
This function only ejects avatars from your parcel; it does not remove them from the region
The function requires the script to have permission to eject (typically when placed on parcel-owned objects)

See Also