Q3Launch - A mIRC Add-on For Quake3:Arena Players
2000 -=Digit4l=- of -=Digital Oxygen=-
digit4l@planetquake.com
http://planetquake.com/q3launch


-=Disclaimer=-

   This addon is 2000 -=Digit4l=- of -=Digital Oxygen=-.
   I cannot be held resposible for anything this add-on may do in regards
   to the way that you use it. As written by the author, it will in no way
   harm your computer or current mIRC script, and it will not transfer any
   information that it should not. This includes your Quake3:Arena CDKey.
   Although this add-on will, if enabled, detect and report to your screen
   the CDKey for Quake3:Arena, it will not record this information for any
   longer than 2 seconds, and will not send this information anywhere.


-=Install Tips=-

    Version 1.0 Final Recommendations:
   Uninstall any previous installation of this addon via the 'Uninstall' option
   on the GUI, back up your 'q3launch.ini' file if you have entered some of
   your favorite servers, and delete ALL previous script related files, usually
   file beginning with 'q3l*.*'. This includes deleting any icons from the
   previous install, then commence with the new installation.

    Tips? Well, there is no need for many tips in this section, you simply 
   unzip ALL of the files located inside the zip file to whatever directory 
   your mirc.exe resides in, open mIRC, and type 

   /load -rs q3launch.q3l

    The rest is done via the GUI installer. If setup requires more information
   from you than it can currently detect, you will be prompted. Please realize 
   you MUST have Quake3 installed, and a mIRC version of 5.61 or better. Setup 
   will not continue if your mIRC version is below 5.61.
 

-=About This Add-on=-

   Where do I start?
    OK, first of all, this add-on is totally GUI based, and allows for a number
   of options for its users. It can store up to 20 of your fav Quake3 servers, 
   allows you to edit/delete currently stored servers, detects a number of things
   I personally never thought mIRC could do, allows you to use one of 6 mIRC 
   commands to launch Quake3 and connect to a server, and many more nifty little
   things. Once installed, this add-on will automatically present you with the 
   GUI enhanced add-on windows so you can see what it has to offer.


