GameMaker Studio · GML · Groups & clans

gmda_assignGroupRole

Changes a member's role within the group.

Asynchronous (result via event)

Signature

gmda_assignGroupRole(player_key, role) -> real

What it does

POSTs /groups/members/assign-role, then queues group_member_role_assigned { success, response }. response echoes the player_key and the requested role. "leader" is rejected; transfer leadership separately. On failure e.error carries the raw server message, e.g. "Invalid role", "Insufficient rank", "Player is not a member of your group", or "Player not found".

Parameters

Name	Type	Default	Description
player_key	string	required	Key of the member whose role changes.
role	string	required	A server-defined role string (e.g. "admin", "member", or a custom role_key). Cannot be "leader"; use gmda_transferGroupLeadership() for that.

How to call it

Call it, then read group_member_role_assigned from gmda_pollEvent(). Permission and rank are enforced server-side. To make someone leader, use gmda_transferGroupLeadership() instead.

Result event: group_member_role_assigned { success, response }

Example

gmda_assignGroupRole(player_key, "admin");    // not "leader"

var e = gmda_pollEvent();
while (!is_undefined(e)) {
    if (e.event == "group_member_role_assigned" && e.success) {
        show_debug_message(e.response.player_key + " is now " + e.response.role);
    }
    e = gmda_pollEvent();
}

Use cases

Promote a trusted member to admin/officer.
Demote an admin back to a regular member.

Functions Reference