Portal:CService/QuakeNet/Comandos

Comandos: ADDUSER, AUTH, AUTHHISTORY, AUTOLIMIT, BANCLEAR, BANLIST, BANDEL, BANTIMER , CHALLENGE, CHANFLAGS, CHALLENGEAUTH, CHANMODE, CHANLEV, CHANSTAT, CHANOPHISTORY, CLEARCHAN, DEOPALL, EMAIL, GIVEOWNER, HELLO, HELP, INVITE, NEWPASS, OP, PERMBAN, RECOVER, REMOVEUSER, REQUESTOWNER, REQUESTPASSWORD, RESET, SETTOPIC, SHOWCOMMANDS, UNBANALL, UNBANMASK, UNBANME, USERFLAGS, VERSION, USERS, VOICE, WELCOME, WHOAMI, WHOIS

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.

• Flags

Você poder usar os vários flags que se encontram no comando CHANLEV, exceto as flags de administrador (+ 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.

• 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.

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 (+ 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

CHANLEV, AUTH

[ Início ] [ Topo ]

Auth

Sintaxe 1: /AUTH #canal {usuário} {senha}

Sintaxe 2: /msg [email protected] AUTH {usuário} {senha}

O comandos AUTH autentica um usuário na Rede.

• 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.

• 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

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

REQUESTPASSWORD, HELLO, CHALLENGEAUTH

[ Início ] [ Topo ]

Authhistory

Sintaxe: /msg Q AUTHHISTORY

O comando AUTHHISTORY informa o histórico de autenticação do usuário que o executa.

• Requisitos

Para realizar o comandos, o usuário deve estar autenticado.

• 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.

[ Início ] [ Topo ]

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 (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

CHANFLAGS, CHANMODE

[ Início ] [ Topo ]

Banclear

Sintaxe: /msg Q BANCLEAR #canal

O comando BANCLEAR deleta todos os banimentos do canal.

• Requerimentos

Para executar o comando, o usuário deve ter pelo menos o nível de "Administrador" (flag + m) no CHANLEV 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.

Exemplos:

/msg Q BANCLEAR #Brazink

Deleta todos os banimentos do #Brazink.

• Comandos relacionados

BANDEL, BANLIST, PERMBAN, TEMPBAN, UNBANALL

[ Início ] [ Topo ]

Bandel

Sintaxe: /msg Q BANDEL #canal {#num|máscara}

O comando BANDEL deleta um banimento específico do canal.

• Parâmetros

1. 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.

• 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" (flag + m) no CHANLEV do canal.

• Informação adicional

Para realizar/remover um banimento permanente é necessário usar a flag do CHANLEV (+ b).

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

BANCLEAR, BANLIST, PERMBAN, TEMPBAN

[ Início ] [ Topo ]

Userflags

Sintaxe: /msg Q USERFLAGS [+|- flags]

Modifica a própria flag do usuário que executa o comando.

• Requisitos

1 - Para realizar o comandos o usuário precisar estar autenticado.

• 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).

Exemplos:

1 - /msg Q USERFLAGS -n

Retira a flag NOTICE n do usuário que executa o comando.

[ Início ] [ Topo ]

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

CHANLEV

[ Início ] [ Topo ]

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

[ Início ] [ Topo ]

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" (+ 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

CHANLEV, CHANFLAGS, OP

[ Início ] [ Topo ]

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", (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

CHANFLAGS, CHANLEV

[ Início ] [ Topo ]

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

AUTH, CHANLEV, EMAIL, NEWPASS, USERFLAGS

[ Início ] [ Topo ]

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

CHANLEV, WHOAMI

[ Início ] [ Topo ]