OnPlayerPrivmsg

Description:

Callback OnPlayerPrivmsg is called when a player sends a private message through the native PM system /pm.

Callback OnPlayerPrivmsg was removed in SA-MP 0.3. See below how to create a /pm command.

You can't return 0 and block private messages in a filterscript, it must be used in a gamemode.

Parameters:

(playerid, recieverid, text[])

int

playerid

The player who sent a message.

int

recieverid

The player who receives the message.

string

text

The actual message.

Return Values:

Examples:

Example 1

public OnPlayerPrivmsg(playerid, recieverid, text[])
{
    if(muted[playerid]) return 0;
    return 1;
}

if(!strcmp("/pm", cmdtext, true))
{
    tmp = strtok(cmdtext,idx);
    if(!strlen(tmp)) return SendClientMessage(playerid,0xFF0000FF,"USAGE: /PM (id) (message)");
    new id = strval(tmp);
    gMessage = strrest(cmdtext,idx);
    if(!strlen(gMessage)) return SendClientMessage(playerid,0xFF0000FF,"Usage: /pm (id) (message)");		
    if(!IsPlayerConnected(id)) return SendClientMessage(playerid,0xFF0000FF,"/pm :Invalid ID");	
    GetPlayerName(id,iName,sizeof(iName));
    GetPlayerName(playerid,pName,sizeof(pName));
    format(Message,sizeof(Message),">> %s(%i): %s",iName,id,gMessage);
    SendClientMessage(playerid,0xFFD720FF,Message);
    format(Message,sizeof(Message),"** %s(%i): %s",pName,playerid,gMessage);
    SendClientMessage(id,0xFFD720FF,Message);
    PlayerPlaySound(id,1085,0.0,0.0,0.0);
    return 1;
}

Related Functions

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

OnPlayerCommandText: Called when a player types a command.
OnPlayerText: Called when a player sends a message via the chat.