GameMaker Studio · GML · Groups & clans

gmda_kickGroupMember

Removes a member from the caller's group (leader/officer).

Asynchronous (result via event)

Signature

gmda_kickGroupMember(player_key) -> real

What it does

POSTs /groups/members/kick, then queues group_member_kicked { success, response }. Permission and rank are enforced server-side (you cannot kick someone of equal or higher rank). On failure e.error carries the raw server message, e.g. "Insufficient rank", "Player is not a member of your group", "You cannot target yourself", or "Player not found".

Parameters

Name	Type	Default	Description
player_key	string	required	Key of the member to remove.

How to call it

Call it, then read group_member_kicked from gmda_pollEvent(). Get player keys from the members list returned by gmda_getGroupInfo().

Result event: group_member_kicked { success, response }

Example

gmda_kickGroupMember(player_key);

var e = gmda_pollEvent();
while (!is_undefined(e)) {
    if (e.event == "group_member_kicked") {
        if (e.success) show_debug_message("Member removed");
        else show_debug_message("Failed: " + e.error);
    }
    e = gmda_pollEvent();
}

Use cases

Let officers remove a disruptive member.
Prune inactive players from the roster.