OnPlayerCommandText RU

From SA-MP Wiki

Jump to: navigation, search

OnPlayerCommandText

Описание:

Эта функция вызывается при наборе игроком какой-либо команды например, /help.

Примечание

Этот обратный вызов также может быть вызван NPC.

Параметры:

(playerid, cmdtext[])

playerid

ID игрока, набравшего команду.

cmdtext[]

Набранная команда (включая '/').

Возвращаемые значения:

Возвращает 1 когда набранная команда была найдена и обработана, иначе 0; В случае если команда не была найдена ни в фильтрскриптах, ни в моде, игроку будет выслано сообщение белым цветом: 'SERVER: Unknown command'.

Это всегда вызывается первым из filterscript'ов, так что вернув 1 это не позволит увидеть его вызов в следующем filterscript'е.

Пример использования:

public OnPlayerCommandText(playerid, cmdtext[])
{
    if(!strcmp(cmdtext, "/help", true))
    {
        SendClientMessage(playerid, 0xFFFFFFFF, "SERVER: This is the /help command!");
        return 1;
        /* Возврат '1' использован чтобы дать серверу понять что команда найдена
        и работает исправно. Если вы не поставите эту строчку, то игроку будет
        выслано сообщение 'SERVER: Unknown Command.' после выполнения команды. 
        */
    }
    return 0;
/* Возврат '0' использован чтобы дать серверу понять что команда не найдена
и не работает, и указывает серверу что этой команды нет ни в моде ни в скрипте.
*/
}