Aller au contenu principal

OnPlayerCommandText

Paramètres​

Cette callback est appelée quand un joueur tape une commande. Les commandes débutent avec un slash (/aide, ...).

NomDescription
id playeridID du joueur qui envoie la commande
string cmdtext[]Commande envoyée (nécessite un slash devant)

Valeur de retour​

Retournez 0 si aucune commande n'a été exécutée. Sinon, retournez 1.

La callback est toujours appelée en premier dans les filterscripts, donc return 1, faute de quoi les autres scripts ne pourront pas communiquer avec cette callback.

Exemple​

public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp(cmdtext, "/aide", true))
    {
        SendClientMessage(playerid, -1, "SERVER: Ceci est la commande d'aide !");
        return 1;
        // Return 1 = informe le serveur que la commande a bien été exécutée.
        // OnPlayerCommandText ne sera donc plus appelé dans les autres scripts.
    }
    return 0;
    // Return 0 = informe le serveur que la commande n'a pas été exécutée.
    // OnPlayerCommandText sera appelé dans les autres scripts jusqu'à se heurter à un return 1.
    // Si aucun autre script ne return 1, le message "SERVER: Uknown Command" sera envoyé dans le chat.
}

Astuces​

remarque

This callback can also be called by NPC.

Callbacks connexes​

Les Callbacks ci-dessous sont indirectement ou directement liées à cette Callback.

  • OnPlayerText: Appelée lorsqu'un joueur envoie un message via le chat.
  • OnRconCommand: Appelée lorsqu'une commande RCON est exécutée.

Fonctions connexes​

Les fonctions suivantes peuvent être utiles, car elles sont liées à ce rappel d'une manière ou d'une autre.