Esta parte descreve os comandos relacionados aos scripts do mIRC.

Barra de Divisão

Comando Alias

Adiciona, remove ou substitui uma defini��o de alias. Este comando se limita a trabalhar com aliases de uma linha. N�o � poss�vel adicionar, alterar ou remover um alias de linhas m�ltiplas (com blocos de comandos indicados por { }), apesar de ser poss�vel criar um alias que executa uma s�rie de tarefas em sequ�ncia (atrav�s do caract�r |).

Modo de Usar: /alias {arquivo} {alias} {comandos}

Exemplos:
/alias propaganda /say Isto � uma propaganda!!    Define um comando /propaganda que envia a frase especificada para a janela ativa (que pode ser de um canal ou conversa privada).
/alias aliases.ini bye /quit Desconectando!! | /echo -s Desconectado!!    Insere no arquivo aliases.ini, a defini��o do comando /bye que faz o mIRC se desconectar do servidor e mostras na janela de Status a mensagem "Desconectado!!".
/alias propaganda    Remove o alias /propaganda se este existir.

Observa��es:
Um alias � um comando, geralmente em forma compacta, que executa outro comando ou uma sequ�ncia destes.
Para carregar as defini��es alias de um arquivo, use o comando /load.


Comando Auser

Adiciona em sua lista de usu�rios um determinado nick ou endere�o com determinado n�vel de acesso. Se for usada a op��o -a, o n�vel especificado ser� adicionado ao user se este j� estiver incluido na lista.

Modo de Usar: /auser {-a} {n�vel geral,n�vel especial1,n�vel especial2,...} {nickname|endere�o}

Exemplos:
/auser 5 Killer
/auser -a 7,9 Killer
/auser -a 7,=9 Killer   
Equivalente ao comando acima. /auser 5 *[email protected]

Observa��es:
Um endere�o ou nick poder� ter apenas um n�vel geral. Isto significa que o usu�rio de n�vel geral 5 (primeiro exemplo) ter� acesso aos eventos e comandos (ctcp scripts) de n�vel 5 e menores que 5, com excess�o aos eventos e scripts que utilizam o sinal '+' e com n�vel diferente de 5. O sinal '+' em um script, como em +3:on join:..., d� acesso apenas aos usu�rios que tenham n�vel 3.
Nesse caso, aparece os n�veis especiais, informados depois do n�vel geral (como no exemplo 2) ou adicionados com o sinal '=' quando o n�vel geral n�o for especificado. Se s� o n�vel geral for especificado, este n�vel substitui o n�vel geral que j� tenha sido especificado anteriormente.
Dessa forma, o primeiro exemplo atribui n�vel geral 5 ao Killer. O segundo atribui ao mesmo um n�vel especial 9 e substitui seu n�vel geral 5 por 7, transformando o n�vel 5 em especial. No final, seu n�vel ser� <7,=9,=5>, ou seja, ter� acesso aos eventos e comandos de n�vel 1, 2, 3, 4, 5, +5, 6, 7, +7, 9, +9.
Um usu�rio que esteja em um n�vel maior n�o ter� necessariamente mais vantagens ou poderes. Isto depende dos scripts que estiverem sendo usados.
Veja a p�gina Dicas para o mIRC para conferir exemplos de scripts e uma explica��o sobre os n�veis de acesso.


Comando Clipboard

Copia o texto especificado para a �rea de transfer�ncia do Windows. Pode-se usar identificadores atrav�s de //clipboard

Modo de Usar: /clipboard {texto} ou //clipboard {texto} {$ident}

Exemplos:
/clipboard Texto a ser copiado.
//clipboard O endere�o do(a) $nick � $remove($address($nick,2),*!*@)


