Q3Post 1.20

Description:

Q3Post is an mIRC script for Quake 3 Arena players that lets you:

• Automatically post in mIRC a server's IP address and description, whenever you connect to a Quake 3 Arena server, while you play.

• Quickly get the stats from, or connect to, Quake 3 Arena servers in a customizable favorites list, all from mIRC.

• Automatically respond to questions in IRC while you are playing that contain your nickname, or other keywords you can set. The response will let the person know what server you last connected to. These responses turn on when you connect to a new server, and off when you say something in mIRC, or you can control them through Q3Post's menu.

• Choose which IRC channels it will post messages in, and which types of messages will be posted.

Installation:

WARNING: Do the steps in order or Q3Post probably won't work. =)

Upgrading Q3Post: follow these steps, but do the extra step "1b"

1. Make sure you have the Quake 3 Arena point release (v1.15c) and mIRC v5.61. You can check which version of Quake 3 by running it and pressing the ` key (the version will be on the right hand side of the console that comes down) The get the version number for mIRC go to the "Help" menu and select "About..."

   1b. (only if you are upgrading Q3Post) Open mIRC and either select the Q3Post menu item "Quit Q3Post" (if you had version 1.13) or enter "/unload -rs q3post.mrc" in the input line (without the quotes) and then close mIRC.

2. Quit mIRC if it is running..

3. Put the new q3pmenu.txt and q3post.mrc files in your mIRC directory (C:\mirc is common), replacing any old versions.

4. Start up mIRC and enter this command in the mIRC input line: "/load -rs q3post.mrc" (without the quotes) and select "Yes" if mIRC prompts you with a confirmation dialog box. Now Q3Post will load automatically every time you run mIRC.

5. (You only need to do this if your copy of Quake 3 is not in C:\Program Files\Quake III Arena\) Use Q3Post's popup menu (right click in an mIRC chat window and select "Q3Post" to see the options) to set your Quake 3 directory.

6. Check to see if mIRC is set up so that it can launch Quake 3 (and notepad if you want to edit the keyword file). Go to the mIRC options menu (ALT-o) and select "General" and then "Lock" and make sure that "Disable commands:" "/run" is NOT checked.

7. Open your Quake III Arena\baseq3 directory. If you don't have an autoexec.cfg in this directory then just use the one I have included. Otherwise, open the autoexec.cfg included with Q3Post and copy the whole thing and paste it at the end of your autoexec.cfg. The new setting is fully automatic, and updates Q3Post's info whenever you connect to a new server. (you should replace any old autoexec.cfg settings with the new ones)

8. Join a channel in mIRC where you want to try Q3Post out, and then start up Quake 3 (or quit Quake 3 and restart it if it was open) and connect to a server. Once you connect to a Quake 3 server, Q3Post should put up a message in the mIRC channel which describes the server you connected to. The message will be posted after a short delay, since Q3Post only checks for new info every few seconds so that it doesn't hog your computer. You can adjust the delay in the Q3Post menu if you want to.

Popup Menu in mIRC:

To use the popup menu in mIRC click the right mouse button in a chat window, or in the status window, and select Q3Post to see the menu items.

"Post Current Quake 3 Arena Server IP"

This is so you can manually post the IP of a server you are connected to, if you want to.

"Connect to a Quake 3 Arena Server"

Lauch Quake 3, connecting to the server IP address that you will be prompted for. This will also tell others in IRC that you are connecting to that server, and turn on Auto-Respond, just like if you had connected to a new server while playing. You can also do this by entering in the mIRC input line "/q3 [server IP address]"

"Get Server Stats or Browse Favorites"

Opens a window where you can get the stats from a Quake 3 Arena server (current players, ping, etc.) or browse a customizable favorites list. You can get server stats from any Quake 3 Arena server by entering its IP address in the input line of this window. Also the window has its own popup window, which allows you to do the following to your favorite server list: "Get Stats" "Connect" "Add a Server" "Remove"
You can also use the command "/q3info [server IP address]" to open this window from mIRC's input line.

"Turn On/Off Auto-Responses to Keywords"

Turn on or off the automatic responses triggered by people who type a line of text with your nickname or any other keyword that you have entered through the popup menu. The response will state the IP address and description of the server you have connected to. Auto-Respond is off each time you launch mIRC until you first connect to a Quake III Arena server.

"Add Keyword to Auto-Respond to"

Add a keyword that will trigger a response when Auto-Respond is on.

"Delete a Keyword"

Delete a keyword

"Edit Keyword File"

Edit the data file yourself if you prefer. Each keyword needs to be on a separate line, with no blank lines in between.

"Toggle Q3Post for Open Channels/Selected Channels"

Choose which IRC channels Q3Post will post messages in, or let Q3Post function in all channels you have open in mIRC (Default)

"Select Current Channel for Q3Post Messages"

Right click on a channel window and select this menu item to add this channel to the list of channels Q3Post is allowed to post in. Also, if Q3Post was posting in all open channels previously, it will now only post in selected channels.

"Select Another Channel for Q3Post Messages"

Same as the above menu item, except that you will be prompted to enter a channel name

"Deselect Current Channel"

Right click on a channel window and select this menu item to remove this channel to the list of channels Q3Post is allowed to post in. Also, if Q3Post was posting in all open channels previously, it will now only post in selected channels.

"Deselect Another Channel for Q3Post Messages"

Same as the above menu item, except that you will be prompted to enter a channel name

"Edit Channel File"

Edit the list of channels yourself if you prefer. Like the keyword file, each entry goes on a separate line, with no blank lines in between. Channels names start with #

"Turn On/Off Posting Server Updates"

Turn on/off the updates that say you have connected to a new server (separate from Auto-Responses)

"Change Quake III Arena Directory"

You need to set the Quake III Arena directory if it isn't C:\Program Files\Quake III Arena\

"Change the Update Delay"

Change how often Q3Post checks if you have connected to a new server (and have checked the scoreboard with TAB on that server). This number is in seconds, and the default is 20 which works well. If you make the delay really small you may have performance issues.

"About"

Let's you and others in your current mIRC channel know where to get Q3Post, and what version you are using.

"Quit Q3Post"

Shuts down Q3Post. To reload it later, type "/load RS q3post.mrc" in the mIRC input line, no quotes.

Uninstalling:

1. Open mIRC and either select the Q3Post menu item "Quit Q3Post" (if you had version 1.13 or later) or enter "/unload -rs q3post.mrc" in the input line (without the quotes), then quit mIRC

2. Move the q3post.mrc and q3pmenu.txt files out of the mirc directory, and any other files that start with "q3p"

3. Remove the included autoexec.cfg file from your Quake III Arena\baseq3 directory, or if you had your own autoexec.cfg, take the settings from the Q3Post autoexec.cfg out.

Notes:

• The Quake 3 setting creates a file \Quake III Arena\baseq3\q3pdata.txt when you connect to a server. Also, the mIRC script will create data files in your mirc directory, "q3pkeywords.txt," "q3pchannels.txt" and "q3post.ini" if you use all the options.
  
  

• Tested with Quake III Arena v1.15c, and mIRC v5.61 under Windoze 98

Version info:

The Author:

send me your questions, comments, bug reports, or ideas on how to improve Q3Post

If you would like to get an email whenever a new version of Q3Post is comes out, send me an email with the subject "subscribe Q3Post" (If you change your mind send me one with "unsubscribe Q3Post")

skLith@popaccount.com

IRC: irc.enterthegame.com #nails (look for n_hurt)