| Frequently Asked Questions about mIRC. |
|
|
This is FAQ version 52, revision 2 Latest FAQ Update: August 16th, 2002 It is maybe a good idea to download this mIRC FAQ and read it off-line? This FAQ attempts to answer the most frequently asked questions about the Winsock IRC client mIRC, developed by Khaled Mardam-Bey. This FAQ will only answer simple questions on IRC itself since lots of info is already available on that. (Eventually read the IRC Intro included in mIRC). Not all functions and features of mIRC are explained in the FAQ; it merely serves as a good starting point. With the FAQ I hope to help you to get all possible basic problems solved, and to give you lots of good ideas about mIRC's scripting capabilities. I'm not the author of mIRC but I've spent quite some time beta testing it. I love mIRC for its small size, speed and useful tools... in particular, the popup menus and the scripting section are really great! Thanks Khaled, for an excellent proggie ! This FAQ as well as mIRC is still a work in progress! Most subjects in this file were prompted by questions in the Usenet newsgroups alt.irc.mirc and alt.irc.questions. Recently some mIRC dedicated message boards have been added to the mIRC website who offer more support and contribute to the FAQ in a great way! Please continue to post your questions there (and answers as well), as those places are my learning place as well. ;-) This FAQ might not be totally complete yet, but to the best of my abilities I try to be correct. Do not hesitate to provide additional information or corrections for the FAQ. The first part (Sections 1 - 6) of this file is the actual FAQ. The last part (Sections 7 + 8) consists of a tutorial or reference manual for mIRC’s "programming" features. If you want to learn the 'what and how' of creating Aliases, Popups and Remote Commands and Events in mIRC, check out the last part of this file. I can highly recommend these sections to you all! Thanks to all the people who voluntarily contributed to this FAQ. In particular Mookies, Bryan and Li0nheart for making additional parts and html-ing. Shorty, Keyman and Qasimtoep, thanks for fixing a lot of spelling and grammar bugs! Thanks to Junyor for his contributions from the alt.irc.mirc FAQ.
You can e-mail me with FAQ related remarks at: tjerk@mirc.com If you have further questions about mIRC, please visit the IRC channel #mIRC on EFnet, IRCnet, Undernet or Dalnet. BUT, if you ask a question that is really well handled by this or other FAQ's, then please accept that you be pointed back to this or other help files.
The latest info on mIRC will always be found on the mIRC Home and FAQ www pages or one of the mirror sites in:
Copyrights - You are allowed to provide and distribute the mIRC FAQ -as is- by or on any medium as long as you make it available for free. You are not allowed to change anything in the file or charge any amount of money for your services. If you want to copy only certain parts for whatever use, make sure to mention my name and the FAQ as the source of information with every single quote whenever you publish it. © copyright 1995-2002 Tjerk Vonck tjerk@mirc.com Table of Contents
1 What is mIRC?
mIRC is a shareware IRC Chat client for Windows. It is developed and copyrighted by Khaled Mardam-Bey. For those of you new to the Internet, IRC stands for Internet Relay Chat. The IRC network is a virtual meeting place where people from all over the world can meet and talk (well, type). On IRC you meet others on "channels" (rooms, virtual places, usually with a certain topic of conversation) to talk in groups, or privately. There is no restriction to the number of people that can participate in a given discussion, or the number of channels that can be formed on IRC. As a user you run a "client" program like mIRC which connects to a "server" in an IRC network. All servers are interconnected and pass messages from user to user over the IRC network. One server can be connected to several other servers and up to hundreds of clients. If you need more information on IRC go to mIRC's www Homepages where a lot of additional information is given.
The various parts of the program have been designed with the aim of simplifying and speeding up your IRC sessions. mIRC is made to be very configurable... there are a lot of simple switches you can use to personalize mIRC to your needs. And unlike a lot of other IRC programs mIRC still gets more and more mature every new version. You can define your own commands and implement your personal reactions to commands others give to your client. All this does not make mIRC a bot program, and it doesn’t even support IRCii scripting and possibly a large number of other things... But it has much of the same functionality, thanks to the Remote Commands and Events and various other features... and what do you need a war script for, anyway? I think mIRC will help you to focus on the main point; IRC is for Chatting ....
2 Latest News on mIRC... (What is new in version 6.03) With this new release we hope to address most, if not all, of the comments, requests and remarks we recieved over the past weeks. We tried to focus on fixing the few but annoying buggies found in the previous version, but of course added quite a few new features and functions. The 'perform on connect' sorting mistake has been fixed, also the numeric 330 bug, the flickering menubar and toolbar, the ! on INPUT processing bug, the $read and a similar freeze bug with invalid filenames, a switchbar multi-line display bug, dcc ignore bug, a /timer bug, and a bug in the highlight feature are fixed. The $ticks has changed back to the old method because of a bug in Windows' high performance timer... *mumble* Other fixes are the /load command that could trigger multiple on load events, a proxy authentication bug, the $asctime() bug, a small dcc server ignore bug, and an important memory bug in script parser, where mIRC checks if a script has been loaded/unloaded while a script is running. mIRC now supports several IRCX events on any server that sends them, not just for IRCX servers, it will (again) try to rejoin a channel even if it was +i or +k, we improved the way mIRC determines what default web browser you use, rewrote the mark/copy routine, and added a $nick().idle property that returns the idle time for a person on a channel. You can also use this idle time feature in the nick color list dialog in the addressbook! Since this version has far too many improvements, new features and functions to mention here in detail you'll have to dig through the help file and the whatsnew.txt on the Web to learn about the complete list of changes and their impact. Information on changes in older versions is available in the versions.txt. If you have additional questions, may we invite you to the Message Boards on this website? The boards offer great help with everything related to mIRC! What was new in version 6.02? (June 6th, 2002). With this new release we hope to address most, if not all, of the comments, requests and remarks we recieved after the release of version 6.01. Several changes are initiated by the multi-server features introduced in mIRC 6.0. You might want to check out how the 'perform on connect section' has been moved to the connect section, near the server settings, and allows you to specify a different set of commands for different networks, and how basic features as the /aop /avoice /protect and /ignore commands now allow you to specify a network name. The multi-line switchbar options in the display dialog have been extended, mIRC no longer closes a channel window on reconnect to a server if you have keep channels open enabled, no longer attempts to rejoin a channel on reconnect if the channel was invite only or if it was locked and mIRC didn't have the key. Changes scripters will like include the $ticks which does no longer wrap around every 49.7 days, custom dialogs that no longer require an ok or cancel button, and new events like on CONNECTFAIL that triggers when a connection attempt including its retries has failed. Fancy new things have been added like the Alt+F1 key combination that hides all windows associated to a status window switchbar button 'in' that button. Try it and you'll see what I mean! Several more or less annoying bugs have been fixed;
What was new in version 6.01? (February 10th, 2002). mIRC 6.01 addresses most, if not all, of the comments, requests and remarks we recieved after the release of version 6.0. We'd like to emphasize the new visual style dialog that allows you to set and change frame styles (borders, lines and bevels), switchbar buttons, and a new option to disable support for irc:// chat links. Several more or less annoying bugs have been fixed; a socket bug which that very likely caused the crashes some of you have been reporting, a connection retry bug which may have resulted in wrong nicknames, channel prefixes and nick mode prefixes, etc. Other fixes are;
May I remind you how in version 6.0 multi-server support was added? With this feature mIRC allows you to connect to multiple servers at the same time. You'll notice the 'Multi-Server' button that provides a couple of new options supporting this new feature. If you hadn't upgraded yet to version 6.0, this is the moment to get 6.01! What was new in version 6.0? (February 3rd, 2002). You'll notice lots of little and larger changes to smoothen your IRC experience. Lots of 16bit-specific code has been removed from mIRC's routines. 16 bit related memory issues, kludges and bugs are solved. The new multi-server feature required major internal changes to mIRC's code and forced improvement of code in many areas which has undoubtfully resulted in an even more stable mIRC! Working on this important new feature we focussed on keeping mIRC as it always has been; no-nonsense, robust, -working- :-) We tried to keep the changes to the scripting language etc, as clean as possible. Upgrading should be fairly painless. We really recommend you to download and try mIRC v6.0!
Changes, improvements and new features:
The new multi-server feature required major internal changes to mIRC's code and forced improvement of code in many areas which has undoubtfully resulted in an even more stable and robust mIRC! Working on this important new feature we focussed on keeping mIRC as it always has been; no-nonsense, robust, -working- :) We tried to keep the changes to the scripting language etc, as clean as possible. Upgrading should be fairly painless. You know by now that you have to dig through the help file and whatsnew.txt to get hold of the complete list of changes and their impac t? Don't forget that ;-) Information on changes in older versions is available in the versions.txt btw. If you have questions, may we invite you to the Message Boards on this website? This discussion platform offers great help with everything related to mIRC! What was new in version 5.91? (June 15th, 2001). As usual the new MIRC offers heaps of changes and improvements. Lots of little and larger changes to smoothen your IRC experience. Although this version is merely a bugfix version, several functions and features have been added or improved. Among the bugs you might have noticed is one that messed up the merging of popup menu's. In this new mIRC complete menu's from different scripts will merge properly. Also fixed are bugs in $eval(), $var() and small thingies in the 16 bit mIRC. A problem with the /whois on query option not working in single message window is solved. Overall there aren't many things you'll notice but all together enough to make your upgrade worth the trouble. Scripters should note that $null has been completely removed as a value. This has some potential to break your scripts. When you use $null in a script, mIRC now converts it to an empty value, instead of the value "$null"!
What was new in version 5.9? (April 26th, 2001).
All you mIRC scripters will love this version for its load of new features. You know by now that you have to dig through the help file and versions.txt to get hold of the best among them? Don't forget that ;-) You should note that several Strings and Identifiers have been changed! Most of them have more options or parameters or are changed to fit better to the standard.. No worries; most old formats are still supported but you -should- update your scripts to prevent problems in the future! We think most of you will be happy with the simple things like $input(), $read() instead of $read, and $style() for popups. Also $eval() is nice, and please note the parser change for [brackets]'s!
What was new in version 5.82? (December 14th, 2000).
What was new in version 5.81? (November 9th, 2000). This version has far too many improvements, new features and functions to mention here in detail. I'll point to some of the simple ones here - the ones you might encounter right away;
Buggies fixed:
Scripters: What was new in version 5.8? (September 5th, 2000).
Buggies fixed:
Improvements and new features:
Scripters will love this version for its load of new features. You might like to know mIRC can now be run as a service under 95/98, you can change the rgb value of a color, use identifiers to mime or uu-encode/-decode text, use the improved support for DLL's, use hash tables.... I'm sure you will have a lot of fun! Apart from these thingies over hundred other features, variables and identifiers have been added. Have fun exploring them! What was new in version 5.71? (May 7th, 2000).
mIRC's new version 5.71 fixes most, if not all, of the small but nevertheless annoying
buggies found in the previous version 5.7. mIRC's new version 5.71 has far too many
improvements and new features and functions to mention here in detail. I'll point to
some of the simple ones here - these are the ones you might encounter right away;
Scripters can now have unlimited controls per tab section in a custom dialog and the custom dialog tab control now automatically adds a scrollbar if the tabs don't fit the width of the tab control. mIRC now maintains an internal banlist for each channel and several related strings have been added. Check out the $banlist for instance! Apart from these lots of other variables and identifiers have been added. Have fun exploring them! What was new in version 5.7? (February 2nd, 2000).
3 What do I need to run mIRC? Where do I get it? How to register? Requirements - Besides running MS-Windows you need to have an Internet account and a properly installed Winsock. If you can use FTP, E-mail, News or other Internet programs from within Windows already, you can safely assume you have both. If you do not have your Internet access properly configured on your PC you should deal with that first. Distribution - mIRC is spread over the world by advanced distribution schemes of primary and mirror FTP sites, which makes it available from hundreds of places all over the world. The most up-to-date list of places where you can get mIRC is the download page on the mIRC Homepages... You could also join the IRC channel #mIRC to get the latest version or to ask all remaining questions... (But: be very sure this FAQ doesn't answer your question) Registration - mIRC is a shareware program. This system of distributing programs, as shareware, shows the true spirit of the Internet. You can download mIRC for free and give it a try. If during or after the 30 days evalution period you decide to continue to use mIRC, you're asked to pay a small registration fee of $20. This will allow Khaled, mIRC's author, to go on developing and supporting mIRC with the same spirit and enthousiasm as he has shown in the past 6 years. Your registration of mIRC will support the future of mIRC's www pages for help, hints and support and encourage the development of mIRC, its help files and the FAQ. :-) Once you registered one version of mIRC, you're allowed to use all future versions for free! The mIRC help file and the registration page give you all information needed to register mIRC. You will see mIRC can be registered online with a credit card. If you feel uncomfortable about using your credit card online, mIRC can also be registered by faxing your credit card information. If you don't have a credit card, you can also send a cheque or money order by postal mail.
4 Short Introduction to IRC. (Read more in the IRC Intro file included in mIRC (!) and available on the mIRC www pages) What is IRC - IRC stands for "Internet Relay Chat". It was originally written by Jarkko Oikarinen in 1988. Since starting in Finland, it has been used in over 60 countries around the world. IRC is a multi-user chat system, where people meet on "channels" to talk in groups, or privately. There is no restriction to the number of people that can participate in a given discussion, or the number of channels that can be formed on IRC. All servers are interconnected and pass messages from user to user over the IRC network. One server can be connected to several other servers and up to hundreds of clients. Several larger and smaller IRC networks exist. On IRC several people can join the same channel and see each other. Depending on its topic and time of the day a channel can be VERY crowded. Channels can also be quite chaotic, or calm. Channels can be open to everyone but also closed and private and only open to friends. On the large IRC networks (EFnet) as many as 20000 channels can exist, on smaller networks there will be fewer channels. Channels on IRC are dynamic in the sense that anyone can create a new channel, and a channel disappears when the last person on it leaves. Language - The most widely understood and spoken language on IRC is English. However, as IRC is used in many different countries, English is by no means the only language. If you want to speak some language other than English, (for example with your friends), go to a separate channel and set the topic to indicate that. Similarly, you should check the topic when you join a channel to see if there are any restrictions about language. On a non-restricted channel, please speak a language everybody can understand. If you want to do otherwise, change channels and set the topic accordingly. Greeting - It is not necessary to greet everybody on a channel personally. Usually one "Hello!" or equivalent is enough. Also, don't expect anybody to greet you back. On a channel with 20 people that would mean one screenful of hellos. It makes sense not to greet everyone, in order not to be rude to the rest of the channel. If you must say hello to somebody you know, do it with a private message. The same applies to good-byes. Also note that using your client's facilities to automatically say hello or good-bye to people is extremely poor etiquette. Nobody wants to receive autogreets. They are not only obviously automatic, but while you may think you are being polite, you are actually conveying yourself as insincere. If some body wants to be autogreeted when they join a channel, they will autogreet themselves.
Behaviour - Remember, people on IRC form their opinions about you only by your actions, writings and comments, so think before you type. If you use offensive words, you'll be frowned upon. Do not "dump" (send large amounts of unwanted information) to a channel or user. This is likely to get you kicked off the channel or killed from IRC. Dumping causes network "burps", causing connections to go down because servers cannot handle the large amount of traffic. Other prohibited actions include: How to join IRC - The first time you run mIRC you have to fill in some information about yourself (your real name, email address, nickname, IP address and Local Host name) under File/Setup/IRC_Servers and Local_Info, as well as the IRC server with which you want to connect. It's usually best to connect to a geographically close server. When you're new to IRC just pick a server from the prefab list. On IRC you are known to others by a nickname. You are free to choose any nickname you like, up to 9 characters long. Do not use spaces and avoid unusual ASCII characters in your nickname. It is possible you find people that use the same nickname and you may be asked to switch nicknames to avoid confusion. Getting started - To join conversations, send private messages, and to handle and control mIRC you need to learn some simple commands. All commands start with a forward slash, the "/". Anything that does not begin with "/" is assumed to be a message to someone and will be sent to your current channel, or to the person you are chatting with in a private chat (see below). A list with the most used commands on IRC is given in the mIRC help file. Finding your way on IRC - To join a channel, type /join #channelname. Try "/join #irchelp" or "/join #mirc" to give it a try... That's it! Once you get to the channel, you will see people talking. It will probably look like this:
{Jake} I dont agree there :-( {East-r} Can sb give me that too ?? I couldnt find it before * East-r smiles {Pat} Nope, I just have a simple question... I think... In the channel window that opens once you join a channel you'll see an alphabetical list of people that are on the channel on the right side of the window. Some of them have a @ in front of their name to indicate they are the channel operators. A Channel Operator is someone who has control over a specific channel. A Channel Operator can also decide if control is shared or not. The first person to join the channel automatically receives Channel Operator status. Channel operators are the 'rulers' of a particular channel. This means they can kick you out of their channel for any reason. If you don't like this, you complain to them or start your own channel and become a channel operator there yourself. Read the help - As soon as you joined your first channels and spent some time on IRC you will see there are a lot more commands and possibilities for you to discover on IRC. You might want to read the full version of this IRC Intro on the mIRC www pages. Almost all specific capabilities of mIRC are explained in the help file that came with the package. You just have to do the reading. :-) Books about IRC and mIRC. - There are several good books available that give a fairly complete introduction to IRC. Mind you; the IRC Intro included in mIRC tells you about the same for free, ...and this FAQ tells a lot more on mIRC! Please read our special books section for more information.
5 Some short Notes and Tips on mIRC. 1. Protect yourself from viral infections on IRC by never ever accepting files from strangers, and by never ever opening executables, scripts or other files that could contain macro's. And use a good virus scanner for every file people sent to you! 2. The Channels List dialog has improved a lot. Full Channel Name and Topic search is supported in an easily understood dialog and you can now make mIRC filter away all unwanted channels by simply setting search and suppress keys. Parents can easily filter away offensive channel list items and password protect their filtering ! But if you need better kid-safety dont rely on mIRC and check out Kidlink IRC, Netnanny or Cyberpatrol.
3. The /uwho
4. The help menu has been made dynamic to display all .hlp files in mIRC's directory, as well as the text files like the readme.txt, versions.txt, and update.txt files, for quick access. Also internal aliases are added that match the help filenames, so if you have the file "ircintro.hlp" in mIRC's directory you can type /ircintro
5. You can protect yourself against people who are flooding you with the new automatic anti-flood system. Look under File/Options/Flood/. A server usually disconnects you for sending too much data to it in a certain period of time, *or* if you try to send it data when it hasn't finished processing your previous data. The new flood protect makes sure -others- cant make you to send tooo much data to the server. Usually a server has a buffer of about 512 bytes. mIRC therefore counts the number of bytes you've sent to a server and if this exceeds a certain number, mIRC waits for the server to be ready again, before it continues sending data. In the mean time it nicely buffers unsend lines. This should protect you properly from all sorts of ctcp floods and so on... You set the amount of bytes mIRC may safely send (for instance 450 bytes), the amount of lines it may buffer (like 20), the amount of lines it may store maximal per user (like 3) and how long the flooder should be ignored (like 15 secs) by the command /flood 450 20 3 15 This flood control method *only* works for messages being triggered by other users. So you can still flood *yourself* off the server. (like with the /list command)
|