Portal:CService/QuakeNet/Comandos
Observação: Os parâmetros entre [ ] - colchetes - são opcionais e os parâmetros entre { } - chaves - são obrigatórios.
Adduser
Sintaxe: /msg Q ADDUSER #canal {+<flags>} {<nick1|#auth1>} [<nick2|#auth2> [...]]
Adiciona um usuário à lista CHANLEV.
- Parâmetros
- Flags: A flags é uma letra que você atribui ao usuário para que ele tenha uma permissão dentro do #canal.
- nick|#auth: Um #auth é o nome do usuário registrado na Rede. Pode-se adicionar pelo nick (apelido) ou pelo nome da conta do usuário. Ver AUTH.
- Informação adicional
- Você pode usar este comando par adicionar vários usuários à lista CHANLEV, no máximo 18 usuários por vez.
- Para ver ou editar as flags use o comando CHANLEV.
OBS: Abuso de flags (deop/op/voice/bam em massa) pode resultar na retirada do Q Bot do seu #canal ou na suspenção e até fechamento do mesmo.
- Flags
- Você poder usar os vários flags que se encontram no comando CHANLEV, exceto as flags de Administrador/Mestre (+ m) e de proprietário (+ n), com tanto que as combinações sejam válidas. Exemplo adicionar (+ do) op (+o) e não-op (+d). É contraditório.
Exemplos:
- 1 -
/msg Q ADDUSER #IRChelp campari
- Este comando adiciona as flags default (+ aot) ao nick campari
- 2 -
/msg Q ADDUSER #IRChelp #campari_auth
- Este comando adiciona as flags default (+ aot) ao ao authname #campari_auth
- 3 -
/msg Q ADDUSER #IRChelp +gv campari delet #bigua_auth tucuju
- Este comando adiciona as flags de auto-voice (+ gv) aos usuários campari, delet, tucuju e ao authname #bigua_auth.
- Formas erradas de execução do comando
- 1 -
/msg Q ADDUSER #IRChelp campari
- Resposta ao comando:
-Q- John is already known on #channel
- Causa: Tentar adicionar um usuários já existente na lista CHANLEV.
- 2 -
/msg Q ADDUSER #IRChelp +m campari
- Resposta ao comando:
-Q- You must specify at least one valid flag to add
- Causa: Tentar adicionar as flags de Administrador/Mestre (+ m) ou Proprietário (+ n) a um usuário.
- 3 -
/msg Q ADDUSER #IRChelp -ao campari
- Resposta ao comando:
-Q- Can't find user -ao
- Causa: Tentar remover flags utilizando o comando ADDUSER. Utilize REMOVEUSER.
- Comandos relacionados
Auth
Sintaxe 1: /AUTH #canal {usuário} {senha}
Sintaxe 2: /msg [email protected] AUTH {usuário} {senha}
O comando AUTH autentica um usuário na Rede.
- Informação Adicional
- O usuário estará autenticado na Rede até o momento que ele se desconectar. Não é permitido se autenticar com outro usuário enquanto já estiver autenticado como um. Para se autentica novamente, desconecte e reconecte na Rede.
- Para maior seguração, o usuário pode realizar sua atenticação juntamente como comando CHALLENGEAUTH.
OBS: Por razões de segurança, a Rede encoraja aos usuários que realizem sua autenticação através do comando /AUTH
. A sintaxe /msg [email protected] AUTH
só deve ser usada se de alguma maneira a sintaxe /AUTH
não funcionar. E desencoraja fortemente usar a abreviação 'Q' no momento da autenticação. Exemplo /msg Q AUTH
. Saiba como registrar uma conta na QuekeNet aqui
- Requisitos
- usuário: O nome da conta no Q Bot para se autenticado. Não confundir com o apelido (nick) que se registra/identifica em servidores que utilizam NickServ. Você pode usar qualquer nick que outra pessoa não esteja usando, a não ser que esse nick seja de algum usuário que seja da staff da Rede QuakeNet. Exemplo, você pode se autenticar com o comando AUTH com o usuário campari e estar usando qualquer outro nick.
Exemplos:
- 1 -
/msg [email protected] AUTH xArthur xYz123
- Autentica o usuário xArthur com a senha xYz123
- 2 -
/AUTH xArthur xYz123
- Autentica o usuário xArthur com a senha xYz123 utilizando o comando alternativo
/AUTH
- 3 -
/quote AUTH xArthur xYz123
- Alguns usuários podem ter em seu script um comando interno já estabelecido para o
/AUTH
. Por isso, caso o usuário não obtenha resposta do servidor utilizando esse comando, utilize/quote AUTH
para que o comando de autenticação passe pelo filtro do seu cliente irc (script) e chegue até a Rede.
- Comandos Relacionados
Authhistory
Sintaxe: /msg Q AUTHHISTORY
O comando AUTHHISTORY informa o histórico de autenticação do usuário que o executa.
- Informação Adicional
- O comandos irá mostra uma lista dos 10 (dez) últimos logins.
- A lista mostra o
nick!ident@host
à esquerda, e a hora da autenticação, desconexão e a última mensagem dela. As mensagens mais recentes são mostradas por primeiro.
- Requisitos
- Para realizar o comando, o usuário deve estar autenticado.
- Comandos relacionados
Autolimit
Sintaxe: /msg Q AUTOLIMIT #canal [limite_a_mais]
O comando AUTOLIMIT estabelece um "limite a mais" de usuário que podem estar no canal. Esse limite se configura automaticamente.
O limite não é a quantidade de usuários em si do canal mais sim, a quantidade de usuários que podem ter no canal em um curto período de tempo. Depois desse tempo, o canal auto-incrementa esse limite com a quantidade que foi especificada no comando. Se o limite não for fornecido, o 'Q' usará o limite atual ou seja, se no momento da execução do comando houverem 10 usuário no canal, o "limite a mais" será de +10 usuários. Se esses 10 usuários a mais entrarem juntos no canal, ou quando este for atingido, o 'Q' proibirá a entrada de novos usuários por um período curto de tempo e depois permitira a entrada de +10 usuários.
Novamente, o limite configurado com o comando AUTOLIMIT é autoajustável fim de que, esse limite não seja fixo, pois isso iria proibir a entrada de novos usuários. Com isso, o canal sempre tem um "limite a mais" para que usuários possam entrar. O AUTOLIMIT previne principalmente o joinflood.
- Informação Adicional
- O limite será ajustado automaticamente em intervalos constantes para evitar join floods (floods causados por muitas entradas de usuário de uma só vez). Sempre que o limite é ajustado, ele é definido como usersonthe_channel + N, onde N é o número que você especifica no comando.
- O limite automático deve ser combinado com a flag + c utilizando o comando CHANFLAGS. A definição de um limite fixo deve ser feita com o comando CHANMODE.
- Requerimentos
- 1 - Para ver o limite do AUTOLIMIT, o usuário que executa o comando deve ser no mínimo um Operador (flags +o) no CHANLEV do canal.
- 2 - Para editar o limite do AUTOLIMIT, o usuário que executa o comando deve ser no mínimo um Administrador/Mestre (flags +m) no CHANLEV do canal.
Exemplos:
- 1 -
/msg Q AUTOLIMIT #IRChelp
- Informa o limite atual do #IRChelp
- 2 -
/msg Q AUTOLIMIT #IRChelp 5
- Configura o autolimite do #IRChelp para +5
- Formas erradas de execução do comando
- 1 -
/msg Q AUTOLIMIT #IRChelp -5
- Resposta ao comando:
-Q- Supplied autolimit is invalid: -5
- Causa: Tentar configurar um limite negativo ou inválido
- 2 -
/msg Q AUTOLIMIT #IRChelp 0
- Resposta ao comando:
-Q- Supplied autolimit is invalid: 0
- Causa: Tentar configurar o limite de '0' no canal. (limites fixos devem ser configurados com o comando CHANMODE
- Comandos relacionado
Banclear
Sintaxe: /msg Q BANCLEAR #canal
O comando BANCLEAR deleta todos os banimentos do canal.
- Informação adicional
- A diferença do comando BANCLEAR para o UNBANALL é que este ultimo comando deleta também os banimentos que são permanentes. Para visualizar os banimentos permanentes, execute o comando BANLIST.
- Requerimentos
- Para executar o comando, o usuário deve ter pelo menos o nível de Administrador/Mestre (flag + m) no CHANLEV do canal.
Exemplos:
/msg Q BANCLEAR #Brazink
- Deleta todos os banimentos do #Brazink.
- Comandos relacionados
Bandel
Sintaxe: /msg Q BANDEL #canal {#num|máscara}
O comando BANDEL deleta um banimento específico do canal.
- Parâmetros
- num|máscara : #num é o número de ordem do banimento dentro da lista do canal (iniciado pelo simbolo hastag (#)). Máscara é o host do usuário.
- Informação adicional
- Para realizar/remover um banimento permanente é necessário usar a flag do CHANLEV (+ b).
- Requerimentos
- Para remover um banimento, o usuário deve ter pelo menos o nível de Operador (flag + o) no CHANLEV do canal.
- Para remover um banimento permanente, o usuário deve ter pelo menos o nível de Administrador/Mestre (flag + m) no CHANLEV do canal.
Exemplos:
- 1 -
/msg Q BANDEL #vIRCio #1
- Deleta o primeiro banimento da lista do #vIRCio
- 2 -
/msg Q BANDEL #vIRCio pilha!*@*
- Deleta o banimento de máscara
pilha!*@*
da lista do #vIRCio
- Comandos relacionados
Banlist
Sintaxe: /msg Q BANLIST #canal
Lista todos os banimentos permanentes do canal.
- Informação adicional
- 1 - Os banimentos de canal são marcados com Channel Ban, isso ajuda o usuário a diferenciar os banimentos permanentes (usados com PERNBAN e TEMPBAN), e os banimentos de canal (usados através do comando
/MODE #canal +b nick
)
- OBS: Usuários banidos través da definição da flag de ban (+ b) no CHANLEV, serão banidos pelo 'Q' como banimento de canal. Para remover esses banimentos, o usuário deve primeiro remover a flag de ban (+ b) do CHANLEV e então remover o banimento do canal.
- A remoção de banimento pode ser realizada utilizando o comando BANDEL. A remoção de todos os bans pode ser feita usando o comando BANCLEAR.
- Requisitos
- 1 - Para executar o comando BANLIST, o usuário deve ser no mínimo um Operador, (flags +o) no CHANLEV do canal.
Exemplos:
/msg Q BANLIST #Virtualife
- Lista todos os banimentos do #Virtualife
- Comandos relacionados
Tempban
Sintaxe: /msg Q TEMPBAN #canal {máscara} {duração} [razão]
O comando TEMPBAN bani temporariamente uma hostmask (máscara) de um canal.
- Requisitos
- Razão: É a razão do banimento. Por default é banned.
- Informação adicional
- Se o ban for removido do canal por um OP ou pelo comando BANTIMER, ele será reaplicado novamente se o usuário alvo do ban entrar no canal. Quando o tempo acabar, o ban será removido automaticamente. Ou seja, a comando TEMPBAN sobrepõe os comandos BANTIMER e o modo de canal unban (- b).
- Os banimentos definidos com o comando TEMPBAN, podem ser removidos antes de expirarem com os comandos BANCLEAR ou BANDEL. Todos os usuários que corresponderem à máscara de host serão expulsos do canal.
- Ao usar o comando, a duração especificada pode ser em 'm' (minutos), 'h' (horas), 'd' (dias), 'w' (semanas), 'M' (meses) e 'y' (anos), por exemplo 3d, 5h, 1h30m, 1M.
- Requisitos
- 1 - Para executar o comando BANTIME, o usuário deve ser no mínimo um Administrador/Mestre (flags +m) no CHANLEV do canal.
Exemplos:
- 1 -
/msg Q TEMPBAN #BrasPort Criss!*@* 1y2w
- Bani o nick Criss do #BrasPort pelo tempo de 1 (um) ano e 2 (duas) semanas.
- 2-
/msg Q TEMPBAN #BrasPort *!*@CrissAuth.users.quakenet.org 3d Não é bem-vinda
- Bani a conta de nome CrissAuth do #BrasPort pelo tempo de 3 (três) dias pela razão de que o usuário Não é bem-vindo
- Comandos relacionados
Unbanall
Sintaxe: /msg Q UNBANLL #canal
O comando UNBANALL remove todos os "bans de canal".
- Informação adicional
- O comando UNBANALL apenas remove os "bans de canal" e não os "bans registrados" que são executados com os comandos PERMBAN e TEMPBAN. A remoção dos "bans de canal" também pode ser executada com o comando BANCLEAR.
- Requisitos
- 1 - Para executar o comando UNBANALL, o usuário deve ser no mínimo um Administrado/Meste, (flags +m) no CHANLEV do canal.
Exemplo:
/msg Q UNBANALL #UnIRC
Remove todos os "bans de canal" do #UnIRC
- Comandos relacionados
Unbanmask
Sintaxe: /msg Q UNBANMASK #canal {mascara}
Remove os banimentos (bans) de um canal que são coincidem com a máscara informada.
- Informação adicional
- Este comando pode ser utilizado para remover tanto "bans de canal" (
/MODE #canal +b nick
) quanto "bans registrados" (TEMPBAN e PERMBAN).
- Requisitos
- 1 - Para executar o comando UNBANMASK, para removendo "bans de canal", o usuário deve ser no mínimo um Operador (flags +o) no CHANLEV do canal.
- 2 - Para executar o comando UNBANMASK, para removendo "bans registrados", o usuário deve ser no mínimo um Administrador/Mestre (flags +m) no CHANLEV do canal.
Exemplo:
/msg Q UNBANMASK #BrIRC *!*@*.com
- Remove todos os bans do #BrIRC que correspondam à máscara *!*@*.com
- Comandos relacionados
Unbanme
Sintaxe: /msg Q UNBANME #canal
O comando UNBANME retira o banimento do próprio usuário em um canal que o mesmo tenha acesso.
- Informação adicional
- 1 - O comando remove todos os banimentos que referem-se ao usuário no canal.
- 2 - Se no momento da execução do comando, o usuário tem apenas o nível de Operador (flag +o) no CHANLEV do canal, é removido apenas os banimentos do canal, e não os da BANLIST do Q Bot. Se o usuário que executa o comando tem o nível de Administrado/Mestre de canal, (flag +m), são retirado todos os banimentos referentes a PERMBAN, TEMPBAN e da própria BANLIST do Q Bot.
- Requerimentos
- 1 - Para executar o comando UNBANME, o usuário deve ser no mínimo um Operador (flags +o) no CHANLEV do canal.
Exemplo:
/msg Q UNBANME #sVipCHAT
- Retira o banimento no #sVipCHAT de quem executa o comando e tem permissão para usa-lo.
- Comandos relacionados
Userflags
Sintaxe: /msg Q USERFLAGS [+|- flags]
Modifica a própria flag do usuário que executa o comando.
- Informação adicional
- 1 - Se o parâmetro flag não for fornecido, a flag atual do usuário será mostrada.
- 2 - O comando USERFLAGS possui flagsque são utilizadas pelos serviço da Rede, para determinar a reação do usuário a alguns comandos.
- Flags
- As flags permitidas são:
- 1 - Achievements (+ c) - Ativa o sistema de achievements (conquistas): Permite o uso de comandos de achievements e envia mensagens de achievements.
- 2 - Notice (+ n) - Faz com que o bot envie NOTICE (AVISOS) ao usuário. Se esta flag não for definida, o bot se comunicará com o usuário usando PRIVMSGs (mensagens privadas).
- Requisitos
- 1 - Para realizar o comandos o usuário precisar estar autenticado.
Exemplos:
- 1 -
/msg Q USERFLAGS -n
- Retira a flag NOTICE n do usuário que executa o comando.
Users
Sintaxe: /msg Q USERS #canal
O comando USERS mostra informações de usuários do canal.
- Requisitos
- 1 - Para executar o comando USERS, o usuário deve ter pelo menos a flag de "usuário conhecido" (+ k) no CHANLEV do canal.
- Informações adicionais
- O executor do comando apenas poderá ver informações dos usuários daqueles canais em que o mesmo este, e que tenha os requisitos pertinentes para isso.
Exemplo:
/msg Q USERS #FuLLIRC
- Mostra a lista de usuários do #FuLLIRC com seus usernames e com as flags que os mesmo possam por ventura ter no canal.
- Comandos relacionados
Version
Sintaxe: /msg Q VERSION
O comando VERSION informa o número da versão e data da copilação do Q Bot.
Exemplo:
/msg Q VERSION
Voice
Sintaxe: /msg Q VOICE #canal {nick1} [nick2] [...]
Adiciona a flag voice (+ v) ao usuário nick1 no #canal.
- Requisitos
1 - Para utilizar o comando VOICE, o usuário deve ter no mínimo a flag de voice (+ v) na lista CHANLEV do canal.
No momento que o comando é utilizado para "dar" voice a outros usuários, os operadores do canal são informados, identificado o executor do comando, a menos que o mesmo tenha a flag no mínimo de Administrador/Mestre (+ m) na lista CHANLEV do canal.
- Informações adicionais
- O comando não pode ser usado para dar voz a usuários que estão impedidos de receber voice, por exemplo, através da flag de proibição de voice (+ q) no CHANLEV.
- Se o canal não é especificado no comando, o executor receberá voice em todos os canais que tenha acesso apropriado e que não tenha voice ainda.
- Ao dar voice a outros usuários ao invés dele mesmo, o usuário deve especificar o nick de outro usuário no canal.
- OBS:: Este comando NÃO adiciona a flag voice (+ v) à lista CHANLEV (+ v) do canal.
Exemplos:
- 1 -
/msg Q VOICE
- Dará voice em todos os canais que o usuário executor do comando tenha direito.
- 2 -
/msg Q VOICE #Brasirc
- Dará voice no #Brasirc ao usuário que executou o comando.
- 3 -
/msg Q VOICE #Brasirc bigua marlus
- Dará voice aos usuários bigua e marlus no #Brasirc
- Formas erradas de executar do comando
- 1 -
/msg Q VOICE #Brasirc #bigua
- Resposta do comando:
-Q- Can't find user #bigua.
- Causa: Tentar dar voice a um usuário através do nome da conta do mesmo.
- Comandos relacionados
Welcome
Sintaxe: /msg Q WELCOME #canal {mensagem}
O comando WELCOME mostra ou configura a mensagem de boas-vindas do canal.
- Requerimentos
- 1 - Para ver qual a mensagem de boas-vindas configurada, o usuário deve ter no mínimo o nível de Operador, (flag +o) na lista CHANLEV do canal.
- 2 - Para editar a mensagem de boas-vindas configurada, o usuário deve ter no mínimo o nível de Administrador/Mestre, (flag +m) na lista CHANLEV do canal.
- 3 - Para que o canal possa mostrar a mensagem de boas-vindas aos usuários que entram, a flag welcome (+ w) deve estar configurada no CHANFLAGS do canal.
- Informações adicionais
- A mensagem de boas-vindas é exibida por 'Q' para todos os usuários, desde que a flag de boas-vindas (+ w) esteja definida no CHANFLAGS. Todo usuário registrado no canal pode cancelar a mensagem de boas-vindas configurando a flag hidewelcome (+ w) no CHANLEV, evitando que a mesma lhe seja enviada.
- A mensagem de boas-vindas é enviada de forma privada.
- Se o prâmetro mensagem não é fornecida, o servidor retorna a mensagem
You can't set an empty welcome message
(ex. "campo_vazio" ou ""). O usuário pode desabilitar a mensagem de boas-vindas removendo a flag +w através do comando CHANFLAGS.
Exemplos:
- 1 -
/msg Q WELCOME #PTnet
- Mostra a mensagem de boas-vindas configurada no #PTnet.
- 2 -
/msg Q WELCOME #PTnet A maior rede de IRC Portuguesa, desde 1997
- 3 -
/msg Q CHANFLAGS #PTnet +w
- Habilita o canal a enviar mensagem de boas-vindas aos novos usuários.
- Comandos relacionados
Whoami
Sintaxe: /msg Q WHOAMI
Fornece informações da própria conta do usuário. É usado para verificar se o usuário esta autenticado em alguma conta e qual é essa conta.
- Informações adicionais
- Se autenticado, o Q Bot responderá com as seguintes informações:
- ID do usuário;
- Flags do usuário - As flags configuradas com o comando USERFLGAS
- Conta do usuário - Informações da conta a qual o nick esta autenticado no momento.
- Data de criação;
- Última autenticação;
- Último host - ident e host/ip são informados;
- Endereço de e-mail - Endereço de e-mail configurado na conta. Outros usuários não podem ver esta informação;
- Ultima vez que o e-mail foi configurado com o comando EMAIL;
- Última vez que a senha foi configurada com o comando NEWPASS;
- Todos os canais reconhecidos na conta do usuário com suas respectivas flags.
Exemplo
- 1 -
/msg Q WHOAMI
- Comandos relacionado
Whois
Sintaxe: /msg Q WHOIS {nick/#authname}
Fornece informações sobre um usuário ou nick.
- Informação adicional
- Se um nick é fornecido, então as respostas do Q Bot conterão informações da conta do usuários se o mesmo estiver autenticado. Se o usuário não estiver autenticado, o Q Bot não fornecerá informações da conta.
- O comando WHOIS pode ser usado, dentre outra coisas, para verificar se o usuário é proprietário da conta que afirma ser, para verificar se um usuário é membro do staff da Rede, para ver se o nick esta autenticado em alguma conta, para ver a última vez que um usuário autenticou-se etc.
- Se o usuário realizar o comando em si mesmo, o resultado da resposta será o mesmo que o comando WHOAMI.
- Requerimento
- Para realizar o comando, o nick deve estar autenticado em alguma conta.
Exemplos:
- 1 -
/msg Q WHOIS #xHantaro
- Retorna informações da conta de nome #xHantaro
- 2 -
/msg Q WHOIS xHantaro
- Retorna informações do nick xHantaro
- Formas erradas de execução do comando
- 1 -
/msg Q WHOIS Rafael
- Resposta do comando:
-Q- User Rafael is not authed
- Causa: Tentar realizar o comando em um nick não autenticado.
- 2 -
/msg Q WHOIS #Rafael
- Resposta do comando:
-Q- Can't find user #Rafael
- Causa: Tentar realizar o comando em uma conta não existente ou expirada.
- Comandos relacionados
- ↑ «Q Commands (ENG)». QuakeNet IRC Network - Help. Consultado em 1 de Janeiro de 2021