home *** CD-ROM | disk | FTP | other *** search
/ Quake 'em / QUAKEEM.BIN / quake / programs / qconn_99 / readme.txt < prev    next >
Encoding:
Text File  |  1996-07-02  |  5.1 KB  |  120 lines
  1. Qconnect .99  (c) Copyright Sean Allen and Enigma Software
  2. ----------------------------------------------------------
  3. This program is released into the public domain.  Permission is granted to use 
  4. this program for any purpose you desire as long as you give me credit somewhere 
  5. and as long as you derive no monetary benefit from the use of this program.  
  6. This program is provided AS IS, and I'm not responsible for any effects it has 
  7. on you or your system.  If your computer blows up during use, or you fall over 
  8. foaming at the mouth, I'm not responsible because you have been warned ;)  I 
  9. would like to thank Steve Jankowski for releasing his code into the public 
  10. domain, without it I would have had a hard time figuring out the server init 
  11. string.
  12.  
  13. Installation
  14. ============
  15. Unzip qcon_99.zip to your Quake directory.  It HAS to reside in the same 
  16. directory as Q95.bat or it will not work correctly.  The qcon.bat file runs 
  17. Qconnect using the servers.txt file.  Edit this file (servers.txt) or create 
  18. a new one with all your favorite Quake server hosts in it (can be IPs or 
  19. hostnames).  
  20. Enjoy!
  21.  
  22. Overview
  23. ========
  24. Qconnect is a Windows 95/NT character based program that lists active Quake 
  25. servers and lets you quickly connect to them.  I wrote the program after 
  26. becoming tired of scrambling to write down an IP address and losing it among 
  27. the 1000 others or so I've already written down, starting Quake, typing the IP 
  28. address only to find the server full.  After seeing qstat by Steve Jankowski, 
  29. I thought I'd take it a step further and have my program kick off Quake 
  30. (Q95.bat actually) and automatically connect to the server selected.
  31.  
  32. Here is some sample output while running the Qcon.bat file(included):
  33.  
  34.  1. 206.248.16.205       206.248.16.205:26000   Quake        e1m2   08/08 400ms
  35.  2. quake.intersurf.com  206.151.208.134:26000  Jamal        e1m3   07/10 340ms
  36.  3. quake.phantasy.com   156.46.216.101:26000   Quake        e1m5   08/08 380ms
  37.  
  38. Simply type the number "2" and press enter.  Qconnect will spawn Quake and 
  39. connect to 206.151.208.134 (quake.intersurf.com) automatically.
  40.  
  41. Ping Times
  42. ==========
  43. Please note that the displayed ping times are not "true" ping times that you 
  44. would receive if you used a ping program.  It actually displays the time it 
  45. takes from requesting server information until the time it receives it.  This 
  46. is a better measure of actual server response time but will probably average 
  47. 100ms or more higher than a ping program would.  Please remember that ping 
  48. times are only one way to measure game play on a server and that there are 
  49. other more important factors.
  50.  
  51. Command Line Parameters
  52. =======================
  53. I tried to make this program as flexible as possible, foreseeing web page use,
  54. etc.  Here are the command line options:
  55.  
  56. -f filename    Will search through all hosts listed in the file filename
  57. -s        Will list all hosts searched, even the ones with no responses
  58. -b        Don't display the banner (but still give me credit;)
  59. -l        Don't display the line numbers, spawning will be disabled but 
  60.         you still have nice formatted output
  61. -r n        Repeat if no response "n" number of times, the default is 3.  
  62.         Since Quake uses datagrams, it is possible for packet loss, so 
  63.         the higher this number the more reliable yet slower it becomes
  64. -t n        Cycle through the list every n seconds (please set this to at 
  65.         LEAST 10 seconds or above to reduce net traffic and ease the 
  66.         load on Quake servers...)
  67. -x        Exit after spawning Quake.  Otherwise the program will Pause 
  68.         while it tries to connect to the server.  *** This is highly 
  69.         recommended - I just relized how much time Qconnect sits there
  70.         waiting for a key press - made a HUGE difference in playing
  71.         speed, ALWAYS USE THIS PARAMETER (will be taken off in future
  72.         releases)
  73. -p        Don't display the ping times
  74. -host[:port]    You can enter a host and port number directly on the command 
  75.         line if you wish
  76.  
  77. Web Masters
  78. ===========
  79. You will probably want to run Qconnect with the following parameters:
  80.  
  81.     qconnect -f filename -s -b -l -p
  82.  
  83. This will display nice formatted output without any numbers or ping times.
  84.  
  85. Quakers
  86. =======
  87. You will probably want to use something like the following:
  88.  
  89.     qconnect -f filename -r 2 -t 30 -x
  90.  
  91. This will allow you to select numbers to spawn Quake and cycles every 30 
  92. seconds.
  93.  
  94.  
  95. Future Enhancements???
  96. ======================
  97. A windows interface where you can highlight the server and just double click 
  98. to launch Quake.
  99. An option to highlight A server and have Qconnect log into it and retrieve the 
  100. current list of players playing and their frag counts (has to be an available 
  101. slot open though).
  102. Maybe some kind of statistical tracking, etc.
  103.  
  104.  
  105. Contact Info
  106. ============
  107. I welcome all comments.  Please let me know what you think or of any problems, 
  108. suggestions.  Just remember, that this is free software (you can send money if 
  109. you want), so don't flame me too hard.  Thanks.
  110.  
  111. You can contact me at:
  112.  
  113. Sean Allen
  114. Enigma Software
  115. srallen@nando.net
  116. "SirAllen" on the Quake servers and IRC.
  117.  
  118. Next on my list - Quake'bots!
  119. Happy hunting!
  120.