SetPlayerName

From SA-MP Wiki

Revision as of 04:16, 5 February 2014

Description:

Return Values:

Important Note

If you set the player's name to the same name except different cased letters (i.e. "heLLO" to "hello"), it will not work. If used in OnPlayerConnect, the new name will not be shown for the connecting player.

// 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, "Unable to change your name, someone else is known as 'Superman' already.");
        case 0: SendClientMessage(playerid, 0xFF0000FF, "You are already known as 'Superman'");
        case 1: SendClientMessage(playerid, 0x00FF00FF, "You are now known as 'Superman'");
    }
    return 1;
}

Related Functions

The following functions may be useful, as they are related to this function in one way or another.

• GetPlayerName: Get a player's name.