Observa��es:
A defini��o de identificadores est� no comando /echo mais abaixo.
No segundo exemplo, usamos o identificador $nick que retorna o nickname do usu�rio ($nick s� deve ser usado em janela de query ou um script a partir da lista de nicks de um canal).
O $remove retira a express�o (no caso, *!*@) de uma determinada string (no caso, essa string � retornada por $address).
O $address retorna o endere�o de um nick no formato especificado pelo tipo (no caso, foi usado o tipo 2, e o endere�o teria o formato *!*@host.dom�nio). Logo, o segundo exemplo, se executado numa janela de query/chat, copiaria na �rea de transfer�ncia algo do tipo "O endere�o do(a) Killer � modem3.provedor.com.br".


Comando Commands

Liga ou desliga a se��o Tools/Remote/Commands (uso dos chamados scripts) ou mostra o seu status.

Modo de Usar: /commands {on|off}

Exemplos:
/commands on
/commands



Comando Disable

Desativa um grupo de Events ou Commands. Este � um comando usado por quem utiliza scripts.

Modo de Usar: /disable {#grupo}

Exemplo: /disable #Defesa


Comando Dlevel

Altera o default user level da sess�o Remote.

Modo de Usar: /dlevel {level}

Exemplo: /dlevel 3


Comando Editbox

Preenche a editbox (caixa de texto onde os comandos s�o digitados) da janela atual com o texto especificado.

Modo de Usar: /editbox {-s} {texto}

Exemplo: /editbox Killer,

Observa��es:
-s    Preeche a caixa de texto da janela de status.
Se nenhum texto for especificado, o que estiver na caixa de texto � apagado.


Comando Enable

Ativa um grupo de Events ou Commands.

Modo de Usar: /enable {#grupo}

Exemplo: /enable #alerta


Comando Events

Liga ou desliga suas op��es de Events (Tools/Remote/Events) ou mostra o seu status.

Modo de Usar: /events {on|off}

Exemplo: /events off


Comando Flash

Faz piscar o �cone do mIRC no desktop (Windows 3.x) ou na barra de tarefas (Windows 95) juntamente com barra de t�tulo do programa, mostrando tamb�m o texto especificado. Este comando s� funciona se a janela do mIRC n�o estiver ativa, ou seja, se estiver minimizada ou se uma janela de outro programa estiver sendo usada. O objetivo do /flash, utilizado em scripts, � alertar o usu�rio sobre um evento qualquer que tenha ocorrido. Os par�metros s�o opcionais.

Modo de Usar: /flash {op��es} {texto}

Exemplos:
/flash -b Mensagem Recebida
/flash -w
/flash Killer entrou no canal!!


Op��es:
-b    Faz soar um beep a cada segundo.
-w    Faz tocar um som (especificado em File/Options/Event Beeps/On Event/Flash) a cada segundo.


Comando Flush

Remove da sua lista de usu�rios (Tools/Remote/Users) todos os nicknames ou endere�os de usu�rios que tenham os n�veis especificados sendo eles n�veis gerais ou especiais. Antes de fazer isso, o programa verifica em todos os canais que voc� estiver se existem usu�rios que correspondam ao endere�o na lista de usu�rios. Caso positivo, o endere�o determinado n�o ser� removido.

Modo de Usar: /flush {n�vel1,n�vel2,...}

Exemplo: /flush 1,2,3


Comando Guser

Adiciona uma pessoa a sua lista de usu�rios atrav�s do seu endere�o. A op��o -a funciona da mesma maneira que no comando /auser.

Modo de Usar: /guser {-a} {n�veis} {nick} {tipo}

Exemplo: /guser 3,5 Killer 3


Comando Halt

Cancela um script e qualquer processo relacionado a ele. Use o /halt para evitar uma resposta a um comando /ctcp ou para cancelar um alias em execu��o.

Modo de Usar: /halt

Exemplos:
ctcp 1:VERSION:/halt    Evita que o mIRC responda ao /ctcp version de qualquer usu�rio.
alias cores {    Alias que mostra as cores numeradas de 1 a 15 na janela de Status.
  unset %cont
  :inicio
  inc %cont
  if (%cont <16) echo %cont s %cont
  else halt
  goto inicio
}



Comandos Inc e Dec

Incrementa ou decrementa uma vari�vel no valor especificado.

Modo de Usar: /inc {-uN} {%var} {valor} e /dec {-uN} {%var} {valor}

Exemplos:
/inc %preco 3
/inc -u5 %temp 1
/dec %preco 2.5


Observa��o: veja os comandos /set e /unset para mais detalhes sobre vari�veis.


Comando Linesep

Insere na janela especificada um separador de linha. � utilizado pelos scripts na exibi��o de informa��es ao usu�rio. Se o separador de linha j� tiver sido inserido na janela (pelo pr�prio mIRC ou pelo script) esse comando o reconhece e n�o insere novamente. O(s) caract�re(s) de separa��o de linha pode(m) ser definido(s) em File/Options/Extras.

Modo de Usar: /linesep {@janela|-s}

Exemplos:
/linesep -s    Na janela de Status.
/linesep @window    Insere separador de linha na janela @window.


Comando Load

Carrega configura��es de um arquivo .ini.

Modo de Usar: /load {op��o} {arquivo.ini}

Exemplos:
/load -a aliases.ini
/load -pn popups.ini
/load -ru users.ini


Op��es (use uma de cada vez):
-a    Carrega defini��es de Aliases.
-p#    Carrega comandos de menus Popups. O # deve ser substitu�do por s, c, q, n ou m, que indicam respectivamente Status, Channel, Query/Chat, Nickname list e Menubar.
-r#    Carrega scripts. As sub-op��es s�o u, v e s, indicando respectivamente lista de usu�rios, vari�veis e os scripts propriamente ditos (eventos, comandos raw e ctcp).

Observa��o: s� pode ser carregada uma sess�o de cada vez. Popups s�o as janelas que listam comandos e podem aparecer no menu ou atrav�s de um clique do mouse.


Comando Raw

Envia comandos Raw diretamente ao servidor. �til para executar comandos ainda n�o implementados no mIRC. A op��o -q executa o comando sem que o usu�rio perceba, j� que nada ser� mostrado como resposta ao comando.

Modo de Usar: /raw {-q} {comando}

Exemplo: /raw help

Observa��o: a maioria dos servidores oferecem uma lista de todos os comandos que podem ser usados atrav�s do /raw. Pode-se conferir essa lista executando o comando exemplo acima.


Comando Remote

Liga ou desliga o Remote (uso de scripts) do mIRC.

Modo de Usar: /remote {on|off}

Exemplo: /remote off


Comando Rlevel

Remove da lista de usu�rios (Tools/Remote/Users) todos os nicknames com determinado n�vel de acesso.

Modo de Usar: /rlevel {nivel}

Exemplo: /rlevel 3


Comando Ruser

Remove uma ou mais pessoas da sua lista de users (Tools/Remote/Users).

Modo de Usar: /ruser {nick|endere�o}

Exemplo:
/ruser Killer
/ruser *!joao@*.provedor.com.br



Comando Save

Salva um arquivo .ini que foi alterado.

Modo de Usar: /save {arquivo.ini}

Exemplo: /save events.ini


Comando Say

Lan�a uma mensagem na janela ativa, como se voc� estivesse enviando uma mensagem normal ao canal. Muito �til para quem utiliza scripts.

Modo de Usar: /say {mensagem}

Exemplo: /say Hi!!!


Comandos Set e Unset

Define ou apaga uma vari�vel. O nome da vari�vel deve ser precedida pelo sinal %. As vari�veis podem armazenar texto ou um valor num�rico. Para apagar v�rias vari�veis em apenas um comando, pode-se usar caract�res curingas (? e *) onde o ? representa um caract�re qualquer e o * representa uma sequ�ncia qualquer de caract�res. Ao definir uma vari�vel, pode-se especificar um tempo (em segundos) para que a vari�vel se apague automaticamente. Existe tamb�m o comando /unsetall que apaga todas as vari�veis definidas.

Modo de Usar: /set {-uN} {%var} {valor|texto} e /unset {%var1} {%var2} ...

Exemplos:
/set %pi 3.141595
/set %texto_a Isto � um exemplo!!
/set %texto_b Isto � outro exemplo!!
/set -u5 %texto_c Outro exemplo!!   
Depois de 5 segundos esta vari�vel � apagada.
/unset %pi %texto_?    Apaga as vari�veis %pi, %texto_a, %texto_b e %texto_c (se esta ainda existir).

Observa��o: veja os comandos /inc e /dec para incrementar e decrementar vari�veis num�ricas.


Comando Timer

Elabora comandos temporizados. O n�mero do timer n�o � necess�rio. Pode-se especificar a hora em que o comando ser� acionado, o n�mero de repeti��es e o intervalo de tempo (em segundos) para cada repeti��o. Executando o comando /timers, pode-se ver uma lista dos timers ativos, mostrando a hora em que se iniciar�o, quantas vezes ainda v�o se repetir e seus intervalos de repeti��o. Para desativar todos os timers, execute /timers off. Para desativar um timer, use /timerN off onde N � o n�mero do timer em quest�o.

Modo de Usar: /timer{n�mero} {-om} {hora} {repeti��es} {segundos} {comando}

Exemplos:
/timer1 5 2 /msg Killer Oi!!!
/timer2 14:30 1 1 /say J� s�o duas horas e meia!!
/timer -om 1 5000 /unset %temp
/timers


Exemplo de resposta ao comando /timers:
* Active timers:
* Timer 1 5 time(s) 2s delay /msg Killer Oi!!!
* Timer 2 14:30 1 time(s) 1s delay /say J� s�o duas horas e meia!!
* Timer 3 1 time(s) 5000ms delay /unset %temp


Observa��es:
Se o n�mero de repeti��es for 0, o comando vai ser repetido infinitamente at� que o usu�rio desligue o timer.
Se o comando /timer for executado sem que voc� esteja conectado ao servidor, o timer ser� considerado offline, ou seja, vai permanecer rodando esteja o mIRC conectado ou n�o.
Caso voc� esteja conectado ao executar o comando, o timer ser� considerado online, e se desligar� automaticamente caso houver uma desconex�o com o servidor.
A op��o -o faz com que o timer seja offline independente da conex�o com o servidor.
Se na execu��o do comando /timer o seu n�mero n�o for informado, o mIRC procura o primeiro n�mero livre para atribuir a esse timer.
Se quiser especificar o intervalo do timer em milissegundos, utilize a op��o -m.


Comando Ulist

Lista os usu�rios da users list que est�o em determinado n�vel.

Modo de Usar: /ulist {n�vel}

Exemplo: /ulist 3


Comando Writeini

Escreve informa��es em um arquivo do padr�o INI. O valor pode deixar de ser especificado. Neste caso o item ter� valor nulo. Os arquivos INI s�o utilizados nesse caso para configura��o de scripts ou armazenamento de informa��es. Segundo o autor do mIRC (Khaled Mardam-Bey), a manipula��o de arquivos INI � mais r�pida que o uso das vari�veis (veja o comando /set) no programa.

Modo de Usar: /writeini {arquivo.ini} {sess�o} {item} {valor}

Exemplos:
/writeini amigos.ini Jo�o Apelido Killer
/writeini amigos.ini Jo�o Idade 10
/writeini amigos.ini Marcos Apelido Trevor
/writeini amigos.ini Marcos Idade 11


Exemplo do arquivo amigos.ini:
[Jo�o]
Apelido=Killer
Idade=10

[Marcos]
Apelido=Trevor
Idade=11


Barra de Divisão