warning Not Translated
This page has not been translated into the language that your browser requested yet. The English content is being shown as a fallback.
If you want to contribute a translation for this page then please click here.
OnPlayerText
Description
This callback is called when a player sends a message in chat.
Name | Description |
---|---|
playerid | The ID of the player who sent the message. |
text[] | The content of the message that the player sent. |
Returns
It is always called first in filterscripts so returning 0 on it blocks other scripts from processing it.
Examples
public OnPlayerText(playerid, text[])
{
new string[144];
format(string, sizeof (string), "(%d) %s", playerid, text);
SendPlayerMessageToAll(playerid, string);
// Returning 0 ignores the default message format and sends the custom one instead.
// Returning 1 will result in the message being duplicated, as the default message will also be sent.
return 0;
}
Notes
tip
This callback can also be called by NPC.
::: tip
By default, this callback sends a message containing the content of the message, the player's name, and their ID. Returning 0 will ignore this default behaviour, as demonstrated in the code example above.
:::
Related Callbacks
The following callbacks might be useful, as they're related to this callback in one way or another.
- OnPlayerCommandText: Called when a player types a command.
Related Functions
The following functions might be useful, as they're related to this callback in one way or another.
- SendPlayerMessageToPlayer: Force a player to send text for one player.
- SendPlayerMessageToAll: Force a player to send text for all players.
- ToggleChatTextReplacement: Toggles the chat input filter.