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