home *** CD-ROM | disk | FTP | other *** search
/ Quake 'em / QUAKEEM.BIN / quake / programs / qcheck11 / readme.txt < prev   
Encoding:
Text File  |  1996-04-15  |  5.3 KB  |  126 lines
  1. QuakeCheck 1.1 Readme.txt  Released 4-15-96
  2.  
  3. QuakeCheck is Windows 95 program.  I have no idea if it runs under NT and I am
  4. fairly certain in won't run under 3.1X, even with Win32s installed.
  5.  
  6. -------------------------------- Introduction --------------------------------
  7.  
  8. QuakeCheck is a program to check the state of Quake servers on the internet.
  9. It will return the name of the server, the name of the current map, the
  10. current number of players, and the maximum number of players.
  11.  
  12. ----------------------- The instructions for QuakeCheck ----------------------
  13.  
  14. --- The Main Window ---
  15.  
  16. Enter the IP number of a Quake Server in the edit box or choose a server from
  17. the server menu (read 'The Server Menu' section for instructions on setting
  18. it up).  Press the Check button to query the Quake server for it's current
  19. state or press the Ping button to ping the server using whatever ping program
  20. you want (read the 'Pinging Servers' section for more information on setting
  21. up and using your ping program).   
  22.  
  23. An IP number can also be passed to QuakeCheck as a command line parameter.
  24. The format looks like this "QCheck xxx.xxx.xxx.xxx" without the quotes.  Only
  25. one IP number can be passed in this manner.  When the program loads, it is
  26. placed in the edit box and the Check button is pressed.
  27.  
  28. If no Quake server is found a message box is displayed with an appropriate
  29. message.
  30.  
  31. --- The Server Menu ---
  32.  
  33. To setup the server menu, select Setup from the File menu.  You can store up
  34. to maximum of five Quake servers.  The name field is how the server will
  35. appear under the Servers menu and the IP number field is the IP number of the
  36. server (duh).  If the name of the server is left blank it will not appear on
  37. the menu, even if you have entered an IP number.
  38.  
  39. When you select a server from the servers menu, it's IP number is placed in
  40. the edit box and the Check button is pressed.
  41.  
  42. --- Pinging Servers ---
  43.  
  44. QuakeCheck has the abibilty the call the ping program of you choice with the
  45. current IP number as a command line parameter.
  46.  
  47. If you specify no ping program, QuakeCheck looks for a ping program in the
  48. current PATH named ping.exe, ping.com, or ping.bat.
  49.  
  50. You can tell QuakeCheck to use a specific ping program by selecting Setup from
  51. the File menu.  Enter the name or complete path of the program you want to
  52. use.  You can press the Browse button to use a standard Windows file open
  53. dialog box to find the file.
  54.  
  55. If you need to give your ping program any command line parameters, create a
  56. batch file for it.  Use %1 where the IP number should go.  Here's an example
  57. of the batch file I use to call the Win95 ping.exe:
  58.  
  59.         c:\windows\ping.exe -t %1
  60.  
  61. I use -t so the ping program keeps pinging until I press <ctrl> c.
  62.  
  63. ------------------------------- Closing Thoughts -----------------------------
  64.  
  65. If QuakeCheck can't find a server at the address you specified, try it a few
  66. times before you give up on it.
  67.  
  68. The ping button can actually be used to run any program you want.  You could
  69. launch Quake with the button by setting up a batch file and selecting the file
  70. in QuakeCheck's setup screen.  Such a file could look like this:
  71.  
  72.         quake +exec rick.cfg +connect %1
  73.  
  74. %1 is the IP number of the Quake server currently in QuakeChecks edit box.
  75.  
  76. QuakeCheck is based on QStat by Steve Jankowski and QuakePing by Len Norton.
  77. I really have to thank these two guys for posting the source to their
  78. programs.  QuakeCheck is the very first WINSOCK application I've written, and
  79. as a matter of fact, my very first internet application also.  So please keep
  80. that in mind if the thing blows up on you.  :)
  81.  
  82. Anyway, the reason I wrote QuakeCheck is so that I could see what servers were
  83. up and if anyone was on them before rebooting Win95 into DOS mode.  I really
  84. hate rebooting and discovering that no one is on any Quake servers.  Playing
  85. with yourself is no fun...unless you have a copy of Biggins. ;)
  86.  
  87. QuakeCheck is only known to work with QTEST1.  Who knows what the final Quake
  88. will be like, especially since they are re-writing the network code.
  89.  
  90. --- Who am I? ---
  91.  
  92. Rick DiBlasi
  93. aka The Source
  94. and Montoya on #quake -- That's IRC for the non-enlightened. :)
  95. rdiblasi@umabnet.ab.umd.edu
  96. http://cosyfish.ab.umd.edu/~rdiblasi/
  97.  
  98. ------------------------------ Version History -------------------------------
  99.  
  100. --- QuakeCheck 1.1 ---
  101. --- April 15, 1996 ---
  102.  
  103. Added support for pinging.
  104. Added the servers menu and the setup screen.
  105. Added the option the send an IP number as a command line parameter.
  106.  
  107. --- QuakeCheck 1.0 ---
  108. --- April 5, 1996  ---
  109.  
  110. Support for Getting Quake server status by IP number.
  111. (Didn't do much, did it?)
  112.  
  113. --------------------------------- Legal Crap ---------------------------------
  114.  
  115. This program can be freely distributed as long as it is free of charge and
  116. this file is included in the archive unmodified.
  117.  
  118. This program is provided as is.  It is not guarenteed to work properly or work
  119. at all.  Neither I, nor Inner Turmoil Inc. will be held responsible for any
  120. damages caused by the use of this program.  Basically, this program could
  121. erase your hard drive, melt your monitor, and kill people for fun, and we will
  122. STILL not be responsible.
  123.  
  124. QuakeCheck Copyright 1996 Inner Turmoil Inc.
  125. Quake Copyright 1996 ID Software Inc.
  126.