README.TXT

Fragomatic's Rcon Commander
http://www.planetquake.com/fragomatic/rcon_cmdr

===========================================================

SETUP
-----
To install Fragomatic's Rcon Commander, unzip the archive to a local directory and double-click on the setup.exe file.

SUMMARY
-------
Rcon Commander allows server admins to control game servers remotely without having the game installed.  Enter the server address, port number (default 27960), and rcon password and you are off...

This version of Rcon Commander Supports the following games:

	Quake 3 Arena
	Quake 3: Team Arena
	Return To Castle Wolfenstein
	Elite Force
	Quake 2
	Sin

Use Rcon Commander to send rcon commands, change server settings, send messages to players, check player status and get server information.   It's highly versatile and works with many multiplayer games.  The only restriction is that the game accepts rcon in the format "rcon <password> <commands>" and communicates using UDP as opposed to TCP.

===========================================================

GENERAL
-------
To use Rcon Commander, you must have an rcon password cvar set in the server config file.  For Quake 3, Elite Force, Castle Wolfenstsein, etc you must add this line to your server config file:

	set rconPassword "YourPassword"

For Quake 2, Sin, etc you would add this line to your server config file:

	set rcon_password "YourPassword"


Naturally, you would change "YourPassword" to whatever you would like your password to be.

You do not need to type "rcon <password> <commands>"!

Use commands as thought you were right at the server.  For instance, after typing the correct rcon password into the supplied field, you could run this command, "quit".  It would shutdown the server.  You could also change maps.  For example, enter "map q3dm2" into the command field and click the "SEND" button or press <ENTER> on your keyboard.

AUTO-QUERY
----------
Auto-Query will query the status of a server automatically.  To enable this feature, select VIEW->OPTIONS from the main menu.  Enable the Auto-Query checkbox.  Specify your desired time and rate. 

THEMES
------
There are a few pre-defined themes for you to select from.  To select a pre-defined theme, select VIEW->THEME then choose a theme.  They simply modify the output window background and text colors as well as the font used.  You can create you own look and feel from the VIEW->THEMES->CUSTOM or VIEW->OPTIONS->THEMES window.

HINT: Use BigScreen mode and set Auto-Query ON for LAN Parties!  Project it on the wall so players can see stats and it provides an interface to admin at the same time.  Very cool.
  
LOGGING
-------
To log the contents of the console, select VIEW->OPTIONS fo the main menu.  Enable the ENABLE LOGGING checkbox.  Logging occurs one-for-one.  Meaning, anything that goes to the console, goes to the log in the same format.  To view the log (if available), press FILE->VIEW LOG.

SERVER HISTORY
--------------
The 15 most recent servers with successful connections are saved in the server history.  The 10 most recent ports are also stored.  You can clear the history at anytime.  Simply select COMMANDS->CLEAR SERVER HISTORY from the main menu.

CONFIGURING THE LISTENER FOR REMOTE REBOOTING
---------------------------------------------
If you wish to utilize the "reboot" command for rebooting the game server remotely using rcon commander, you will need to install and configure the Rcon Listener on the machine that the game server is running.  Under the Application directory for Rcon Commander, look for the listener directory.  Copy those files to the game server and run setup.exe.  Once installation is complete, you will need to browse for the game executable (for example, look for "quake3.exe").  Then, you will need to add the command line parameters to the appropriate field.  When Rcon Commander executes a "reboot" command, it will send a "quit" to the game server, pause for 4 seconds, then send a "reboot" to the listener.  The listener then launches the game based on your configuration.

NOTE: The Rcon Listener listens on TCP port 1001 and only responds to a "reboot" command.


==========================================================

FINAL WORDS
-----------
Enjoy!  This is free, so live it up.  But, please, send your problems and suggestions (regarding this app of course) to will@planetquake.com.  I would like to hear if you know of commands that are failing, causing general malaise, or whatever.  Just gimme some feedback =)

This product is freeware. I am not responsible for any damage this software may cause.  Use at your own risk.

OTHER DOCUMENTS TO NOTE
-----------------------
commands.txt  - a detailed list of the available commands.
variables.txt - a small list of variables to get you started.
versions.txt  - a history of changes and releases.
license.txt   - legalities and usage guidlines.

==========================================================
(c)2001 Will Lowman.  All rights reserved.
Fragomatic is in no way related to or affiliated with Raven Software, Nerve, Gray Matter, Id Software, or Activision.