Aller au contenu principal

SetPlayerName

Description​

Sets the name of a player.

NameDescription
playeridThe ID of the player to set the name of.
const name[]The name to set. Must be 1-24 characters long and only contain valid characters (0-9, a-z, A-Z, [], (), $ @ . _ and = only).

Returns​

1 The name was changed successfully

0 The player is not connected or the name is already in use

-1 The name can not be changed (it's less than 3 symbols, too long or has invalid characters)

Examples​

// Command simply sets the player's name to to "Superman" if possible, with no error checking or messages.
if (strcmp(cmdtext, "/superman", true) == 0)
{
    SetPlayerName(playerid, "Superman");
    return 1;
}

// Command sets the players name to "Superman" if possible, informs the player of
// any errors using a "switch" statement.
if (strcmp(cmdtext, "/superman", true) == 0)
{
    switch (SetPlayerName(playerid, "Superman"))
    {
        case -1:
        {
            SendClientMessage(playerid, 0xFF0000FF, "The name has invalid characters or it's out of length.");
        }
        case 0:
        {
            SendClientMessage(playerid, 0xFF0000FF, "Unable to change your name, someone else is known as 'Superman' already.");
        }
        case 1:
        {
            SendClientMessage(playerid, 0x00FF00FF, "You are now known as 'Superman'");
        }
    }
    return 1;
}

Notes​

attention
  • Changing the players' name to the same name but with different character cases (e.g. "John" to "JOHN") will not work.
  • If used in OnPlayerConnect, the new name will not be shown for the connecting player.
  • Passing a null string as the new name will crash the server. (Fixed in open.mp)
  • Player names can be up to 24 characters when using this function, but when joining the server from the SA-MP server browser, players' names must be no more than 20 and less than 3 characters (the server will deny entry). This allows for 4 characters extra when using SetPlayerName.