Documenta��o do NordicBot
Introdu��o
Bem vindo � p�gina de documenta��o do Nordicbots! Est� p�gina deve conter todas as informa��es que voc� precisa quando vai usar/requisitar um bot do Nordicbots. Abaixo h� uma lista de assuntos, clique em um nome para pular para a se��o:
Informa��es Gerais - Mostra informa��es gerais sobre nossos bots. Entra em detalhe em assuntos como requisitar, identificar, userlevels, etc.
Comandos Globais - Lista todos os comandos que n�o est�o relacionados com canais.
Comandos relacionados com canais - Lista todos os comandos que voc� pode user em/para canais.
Configura��o de canal - Lista todas as configura��es dispon�veis para um canal.
Comandos p�blicos - Lista todos os comandos p�blicos dispon�veis e algumas informa��es importantes sobre votes, quotes, triggers, commandchar, etc.
Informa��o Geral
Conseguindo um bot
Se voc� n�o tem um bot no seu canal ainda, e quer um, ent�o voc� pode requisitar. Requisi��es podem ser feitas atrav�s da requisi��o web. Entretanto, antes de requisitar um bot, por favor leia nossas regras cuidadosamente! Voc� pode usar a requisi��o do IRC tamb�m no #NordicBots usando o /msg NB-Request request <chan> <botnick> <email>. Voc� precisa estar autenticado para requisitar um bot.
Movendo seu bot para um canal diferente
Se voc� quer mover seu bot de um canal para outro, voc� precisa entrar no #NordicBots e digitar: !move #oldchan #newchan. Apenas donos (owners) podem mover um bot. Quando voc� mover seu bot ele manter� as listas de usu�rios e as configura��es do canal (incluindo o stats). Se n�o quiser manter o stats voc� pode pedir para um membro do staff para reset�-lo.
Mudando seu bot
Se voc� ficar cansado do nick do seu bot ent�o voc� pode mud�-lo para o nick de outro bot que esteja dispon�vel apenas digitando /msg <bot> CHANGEBOT <chan> <newbot>. Antes de tentar mudar o seu bot por favor veja a lista de bots dispon�veis aqui. Todas as configura��es se manter�o as mesmas.
Removendo seu bot
Quando o canal por alguma raz�o for fechado ou n�o for mais usado ou voc� n�o precisa de um bot mais, por favor entre no #NordicBots e digite: !remove <chan> <raz�o> para remover seu bot. Apenas owners podem remover um bot.
Canal suspenso?
Se voc� quebrar nossas regras ou algu�m mais do seu canal o fizer, n�s iremos suspender o seu canal. Isto significa que o bot sair� por 7 dias, mas manter� as configura��es e usu�rios. Se n�o for tirado a suspens�o dentro desse periodo, ele ser� automaticamente removido. Donos de canal receber�o um email sobre a suspens�o. Voc� pode ver se o seu canal est� suspenso aqui. Se seu canal est� suspenso e voc� quer de volta, por favor entre no #NordicBots e pe�a � algum membro do staff para tirar a suspens�o do seu canal.
Identification
Nossos bots reconhecem voc� pelo seu Q-AUTH (seu AUTH no bot Q da Quakenet). Para usar os comandos de nossos bots, voc� precisa se autenticar no Q primeiro. Depois que tiver feito isso, voc� estar� apto a usar os comandos listados nessa p�gina. Se o bot disser que n�o te conhece, disser que voc� n�o est� autenticado, ou que voc� n�o tem acesso, tente o seguinte comando:
/msg <bot> IDENT
Note que os bots n�o ir�o responder depois desse comando (voc� vai receber apenas um notice que o bot ir� checar se voc� est� autenticado), tente usar os comandos novamente alguns segundos depois disso, e voc� provavelmente vai estar pronto. Se tiver algum problema, sinta-se livre para pedir ajuda no #NordicBots.
N�vel dos usu�rios
O n�vel de um usu�rio diz quanto ele pode fazer num canal. O n�veis dispon�veis s�o:
| Amigo (Friend) | N�o ser� punido por fazer 'coisas ruins' (como floodar ou fazer propaganda). |
| Voice | Pode usar o comando VOICE para ganhar voice (+v) no canal e receber� voice automaticamente se o CHANSET 'autovoice' estiver ativo. |
| Op | Pode usar o comando OP para conseguir (+o) no canal e dar� op automaticamente se CHANSET 'autoop' estiver ativo. |
| Master | Pode mudar v�rias configura��es no canal atrav�s do comando CHANSET. Pode adicionar usu�rios com n�vel Friend, Voice ou Op.. |
| Dono(Owner) | Tem o controle total do canal. Pode adicionar usu�rios com n�vel Master e Donos (owners). |
Muitas permiss�es s�o acumuladas, o que significa que algu�m com n�vel OP, n�o ser� kickado por fazer 'coisas ruins' e pode usar o comando VOICE para conseguir (+v) no canal.
top
Comandos Globais
Os comandos seguintes podem ser usados atrav�s de /msg <bot> <command>, por exemplo: /msg <bot> help
Comandos dispon�veis para qualquer um
| HELP | Mostra o help completo de um comando particular. |
| IDENT | Identifica voc� como um usu�rio em particular no bot (�til se voc� se identificou no Q depois de entrar). |
| SHOWCOMMANDS | Lista todos os comandos que est�o dispon�veis para voc� - CUIDADO: � uma lista grande! |
| VERSION | Mostra a vers�o corrente do nosso servi�o de bot. |
| WHOAMI | Mostra a opini�o do bot sobre quem voc� �. |
Comandos apenas dispon�vel para usu�rios identificados no Q (e reconhecidos pelo bot)
| ACCESS | Diz os n�veis de todos no canal. |
| ADDNOTE | Adiciona um lembrete para uma data e hora espec�fica (atualmente apenas para a zona Central European). |
| EMAIL | Seta seu email, n�s apenas enviamos mensagens importantes para este email.. |
| LISTNOTES | Lista todas as notas que voc� adicionou com ADDNOTE. |
| WHOIS | Diz a opin�o do bot sobre quem � algu�m. |
Isto � sobre os comandos que n�o est�o relacionados com canais. Para uma lista de comandos relacionados com canais, veja abaixo.
top
Comandos relacionados com canal
Os comandos seguintes podem ser usados atrav�s do /msg <bot> <command>, por exemplo: /msg <bot> help
Comandos dispon�veis para usu�rios 'Friend' e n�veis maiores
| INVITE | Convida voc� para o canal |
| SETTOPIC | Mostra (ou seta se tiver n�vel de master ou maior) o t�pico para o canal. |
Comandos dispon�veis apenas para usu�rios com n�vel 'Voice' ou maior
| DEVOICE | Remove o seu (ou de outros usu�rios se voc� tiver n�vel de OP ou maior) voice (-v) no canal. |
| VOICE | D� a voc� (ou outro usu�rio se tiver n�vel de OP ou maior) voice (+v) no canal. |
Comandos dispon�veis apenas para usu�rios com n�vel de 'OP' ou maior
| BAN | Seta o ban no canal. |
| DEOP | Remove o seu (ou de algum usu�rio se voc� tiver n�vel master ou maior) op (-o) no canal. |
| KICK | Kickar algu�m do canal. |
| OP | D� a voc� (ou a algu�m se voc� tiver n�vel de Master ou maior) op (+o) no canal. |
| SAY | Faz o bot dizer alguma coisa no canal. |
| UNBAN | Remove o ban do canal (e do bot). |
| UNBANALL | Remove TODOS os bans n�o fixo do canal. |
Comandos apenas dispon�veis para usu�rios com n�vel 'Master' ou maior.
| ADDBADWORD | Adiciona um palavr�o, leia mais informa��es sobre badwords. |
| ADDTRIGGER | Adds/updates a public trigger, read below for information about triggers. |
| CHANLEV | Isso � um atalho para o USERLEV e funciona da mesma maneira. |
| CHANSET | Sets various channel settings, read below for a list of available settings. |
| CYCLE | Faz o bot reentrar (sair e entrar) no canal. |
| DELALLBANS | Remove todos os bans do canal |
| DELBADWORD | Remove um palavr�o que foi adicionado com ADDBADWORD. |
| DELTRIGGER | Remover uma trigger p�blica que foi adicionada com ADDTRIGGER. |
| GREET | Setar a sauda��o (greet) de algu�m no canal. |
| MODTRIGGER | Modifica uma trigger j� adicionada. Leia mais informa��es sobre triggers. |
| USERLEV | Seta o n�vel de algu�m no canal, leia abaixo a lista dispon�vel den�veis. |
Comandos dispon�veis apenas para usu�rios com n�vel de 'Owner'
| CHANGEBOT | Permite mudar o bot no seu canal por outro bot do NordicBots. Todos as configura��es permanecer�o. |
top
Configura��es de canal
As configura��es a seguir podem ser setadas com o comando CHANSET (que precisa de n�vel Master ou Owner para ser usado).
Para ativar: /msg <bot> CHANSET <chan> +<setting> [extra]
Para desativar: /msg <bot> CHANSET <chan> -<setting>
Configura��es dispon�veis
| advertise | Liga a anti-propaganda que ir� advertir usu�rios e ban�-los por 5 minutos se eles fizeram propaganda |
| autoop | Automaticamente d� op para todos com n�vel de 'OP' ou maior quando entrarem no canal. Nota: Isto N�O ir� dar op para todos, � imposs�vel para nossos bots e � contra nossas regras. |
| autovoice | Automaticamente d� voice para todo mundo com n�vel 'Voice' quando entrarem no canal. Nota: Se quer que d� voice para todos, use 'massvoice'. |
| badwords | Habilita o 'badwords' (palavr�o) para avisar/kickar/banir se qualquer usu�rio usar qualquer das palavra cadastrada. Leia mais sobre o sistema de badwords. |
| bitch | Impede que pessoas sem autoriza��o recebam ops no seu canal tirando o op quando algu�m d�. |
| commandchar | Este comando simplifica certos comandos permitindo voc� usar triggers como "!" e "?" para os comandos (como !op e ?kick). leia mais sobre commandchar abaixo. |
| dynamicbans | Remove bans que n�o s�o fixos [minutos] minuto(s) depois de setados no canal (padr�o: 5min). Leia mais sobre o sistema de ban abaixo. |
| flood | Habilita anti-flood que ir� avisar usu�rios e ban�-los por 5 minutos se eles falarem mais de <x> linhas em <y> segundos. |
| greet | Se ativado, o bot ir� dizer algo para o usu�rio que tem uma messagem greet guardada para ele ( Usando o commando GREET). |
| hidelogs | Habilite est� op��o se voc� quiser ativar o stats no seu canal mas prefere n�o ter pessoas vendo seus logs. Isto torna-o invis�vel, desativando torna-o vis�vle dinovo. |
| infobot | Habilita v�rios comandos como !date e chaninfo?. |
| massvoice | Automaticamente d� voice para todo mundo especificado pelo m�scara (o padr�o � todo qualquer um) quando entrar no canal.. |
| modes | Faz o bot setar os modos dados no canal. |
| onjoin | Seta o notice de entrada que envia para todo usu�rio que entrar (%n � substituido pelo nick de quem entrar, %p mostra o peak do canal). |
| peak | Faz o bot guardar o peak no seu canal e ativa o comando !peak . |
| quotes | Ir� ativar o uso de quotes no canal. Ler mais sobre quote abaixo. |
| showbanby | Se setado, mostra o auth/nick do usu�rio que setou o ban quando kickar. (padr�o: habilitado). Leia mais sobre o sistema de ban abaixo. |
| stats | Se ativado, o bot ir� guardar os logs para seu canal e o stats ser� gerado a cada 3 horas. Ler mais abaixo. |
| statslang | Permite voc� mudar a l�ngua no qual � gerado o stats. Leia abaixo a lista dispon�vel de l�nguas. |
| timedquotes | Habilite esta fun��o se voc� quiser que o bot mostre quotes aleat�rios de tempos em tempos. |
| timezone | Setar o timezone (fuso hor�rio) para o seu canal (ser� usado com !date). |
| topic | Se ativado, o bot ir� permitir que apenas master/owners mudem o topic. |
| tv | Habilita o comando !tv que mostra o que est� passando na TV sueca. |
| userbans | Permite (TODOS) usu�rios setar o ban manualmente (sen�o os bans ter�o que ser setados via bot) (padr�o: habilitado). Leia mais sobre sistema de ban abaixo. |
| vote | Habilita o comando !vote que permite usu�rios a come�ar a votar no seu canal. Leia mais sobre o vote abaixo. |
Estat�sticas (stats)
Nossos bots podem criar estat�sticas para o seu canal se voc� ativar o 'stats' no CHANSET (� explicado abaixo). Por exemplo de como a p�gina parece, veja
aqui, este � o stats do nosso canal. Haver� tamb�m uma p�gina mostrando o log das atividades do seu canal, como mostrado
aqui. Se voc� deseja esconder os logs no seu canal use o 'hidelogs' do CHANSET (como explicado abaixo). Isto ir� tornar os logs escondidos. Se for desativado seus logs ser�o mostrados novamente.
Como explicado abaixo, voc� pode usar o 'statslang' do CHANSET para mudar a l�ngua no qual o stats � gerado, aqui est� a lista de l�nguas suportadas:
Albanian - al
Bulgarian - bg
Catalan - ca
Czech - cz
Danish - dk
Dutch - nl
Dutch (Flemish) - be
English - en
Estonian - ee
Finnish - fi
|
French - fr
German - de
Greek - gr
Hebrew - he
Hungarian - hu
Icelandic - is
Italian - it
Norwegian - no
Polish - pl
Portuguese - pt
|
Portuguese (Brazil) - br
Romanian - ro
Russian - ru
Serbian - yu
Slovak - sk
Slovenian - si
Spanish - es
Swedish - se
Turkish - tr
|
Se sua l�ngua n�o est� adicionada e voc� que traduzir para n�s, sinta-se livre para contactar um de nossos administradores no
#NordicBots.
Comandos p�blicos
Os comandos abaixo podem ser usados por todos os usu�rios no canal que tem as configura��es setadas propriamente ativadas.
Badwords(palavr�o)/Propaganda/op��es de flood
Voc� pode habilitar o modo badwords com:/msg <bot> CHANSET <chan> +badwords [tipo] [dura��o]
Voc� pode habilitar o modo de propaganda com:/msg <bot> CHANSET <chan> +advertise [tipo] [dura��o]
Voc� pode habilitar o modo de flood com:/msg <bot> CHANSET <chan> +flood [linhas:seg] [tipo] [dura��o]
Como voc� pode ver, estas op��es tem poucos parametros para serem usados, abaixo tem uma lista com os bodos que voc� pode usar:
As you can see, these settings have a few parameters which can be used, below is a list of the modes you can use:
| warn | Alerta os usu�rios. |
| warn+kick | Avisa os usu�rios e kicka os usu�rios. |
| warn+ban | Avisa os us�rios e depois bane.* |
| kick | Kicka os usu�rios sem avisar. |
| ban | Bane os usu�rios sem aviso. * |
As fun��es marcadas com '*' banem o usu�rio. Voc� pode setar a dura��o do preenchendo o parametro 'dura��o' com o n�mero de minutos vo� quer que o usu�rios fique banido, se n�o setar a dura��o o padr�o de 5 min ser� usado.
Adicionando palavr�es
Uma vez ativado a op��o do canal, voc� pode come�ar a adicionar os palavr�es. Palavr�es podem ser adicionados pelo:
/msg <bot> ADDBADWORD <chan> <badword>
Palavr�es podem ser removidos pelo comando 'DELBADWORD'.
top
Sistema de ban
M�todos de ban( tipos de alvo):
/msg <bot> ban #chan nick 7d <reason> | Ir� banir o usu�rio pelo host e se o usu�rio estiver identificado ele o auth ser� banido tamb�m. |
/msg <bot> ban #chan #auth 7d <reason> | Ir� banir o usu�rio pelo auth. |
/msg <bot> ban #chan *!*@host 7d <reason> | Ir� banir o host. |
M�todos de ban(dura��o e raz�o):
/msg <bot> ban #chan <target> | Ir� banir o target (alvo) por 1 hora (= padr�o) com a reason (motivo) 'Requested' (= padr�o). |
/msg <bot> ban #chan <target> 7d | Ir� banir o target (alvo) por 7 dias com a reason (movito) 'Requested' (= default). |
/msg <bot> ban #chan <target> perm <reason> | Ir� banir o target (alvo) permanentemente com o reason (motivo). |
M�todos de ban (especial):
/msg <bot> ban #chan <target> 7d *<reason> | Ir� banir o target (alvo) da maneira normal mas far� o ban ser permanente.(ver [1]). |
Metodos de Unban:
/msg <bot> unban #chan nick | Ir� remover todos os bans que combinar com o usu�rio (se poss�vel). |
/msg <bot> unban #chan #auth | Ir� remover todos os bans que combinarem com o auth (se poss�vel). |
/msg <bot> unban #chan *!*@* | Ir� remover um ban espec�fico (se encontrar). |
/msg <bot> unbanall #chan | Ir� remover todos os bans n�o permanentes do canal. |
/msg <bot> delallbans #chan | Ir� remover todos os bans do canal. |
[1] Fixo significa que o bot ir� sempre tentar setar o ban no canal (e resetar quando for removido).
top
Commandchar
Est� fun��o permite que voc� use o comando de triggers com "!" ou "?" para certos comandos. Ver lista de comandos abaixo.
Voc� pode habilitar isto com: /msg <bot> CHANSET <chan> +commandchar <character>
Por exemplo, usando +commandchar !, ir� habilitar comandos como !kick. Usando +commandchar . ir� habilitar .kick
| access <nick> | Mostra o accesso de algu�m no canal. |
| addtrigger <trigger> <text> | Adiciona uma trigger ao canal. |
| deltrigger <trigger> | Remove uma trigger do canal. |
| kick <nick> | Kicka algu�m do canal. |
| ban <nick> | Bane algu�m do canal. |
| unban <nick> | Remove um ban do canal. |
| voice <nick> | D� a voc� (ou a algum outro usu�rio se voc� o n�vel de OP ou maior) voice (+v) no canal. |
| devoice <nick> | Remover seu (ou de algu�m se voc� tiver n�vel de OP ou maior) voice (-v) no canal. |
| op <nick> | D� a voc� (ou a algu�m se voc� tiver n�vel de master ou maior) op (+o) no canal. |
| deop <nick> | Remove o seu (ou de algu�m se voc� tiver n�vel de Master ou maior) op (-o) no canal. |
| greet <nick> | Seta uma sauda��o para um usu�rio no canal. |
| chanset <setting> | Seta ou remove uma configura��o no canal. |
| userlev <nick> <level> | Seta o accesso da algu�m no canal. |
top
Sistema de quote
Voc� pode habilitar o sistema de quote com: /msg <bot> CHANSET <chan> +quotes
Os seguintes comandos est�o dispon�veis:
| !quote | Use para mostrar quotes randomicos. |
| !quote add <text> | Use para adicionar um quote. |
| !quote info <id> | Use para conseguir informa��o sobre um quote com um ID. |
| !quote find <text> | Use para encontrar um quote com um certo texto. |
| !quote del <id> | Use para deletar um quote com um dado ID. |
top
Sistema de triger
� poss�vel para os masters ou owners do canal adicionar triggers p�blicos como !ip, !help, ?info, .status etc. que ir�o mostrar umal inha customizada de texto.
Para adicionar/atualizar triggers use: /msg <bot> ADDTRIGGER <chan> <trigger> <text>
Para adicionar triggers use: /msg <bot> DELTRIGGER <chan> <trigger>
Tipos de Trigger
Triggers podem ser de 3 tipos diferentes: Publico (-public, padr�o), Privado (-private, envia uma mensagem privada) e Notice (-notice, envia uma mensagem como um notice).
N�veis
Triggers podem ser limitados por certos n�veis. Voc� pode por exemplo, apenas fazer o trigger dispon�vel apenas para masters e owners. Voc� pode checar n�veis dispon�veis aqui.
Argumentos
Podem ser de 3 tipos diferentes: Publico (-public, o padr�o), Privado (-private, envia uma resposta como uma mensagem privada) and Notice (-notice, envia uma resposta como um notice).
Voc� pode usar %1 %2 ... %9 como identificadores para se referir aos parametros de linha. Pode tamb�m usar %N- para se referir aos N parametros seguintes (para pegar os argumentos + qualquer argumento ao lado).
Um exemplo com argumentos: /msg ^Donkey^ ADDTRIGGER #NordicBots !test /me slaps %1 around a bit with %2-
E ent�o se voc� digitar: !test NB-Service a large trout
Ir� mostrar um action: ^Donkey^ slaps NB-Service around a bit with a large trout
Sistema de vota��o
Voc� pode habilitar o sistema de vota��o com: /msg <bot> CHANSET <chan> +vote
Os seguintes comandos est�o dispon�veis:
| !vote start | Use para iniciar uma nova vota��o no seu canal: !vote start <duration> <question> Necessita que o usu�rio seja adicionado ao canal. |
| !vote no | Use para votar n�o. |
| !vote yes | Use para votar sim. |
| !vote status | Use para checar o status da vota��o pendente. |
| !vote stop | Use para parar a vota��o. |
top
V�rios comandos
Aqui voc� pode ver a lista sobre os comandos p�blicos.
| !date | Mostra a data corrente e o hora no seu canal. Se a hora estiver errada, tente ajustar o 'timezone' aqui. |
| !google <keyword> | Se voc� ativar CHANSET +infobot, voc� pode usar o seu bot para pesquisar uma certa palavra no www.google.com. Ir� retornar 2 resultados se houver algum. | |
| !image <keyword> | Se voc� ativar esseCHANSET +infobot, voc� pode usar o bot para pesquisar por imagens no www.google.com. Ir� retornar 2 resultados (se houver algum). |
| !peak | Quando CHANSET +peak est� ativado, o comando mostra o maior n�mero de usu�rios no canal. |
| chaninfo? | Mostra o link do info do canal. Esta p�gina mostra as configura��es, usu�rios, quotes, bans e triggers. Note que esta p�gina � tamb�m dispon�vel por aqui. |
| stats? | Mostra o link para a p�gina de estat�sticas e de log. Tamb�m est� dipon�velaqui. |
Se voc� tiver alguma pergunta ou precisar de ajuda enquanto estiver usando nossos servi�os por favor entre no #NordicBots.
top
brunette