-=Known Bugs/Issues=-

    To date, there are no known bugs with this add-on. Since I know I'm far from
   perfect, I expect there to be bugs. Please report them to me either from the
   website (http://www.planetquake.com/q3launch), or by e-mail. I can be reached
   through e-mail at digit4l@planetquake.com.

    One issue that may be aroused with this add-on is the fact that IT WILL DETECT
   YOUR Q3 CDKEY!! Please rest assured that even though it will (only if enabled) 
   detect your cdkey, it WILL NOT send this information ANYWHERE. You can disable
   this feature easily by clicking a button in the GUI, and as stated, it WILL NOT
   send this info anywhere! Actually, it will record the info for no longer than 2
   seconds, that's right, two seconds. Once the two seconds have expired, it will 
   remove the variables that store the cdkey automatically. I personally would not
   like to have my cdkey distributed anywhere, so I will not subject any other user
   to this either.


-=Planned Additions=-

   More Games!
    Even though Quake3 is at this time my fav FPS, I will hopefully be able in the 
   near future to add support for other games, such as Unreal Tourney, and others, 
   depending on demand.


-=Version History=-

Version 1.0 Final - January 30, 2000
   Lots new! Totally rewritten, using minimal code from previous versions. The setup
  routine is now different, as it will prompt you for your Quake3 installation instead
  of searching for it (cutting down on load time), and GameSpy support has been added, 
  so you will also be propmted for the installation path for GameSpy. I've also added
  a number of new features, they're listed below:

  * Update Check     - use mIRC to query our update server to make sure you have the 
                       latest version
  * Q3 MOD Support   - added ability for users to connect to a server running one
                       of the many Quake3:Arena MODS available
  * GameSpy Support  - Added ability for the script to detect if a user that has 
                       GameSpy has indeed used it to connect to a server, and mark
		       you away in mIRC. This comes with many more options
  * BackUp Option    - Allows you to backup all files used for this script so if you
                       ever have to re-install, you won't lose your settings
  * mIRC AutoAway    - Added ability for a user to be marked away when they use the
                       script to connect to a server, or marks a user away when they
		       launch a server via GameSpy. This can be customized with a
		       user selected away message, which are listed below. All options
		       can be enabled or disabled with the click of a button
  * mIRC NickChange  - Added ability for a users nick on IRC be changed when they are 
                       marked away. Also added edit box for the user to enter their
		       desired nickname
  * mIRC Scan Reply  - This option will determine if a user would like to enable an
                       optional reply for the command listed below
  * mIRC Scan        - This option is for a user to optionally scan the channel they
                       launch the GUI from for other users with this script. If there
		       is/are another users with the script installed that are away
		       playing Quake3, and they have optionally enabled this command,
		       they will reply with the current information on the server
		       they are connected to
  * Game Nick        - Used to allow a user to input their current game nickname, 
                       which will be reported to anyone using the Scan command if
		       the user has enabled the reply
  * Away Message     - Allows a user to input their desired away message, used if they
                       have enabled the AutoAway option
  * Help File        - Added a button to launch the help file, explaining everything
                       for each command to new users.
  * Link Connect     - This option, found on the credits tab, will use shell integration
                       to open Internet Explorer (I know it's IE, but I had to do it this
		       way to cut down on needed detection), and connect to the website
		       associated with it.
 
   I've also fixed the annoying bug that caused you to have to enter your first server
  twice. As of now, some options added may not be enabled, as I am still optimizing the 
  code for faster processing. One more thing, I've kept a written log of all aliases,
  variables, and custom identifiers, for scripters who wish to make additions to the
  existing code, and made the original code a lot easier to understand, with the only
  exception being in the dialog code, that much you'll have to figure out yourself :P
  Everything now uses a set of variables/aliases/identifiers that begin with q3l.*, 
  as this will allow not only easy removal as far as variables go, but also is sure to
  not interfere with any current script configurations.

Version 0.9.7 - January 19, 2000
   Fixed a small annoying little bug that wouldn't allow a user with spaces in the 
  path to the Quake3 directory launch a game. This is due to the fact that upon 
  writing, there were no spaces in my own path so it never crossed my mind. This was
  written in WindowsNT, so if 9x users still have a problem, please report it to me 
  using the Bug Report form on the website. Propz to Thelrax for finding this. Make
  sure to drop by his awesome LP server, quake3.wt.net.

Version 0.9.6 - January 16, 2000
   First user submitted bug found by Pappy-R from PlanetQuake, and a fix was released
  immediately. It seems that mIRC 5.6 had some issues with the dialog boxes that were
  fixed in 5.61, and seeing as this script was written in 5.61, went undetected by me 
  and my testers. The only fix at the present time for this is to limit the install to
  users running the latest mIRC (5.61), so if you wish to run this script, be sure you
  are running mIRC 5.61 or better. If you have mIRC 5.5+, you can simply download and 
  install mIRC 5.61, copy the mirc32.exe, and overwrite your current mirc32.exe with it
  or you can download the mIRC 5.61 executable and overwrite your current mIRC32.exe 
  with it. Download the mIRC 5.61 executable only at http://www.planetquake.com/q3launch.
  Keep in mind that replacing the mIRC executable will not hurt your current installation
  or script, it only allows for this script to use the pre-compiled options available.

Version 0.9.5 - January 16, 2000
   First public release. Please submit any bugs found to me at digit4l@planetquake.com.

Version 0.8.4 - January 13, 2000
   First release submitted for beta testing. All bugs found were fixed.

Pre 0.8.4
   All versions prior to 0.8.4 were not released, and were used to finalize the way
  I wanted this add-on to be.


-=Other Information=-

-=Script Archive=-

    If there happen to be any other mIRC scripters, or people that make scripts for one
   of the other various IRC clients, and are interested in developing other game-related
   scripts/addons for their respective clients, please contact me. I'm interested in not
   only writing my own add-ons, but also creating the largest archive of game-related IRC
   scripts you can find, all available at one place. More information may be available
   if you are interested by contacting me, digit4l@planetquake.com.

-=About Me=-
    To start, there's not much to tell. I'm an avid gamer, only new to the pc gaming scene,
   and this is one of the ways I have chosen to contribute to the community. I started dabbing
   in mIRC scripting one month  after I first learned HOW to visit a website back in September
   '97 (I really was a newbie :P). Now I can proudly say I can script in mIRC, TCL, and Perl,
   among others. I can also do web design, and have dabbed in various programming languages 
   (to learn the basics needed to edit programs to do/say what I wanted). In just over 2 years,
   I have accomplished more than I could have ever imagined, and have more in store.
   
   You can find me on DALnet in #digitaloxygen, or e-mail me at digit4l@planetquake.com. 
   My Quake3 nick is -=Digit4l=- in case you want to drop me comment while I frag you :P (or
   rather, drop me a message so I CAN frag you, I'm not very good at Q3, hehe).

   I hope people enjoy this add-on as much as I enjoyed making it :)

-=Digit4l=- - Alive and kickin' in 2K!


EOF
Last Updated: Sunday, January 30, 2000 @ 2:42 AM AST