onPlayerCommand

Disparado antes de qualquer manipulador de comando do servidor quando há um jogador como origem. Isso acontece tanto com uma linha digitada pelo jogador no F8 — encaminhada automaticamente pelo cliente depois dos manipuladores locais e do onClientConsole — quanto com executeCommandHandler chamado no servidor com esse jogador. Comandos do console do servidor não disparam este evento.

Origem

O jogador para quem o comando está sendo executado.

Parâmetros

Posição	Nome	Tipo	Descrição
1	comando	string	Nome do comando, sem os argumentos.

Cancelável

Sim.

Um comando cancelado não chega a nenhum manipulador e não dispara onConsole.

Cuidado

restricted = true em addCommandHandler e as regras ACL do server.cfg ainda não aplicam permissão aos comandos. Qualquer jogador conectado pode alcançar um comando registrado no servidor pelo F8. Valide a permissão dentro do manipulador ou cancele aqui antes que os manipuladores rodem.

Exemplo

local proibidos = { kill = true, respawn = true }

addEventHandler("onPlayerCommand", root, function(comando)
    if proibidos[string.lower(comando)] and not getElementData(source, "admin") then
        cancelEvent(true, "comando restrito")
    end
end)

Veja também

• onConsole — Disparado depois que uma linha passa pelo sistema de comandos Lua do servidor, com o comando e os argumentos.
• onPlayerMute — Disparado quando um jogador vai ser silenciado por setPlayerMuted.
• onPlayerUnmute — Disparado quando um jogador vai deixar de ser silenciado por setPlayerMuted.
• onPlayerTriggerEventThreshold — Disparado quando um jogador passa do limite de eventos enviados ao servidor: mais de 100 envios dentro de uma janela de um segundo.
• onPlayerTriggerInvalidEvent — Disparado quando um jogador tenta disparar no servidor um evento que não existe, ou que existe mas não foi liberado para o cliente.
• onPlayerAnticheatViolation — Disparado toda vez que o anticheat registra uma violação para um jogador — inclusive as ocorrências que ainda não atingiram o limite da política.