#Script.Help
of mIRC
Information
Basics of making "Scripts"
<-- Back to #Script.Help
Home page
Step 1 : Starting a new "Script".
You want to build a "Script", ok let's start.
First, go into your mIRC directory. Copy this files:
aliases.ini,
mirc.ini,
script.ini,
popup.ini,
servers.ini,
readme.txt,
version.txt,
mirc32.exe (or mirc16.exe),
ircintro.hlp
and mirc.hlp
Paste all this file in a new folder: My-Script (or something else, just find a name).
Now, change the name (if you want too) of mirc32.exe for: my-script.exe (or the name you have choice for your folder).
Now, you have a almost new mIRC.
<-- Back to Basics of making
"Scripts"
or Continue
--> ?
Step 2 : The popup.ini file
You're ready to continue?
First, maximize your browser window!
Then, go in the popup.ini (in the new folder) (in notepad or something like that):
You now see many strange characters. Let's go through it!
When you see something like: ["a letter"popup] it means you are in a specific part of the popup. Let' look at them:
|
means the channel window popup. |
|
|
means the status bar "Commands" menu. |
|
|
means the query user window popup. |
|
|
means the list of nickname's, of the channel window, popup (must be at the right of the window) |
|
|
means the Status window popup |
They all have particularities because of their place in mIRC.
Now, A VERY IMPORTANT PART! The explanation of the characters and keywords you will use (in the popup.ini and script.ini):
|
$chan |
the channel you are presently using or talking about |
|
# (in certain popup only) |
the channel you are presently using or talking about |
|
$nick |
your nickname or the one you have clicked on or that had do something |
|
$$1 or $1 (it depend on the type of the command) |
the nickname you are talking about |
|
$2, $3, $... |
to select more than one nickname at a time |
|
$$?="(A query):" |
to popup a "popup question" |
|
n0= (n1=, n2=, ...) |
the line in the popup menu, starting at n0=, and continue by adding 1 |
Don't forget that:
EVERY TIME YOU ADD SOMETHING TO YOUR POPUP.INI YOU WILL HAVE TO CLOSE mIRC AND RESTART IT!
Step 2.1: The [cpopup]
Now, Let's start adding commands.
Starting with [cpopup] (channel window popup).
Under [cpopup]: you see:
n0=Channel Modes:/channel
|
n0= |
Channel Modes |
: |
/channel |
|
the line |
the name you will see in the popup menu |
end of the name, start of the command |
the command |
Do you understand?
Let's add something that might help you. If you want to see the info of a channel, you will have to type:
/msg ChanServ info #(channel name) e.g.: /msg ChanServ info #Script.Help
To make it a command in the [cpopup] you have to type:
n1=Info: /msg ChanServ info $chan
|
n1= |
Info |
: |
/msg ChanServ info |
$chan |
|
the line |
the name you will see in the popup menu |
end of the name, start of the command |
the start of the command |
the command: the channel you are presently in |
You want to try it? Ok, but don't forget:
EVERY TIME YOU ADD SOMETHING TO YOUR POPUP.INI YOU WILL HAVE TO CLOSE mIRC AND RESTART IT!
Let's do a command with a "question popup" in it.
You want to register a channel. You will normally have to type:
/msg ChanServ register #(channel name) (a password) (the description).
To make it a command of the [cpopup] you have to type:
n2=Register:/msg ChanServ register $chan $$?="Enter a channel password:" $$?="Enter a channel description:"
|
n2= |
Register |
: |
/msg ChanServ register $chan $$?="Enter a channel password:" $$?="Enter a channel description:" |
|
the line |
the name you will see in the popup menu |
end of the name, start of the command |
the command |
You may need more explanation for that command:
/msg ChanServ register $chan $$?="Enter a channel password:" $$?="Enter a channel description:"
|
/msg ChanServ register |
$chan |
$$?="Enter a channel password:" |
$$?="Enter a channel description:" |
|
the start of the command |
the channel you are presently in |
a "question popup" that will ask For the channel password: (the question will be: Enter a channel password:) |
a "question popup" that will ask For the channel description |
That's all for the [cpopup], if you want to know more about it; come to #Script-help.
Step 2.2 : The [bpopup]
Now, The [bpopup] (status bar "Commands"menu)
It start with:
n0= Commands
This means the menu Title is: Commands. If you want, you could change it by: "My-Script" (or something like that).
You cannot use $chan or # here! You have to use #$$?="Enter channel name:"
An example?
To register a channel: we have use (in the [cpopup]) :
n2=Register:/msg ChanServ register $chan $$?="Enter a channel password:" $$?="Enter a channel description:"
But, here you will have to use:
n2=Register:/msg ChanServ register #$$?="Enter channel to register:" $$?="Enter the channel password:" $$?="Enter channel description:"
Why? Because when you use the Commands menu, you are not in any window You just use your nickname.
So, you couldn't use $nick or $$1 (...). You have to use: $$?="Enter nickname:".
Another example?
To ignore an user: you should type the command : /ignore (nickname)
But you'll have to type:
n3=Ignore user:/ignore $$?="Enter nickname:"
|
n3= |
Ignore user |
: |
/ignore |
$$?="Enter nickname:" |
|
the line |
the name you will see in the popup menu |
end of the name, start of the command |
the command |
the command: a "question popup" that will ask For the nickname (to ignore) |
That's all for the [bpopup], if you want to know more about it, go to #Script-help.
Step 2.3 : The [qpopup]
The [qpopup] (the query user window popup) is used in the query window, (the window that appear on /query (nickname) or on clicking on a nickname in the list of nicknames ([lpopup]) (must be on the right part of the channel window).
In this section you will only use the $$1 (not the $2, ...)
An example?
This is the first of your list:
n0=UCentral:/uwho $$1
|
n0= |
UCentral |
: |
/uwho |
$$1 |
|
the line |
the name you will see in the popup menu |
end of the name, start of the command |
the command |
the command: the nickname of the user you are with |
That's all for the [qpopup], I know, this is short, but it is all I can say here.
If you want to know more about it; come to #Script-help.
Step 2.4: The [lpopup]
The [lpopup] (the list of nickname's, of the channel window, popup) (must be at the right of the channel window)
Here You will use $$1 $2, $3, ... (nickname) and # (channel)
An example?
To op 3 people, you have to type:
/mode #(channel name) +ooo (nickname 1) (nickname 2) (nickname 3)
In this part of the popup.ini you will have to use:
n8=Op:/mode # +ooo $$1 $2 $3
|
n8= |
Op |
: |
/mode # +ooo $$1 $2 $3 |
|
the line |
the name you will see in the popup menu |
end of the name, start of the command |
the command |
Let see that command:
/mode # +ooo $$1 $2 $3
|
/mode |
# |
+ooo |
$$1 $2 $3 |
|
the start of the command |
the channel you are presently in |
op 3 nicknames |
the nicknames you have choice in the list |
You understand?
Let's add one!
To add a AOP, you must type:
/msg ChanServ SOP #(channel name) ADD (nickname)
But, to make it a command of the [lpopup] you will have to add
n22=Add an AOP:/msg ChanServ SOP # ADD $$1
OK?
That's all for the [lpopup], if you want to know more about it; come to #Script-help.
Step 2.5: The [mpopup]
Now, the last section of the popup.ini file, the [mpopup] (the Status window popup).
In here you can use the $$1, $2, $3, ... (nickname) # or $chan (channel) because you are not in a channel or a query window. You will have to use the: $$?="(A question):".
Let's add something. You want to Identify your nickname, you must type:
/msg NickServ IDENTIFY (password)
But here, you'll have to use:
n5=Identify Nickname:/msg NickServ IDENTIFY $$?="Enter your password:"
|
n5= |
Identify Nickname |
: |
/msg NickServ IDENTIFY $$?="Enter your password:" |
|
the line |
the name you will see in the popup menu |
end of the name, start of the command |
the command |
What does that command mean?
|
/msg NickServ IDENTIFY |
$$?="Enter your password:" |
|
the start of the command |
a "question popup" that will ask For the password (for the nickname) |
You understand?
Let's add a last one. You want to have the list of the channel of mIRC, you must type:
/list
But to make it a command of the [mpopup] you will have to type:
n8=List Channels:/list
|
n8= |
List Channels |
: |
/list |
|
the line |
the name you will see in the popup menu |
end of the name, start of the command |
the command |
That's all for the [mpopup], if you want to know more about it; come to #Script-help.
Step 2.6: Some additional things
To see what [(a letter)popup] mean, click here.
To see what is the meaning of a character or a key word click here.
To group some command that are in the same categories ( the thing in () are example):
Type the line (n0=) + the name of the categories
Type on another line, the line (n1=) , a dot (.) and the thing you want to add (The name: The command)
Continue this for all the others thing you want to add.
To make a categorie in another:
Type the line (n5=), a dot (.) the name of the categories
And to add something in that categories type: the line (n6=) , 2 dot (..) and the thing you want to add (The name: The command)
You could create any number of categories and any number of sub-categories.
An example?
n49=Channel n50=.SOP n51=..Add:/msg ChanServ SOP #$$?="Enter the channel name:" ADD $$?="Enter nickname to add to the SOP list:" n52=..Delete:/msg ChanServ SOP #$$?="Enter the channel name:" DEL $$?="Enter nickname to remove from SOP list:" n53=..List:/msg ChanServ SOP #$$?="Enter the channel name:" list n54=.AOP n55=..Add:/msg ChanServ AOP #$$?="Enter the channel name:" ADD $$?="Enter nickname to add to the AOP list:" n56=..Delete:/msg ChanServ AOP #$$?="Enter the channel name:" DEL $$?="Enter nickname to remove from the AOP list:" n57=..List:/msg ChanServ AOP #$$?="Enter the channel name:" list
That's all for the popup.ini file, if you want to know more about it; come to #Script-help.
Step 3: The script.ini file
First, delete all what you have in this file that you don't want in your "Script".
Then, save the file as script2.ini.
And the last thing, go your Script's mIRC and go to the remote sections. Go to the File menu, chose Load and chose Script. Now, go to the good directory and chose script2.ini.
That will prevent your remotes to be delete.
If you haven't read it recently, read now: the meaning of a character or a key word.
Now, we will add two things: a ping notice + ping counter
Return to your script2.ini (in notepad or something like that). And type:
n1=ctcp ON *:PING:/inc %pingcounter | /.notice $nick Thank you for pinging !!! (You are pingner number %pingcounter)
What is all this?:
|
n1= |
the line |
|
ctcp |
means that it's a ctcp command |
|
ON |
means that it will work when someone will... |
|
*: |
any level of user |
|
PING: |
means, when someone ping you |
|
/inc %pingcounter |
means that it will add 1 to your %pingcounter |
|
| |
means that you what to do another thing for the same ON... |
|
/.notice $nick |
will notice the nickname (who send you a ping) |
|
Thank you for pinging !!! (You are pingner number %pingcounter ) |
your reply message (you can change it if you want but let the end there) |
|
%pingcounter |
will show a number, (the number off person that ping you) |
That's all for the script.ini file (now script2.ini), if you want to know more about it; come to an help channel about the remotes section.
Step 4: The mirc.ini file
Here you don't use the character or keyword we have seen.
The only thing we will modify is the background.
First, make a background in Paint (or a program like it) and save it in a new folder you will name: background (put it in your "Scripts" folder).
After, make a [background] section into the mirc.ini file. Do it as follows:
[background]
@mdi=background\(the file name).bmp,2
(the file name) = the name of the file you did for background
That's all for the mirc.ini file, if you want to know more about it; come to an help channel about the mirc section.
Step 5: The aliases.ini file
Now, the last .ini file we will modify.
The aliases.ini file is a file to make complicated commands (or long ones) more simple.
For example, the first line:
n0=/op /mode # +ooo $$1 $2 $3
|
n0= |
/op |
/mode # +ooo $$1 $2 $3 |
|
the line |
the aliase (shorter command) |
the real command |
Let's add one, you want to make the /clear command to be /cls, just type this into the aliases.ini:
n10=/cls /clear
|
n10= |
/cls |
/clear |
|
the line |
the aliase |
the real command |
Now, when you want to /clear you simply have to type: /cls
That's all for the aliases.ini file, if you want to know more about it; come to an help channel about the aliases section or come to #Script.Help.
<-- Back to Basics of making
"Scripts"
or Continue -->
?
Step 6: Some things for your "Script"
First, you should download other scripts to look how they were made. You could download many at: http://www.mircx.com and you could download some on clicking on "Download some "Scripts"" of the #Script.Help Home page.
You should also look for a Script help channel such as:
#Script.Help
and
#Helpdesk
THE MOST IMPORTANT THING IS TO HAVE FUN!!!
* Made by Net5 *