Mudanças entre as edições de "Portal:CService/QuakeNet/Comandos"

Origem: IRChelp Brasil - Wiki
Ir para navegação Ir para pesquisar
(Adição dos comandos USERS e VERSION)
(Adição do comando USERFLAGS)
Linha 233: Linha 233:
 
</div>
 
</div>
 
<div style="float:right; width:48%;  text-align: justify; padding: 10px ">
 
<div style="float:right; width:48%;  text-align: justify; padding: 10px ">
 +
== Userflags ==
 +
Sintaxe: <code>/msg Q '''USERFLAGS''' [+|- '''flags''']</code>
 +
 +
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 ''flags''que 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 - <code>/msg Q '''USERFLAGS''' -n</code>
 +
 +
: Retira a ''flag'' ''NOTICE'' <u>n</u> do usuário que executa o comando.
 +
 +
[ [[#comandos|Início]] ] [ [[#top|Topo]] ]
 +
 
== Users ==
 
== Users ==
 
Sintaxe: <code>/msg Q '''USERS''' #canal</code>
 
Sintaxe: <code>/msg Q '''USERS''' #canal</code>

Edição das 13h56min de 4 de janeiro de 2021

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 [1]

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 ]

  1. «Q Commands (ENG)». QuakeNet IRC Network - Help. Consultado em 1 de Janeiro de 2021