Saltar al contenido principal

OnPlayerCommandText

Descripción​

Este callback se llama cuando un jugador ingresa un comando dentro de la ventana de chat del cliente. Los comandos son todo lo que empieza con una barra inclinada "/", por ejemplo, /ayuda.

NombreDescripción
playeridEl ID del jugador que ingresó un comando.
cmdtext[]El comando que fue ingresado (incluyendo la barra inclinada).

Devoluciones​

Retornando 0 este callback será ejecutado en otro script o mostrará SERVER: Unknown command. si no hay scripts para pasarle este callback.

1 - Prevendrá a otros filterscripts de recibir este callback.

0 - Indica que este callback será pasado al siguiente filterscript.

Siempre se llama primero en filterscripts.

Ejemplos​

public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp(cmdtext, "/ayuda", true))
    {
        SendClientMessage(playerid, -1, "SERVER: Este es el comando /ayuda !");
        return 1;
        // Devolviendo 1 informa al servidor que el comando fue procesado.
        // OnPlayerCommandText no se llamará en otros scripts.
    }
    return 0;
    // Devolviendo 0 informa al servidor que el comando no fue procesado por este script.
    // OnPlayerCommandText va a ser llamado en otros scripts hasta que uno devuelva 1.
    // Si ningún script devuelve 1, el mensaje 'SERVER: Unknown Command' va a ser mostrado al jugador.
}

Notas​

nota

Este callback también puede ser llamado por un NPC.

Callbacks Relacionados​

Los siguientes callbacks pueden ser útiles, ya que están relacionados de alguna forma u otra con OnPlayerCommandText:

  • OnPlayerText: Llamado cuando un jugador escribe un texto en el chat.
  • OnRconCommand: Llamado cuando se envia un comando desde la rcon.

Funciones Relacionadas​

Las siguientes funciones pueden ser útiles, ya que están relacionadas de alguna forma u otra con OnPlayerCommandText: