MIRC Script

Origem: Wikipédia, a enciclopédia livre.

O título dado a este artigo encontra-se incorrecto devido a limitações técnicas. O título correcto é mIRC Script .

mIRC Script, ou mIRC Scripting, é uma linguagem de programação de script (interpretada), integrada com o mIRC, criada por Khaled Mardam-Bey, e que apenas pode ser usada através do mIRC. Esta linguagem permite que existam inúmeros addons, e scripts completos. Para a lista completa de comandos do mIRC veja o help file incluído no mIRC.

Esta linguagem torna muito simples a criação de qualquer código pois ela é de muito alto nível e torna muito simples a utilização de sockets, dialogs, popups, função, variável, leitura/escrita de ficheiros, etc. Contendo centenas de comandos/funções que permitem fazer quase tudo, o que não poder ser feito com mIRC Scripting pode sempre ser feito através de DLLs escritas em outras linguagens de programação.

[editar] Conceitos Básicos

O mIRC Scripting é usado normalmente para criar scripts, addons com funções interesantes, bots, etc...

Atenção que dependendo da versão do mIRC nem todo o código é portatil, já que alguns comandos são adicionados, outros modificados... Para pormenores das diferenças entre as versões do mIRC veja o versions.txt

[editar] Bot

Um Bot (vem de robot) é um script que é normalmente usado para executar tarefas num canal de IRC, pode exibir mensagens aos utilizadores que entram no canal, e realizar uma série de rotinas automaticamente ao comando de um utilizado (com ou sem acesso).

[editar] Addon

Addon é um script que normalmente executa uma tarefa específica como por exemplo mandar emails, fazer perquisas no google, fazer download utilizando o protocolo http, etc.

[editar] Script

Normalmente quando se fala em script está-se a falar de uma distribuição para o mIRC que engloba várias utilidades que faz com que a sua utilização seija mais simples ou completa que o mIRC em si.

[editar] Editor

Para se aceder ao editor do mIRC onde são escritos os códigos faz-se ALT+R.

O editor está dividido em 5 secções:

[editar] Aliases

As aliases são o que noutras linguagens se chama de função (ou procedimento), isto permite criar mais comandos que não existem no mIRC Scripting, estas aliases podem ser usadas por outras aliases, popups, remotes ou pela linha de comandos do mIRC.

Exemplo:

dizdata echo -a Data: $date

Nota: Isto deve ser insirido na secção das Aliases

Este código escreve a data na janela actual (daí o parâmetro -a do comando echo). Para esta alias ser executada basta escrever /dizdata

Para aliases com mais de uma linha (é possível executar mais de um comando numa linha com o separador | ) deve-se incluí-las entre chavetas, as aliases podem devolver parametros e/ou receber parametros.

Exemplo:

conta {
  var %contador = 1
  while (%contador <= $1) {
    echo -a %contador
    inc %contador
  }
  ;devolve o valor
  ;já agora, isto é um comentario =)
  return Contei até $1
}

Este código é um pouco mais complexo, basicamente ele conta até o número do 1º parametro ($1) exprimenta fazer /conta 10 para veres o que devolve faz //echo -a $conta(10) esta é a maneira de fazer a alias devolver um valor, atenção que deve ser precedida por duas / para indicar que não se pretende escrever $conta(10) mas sim o que essa alias devolver.

As aliases podem também ser insiridas nos Remotes desde que precedidas por alias:

alias teste echo -a só pa ver se funciona...

[editar] Popups

Esta seção serve para criar as janelas que aparecem quando se carrega (clica) com o botão direito do rato em algum lugar, estes lugares podem ser:

Status - Janela do "status" do sistema
Channel - Canal
Query - "PVT" (do inglês: private) ou mensagem privada
Nick List - Lista dos nicks (apelidos) dos usuários do canal
Menu Bar - Menu na parte superior

Cada um é independente do outro e pode-se saltar entre eles carregando no menu View no editor.

Exemplo:

Nick
.Mostra: echo -a O teu nick é $me
.Mudar: nick $$?="Insira novo nick" | echo -a nick mudado
-
Sair: exit

O . (ponto) indica que o item pertence a um submenu. Pode-se criar quantos submenus forem necessários, acrescentando mais um . Ao clicar no item, o mIRC executa o comando. O - (hífen) cria um separador entre os itens.

Também podem ser feitas as popups através dos Remotes

[editar] Remote

O Remote é um dos mais importantes, já que permite fazer tudo o que as secções Aliases e Popups fazem e muito mais. Os Remotes permitem fazer dezenas de coisas (como dialogs) mas só vamos abordar os eventos.

O mIRC pode reagir a vários eventos.

Exemplo:

on *:start: echo -s Olá! Tas Bom $me $+ !?

Este evento (on start), é executado quando o mIRC abre, ele escreve na janela do Status "Olá! Tas Bom teu_nick!?", o $+ une o que devolver $me com o que estiver a seguir, ja que estando tudo junto ele vai tentar chamar a função $me!? em vez de $me

Entre dezenas de eventos vale também apena destacar o on text:

Exemplo:

on *:text:!calc *:#teste: {
  msg $chan $nick $+ , o resultado da tua conta é $calc($2-)
}

Ao dizer o texto !calc (qualquer coisa) no canal #teste (este campo também permite wildcards) o mIRC vai automaticamente enviar para o canal ($chan) a mensagem "nick_que_deu_origem_ao_envento, o resultado da tua conta é resultado_da_conta_que_foi_escrita_a_seguir_a_!calc"

[editar] Users

Lista de users e seu nivel de acesso, para os eventos dos remotes. Isto permite que um evento só seja accionado por exemplo por utilizadores de nivel x de acesso.

[editar] Variables

Lista das variaveis e seu valor que pode ser criadas/modificadas com o comando /set %variavel valor
Todas as variaveis (exepto as binarias) são antecedidas pelo caracter %

[editar] Ver também

[editar] Ligações externas

((en))mIRC - site oficial
((en))mIRC.net - addons, scripts e outros conteúdos relacionados com o mIRC
((en))ScriptingX - com addons, scripts e outros conteúdos relacionados com o mIRC
((en))mircscripts.org - addons, scripts e outros conteúdos relacionados com o mIRC
((pt)) PTscripting - site/fórum com addons, scripts e outros conteúdos relacionados com o mIRC