home *** CD-ROM | disk | FTP | other *** search
/ Quake 'em / QUAKEEM.BIN / quake / programs / qspy26sa / qspy.txt < prev   
Encoding:
Text File  |  1996-08-06  |  9.4 KB  |  241 lines
  1. Quake Spy 2.6
  2.  
  3. The birth of Quake Spy:
  4.  
  5.     This program was born out of a desire to quickly find a playable
  6.         Quake server.  I must have spent a week looking at the finger output
  7.         from Servers@ns.stomped.com and then manually pinging those IP
  8.         addresses looking for a server with a decent response time.  While
  9.         this accomplished my initial goal, it was hardly an acceptable
  10.         solution.  Hence, the birth of Quake Spy!
  11.  
  12. Quake Spy has these features:
  13.  
  14.     * Gets a list of active Quake servers from the following sites:
  15.  
  16.       1. Finger Servers@ns.stomped.com
  17.       2. http://citrix.progress.com/servers.html
  18.       3. http://www.pipo.com/quake/quake.html
  19.       4. Finger vfuks@monmouth.com
  20.          (try Deicide's Quake Servers at http://www.monmouth.com/~vfuks)
  21.       5. User defined finger source
  22.       6. User defined http source
  23.       7. User defined http source
  24.       8. User defined http source
  25.  
  26.       Quake Spy is able to parse any finger or web page for IP addresses.
  27.       Just fill in the user defined areas and roll your on list!
  28.  
  29.     * Pings these sites a configurable numbers of times.
  30.  
  31.     * Queries these sites for server name, map name, current and max
  32.       players.
  33.  
  34.     * Displays results in a list box in the following format:
  35.  
  36.       Average ping in ms, number of times the pings timed out, the IP
  37.       address of the server, the name of the server, the name of the map
  38.       currently being run by the server, the current number of players on
  39.       the server and the maximum allowed players on the server.
  40.  
  41.     * Launch Quake by double clicking on a server in the listbox.
  42.  
  43.       Be SURE to tell QSpy where Quake is by using the Configure button
  44.       and selecting the Quake Page.
  45.  
  46.       (Don't do this under NT unless you have a native NT port of Quake.
  47.        Quake won't like it.)
  48.  
  49.     * Manually add and delete Quake servers to the list.
  50.  
  51.     * Save and reload the Quake server list.  This info is saved to a
  52.       file named QSpy.dat in your Quake directory.
  53.  
  54.     * Refresh the server information of selected servers.
  55.  
  56.     * Resize the Quake Spy window to suit your preference.
  57.  
  58.     * Configurable options:
  59.  
  60.       . Quake Spy either suspends its operations after Quake launches and
  61.         resumes once Quake terminates or it terminates after successfully
  62.         launching Quake (configurable option).
  63.  
  64.       . Whether or not to auto-save the Quake Spy server list upon leaving
  65.         Quake Spy.
  66.  
  67.       . Whether to ping servers after loading data.
  68.  
  69.       . Whether to auto-load the (saved) server list upon program startup.
  70.  
  71.       . Whether to auto-start the update process upon program startup.
  72.  
  73.       . Where to get active Quake server list information
  74.  
  75.       . There are five filter settings you can use to limit the output of
  76.         the server information gathering process:
  77.  
  78.             1. Display servers that return the Quake query request.
  79.             2. Display servers that are not full of players.
  80.             3. Display servers whose ping requests timed out less than
  81.                the specified amount.
  82.             4. Display servers whose average ping time is less than the
  83.                specified time.
  84.             5. Display servers whose map name starts with the specified
  85.                characters (e.g., 'dm' for servers only playing deathmatch
  86.                levels).
  87.  
  88.       . Where Quake is located on your system and what command line
  89.         options to pass to Quake when you launch it.
  90.  
  91.       . Include connection scripts aliases:
  92.  
  93.         . qlist: displays a list of the top 10 servers Quake Spy
  94.                      found.
  95.  
  96.         . s<#>:  connect to the specified server in the qlist alias.
  97.  
  98.       . Allow an automatic disconnect and display a top 10 list
  99.         of servers while in Quake and specify which character to
  100.         bind this to.
  101.  
  102.         Something to be aware of:  If you do this and later decide
  103.                 you don't want this binding, you'll have to go and remove
  104.                 the bind command from the config.cfg file in the id1
  105.                 directory.  A later version of Quake Spy will do this for
  106.                 you.
  107.  
  108.       . How many times to ping a Quake server.
  109.  
  110.       . How long to wait for a response to this ping.
  111.  
  112.       . How long to wait for a response from the query for info.
  113.  
  114. This release has been tested and (to the best of my knowledge) will only
  115. work with Windows 95/NT3.51/NT4.0.
  116.  
  117. Quake Spy makes use of MFC42.DLL and MSVCRT.DLL.  If you downloaded the stand
  118. alone verion of Quake Spy and you do not have these files in your SYSTEM
  119. directory, then you should get QSPYRT24.ZIP from the same place you got this
  120. file.  If it's not included there, you can request a copy from us, and we'll
  121. be glad to mail it to you.
  122.  
  123. We are also distributing Quake Spy in an installShield package.  If you
  124. download this package, you don't need the support files.  Everything is
  125. included in this package.
  126.  
  127. Quake Spy is freeware...with the following provisions:
  128.  
  129.     If you use Quake Spy, send us an email.  Do you like Quake Spy?  Do
  130.     you have any suggestions on how to improve it?  We want to get a feel
  131.     for what you guys think/want.
  132.  
  133.     If you feel compelled to show us how much you appreciate Quake Spy,
  134.     we will kindly accept monetary donations of any amount ;-)
  135.  
  136. -------------------------------------------------------------------------
  137. Joe Powell, jep@sclsis.navy.mil (preferred) or powelljo@jaxmail.navy.mil
  138. Tim Cook, cookti@jaxmail.navy.mil.
  139.  
  140. INFO/COMMENTS WANTED
  141.  
  142.     Wait for id to release specs on Quake protocol so we can query a
  143.        Quake server for player names and frag counts, etc.
  144.        (If anyone already knows the query strings for this, TELL ME!)
  145.     Option to keep DNS names on list or do reverse DNS (SLOW!)?
  146.     Convert listbox to a listctrl report view?
  147.     Anyone want a toolbar type interface?
  148.     More options to Quake property page (-winmem, -winlock, -nojoy, etc)?
  149.  
  150. TODO
  151.  
  152.     Option to differentiate registered servers from shareware
  153.        (suggested).
  154.     In qlist alias, indicate which server was launched (suggested).
  155.     Ability to send server list to printer/clipboard (suggested).
  156.     Remember Quake Spy window size.
  157.     Remove the disconnect key binding command from the config.cfg file
  158.        when that option is deselected or changed.
  159.     Actually PLAY Quake instead of programming for it!
  160.  
  161. REVISION HISTORY
  162.  
  163. v2.6    8/6/96
  164.     Added filter option for map name.
  165.     Added option to auto-load server list upon program start.
  166.     Added option to auto-start update upon program start.
  167.     Added 3 user defined http spots and 1 user defined finger spot
  168.        to the sources property page.
  169.     Added vfuks@monmouth.com finger to Sources property page.
  170.     Added Pipo's web page to Sources property page.
  171.     Wrote a generic routine to parse out IP addresses from any page
  172.        (suggested).
  173.  
  174. v2.5    8/2/96
  175.     Return focus to last selected item after a refresh (suggested).
  176.     Added Quake Spy option to autosave server list upon leaving QSpy.
  177.     Added Quake Spy option to ping/not ping servers after loading data.
  178.     Implemented non-blocking socket reads throughout the program.
  179.        (Press Stop immediately after starting an update and you'll
  180.         see what I mean.)
  181.     Improved display speed on delete and refresh functions.
  182.     Allowed the Quake Spy window to be resized and maximized.
  183.  
  184. v2.4    7/25/96
  185.     Added a Quake Spy property page with an option to terminate QSpy
  186.        after launching Quake.
  187.     Rewrote the Refresh button list traversal code.
  188.     The filter options are reapplied to the list upon exiting the
  189.        property page.
  190.     Added buttons and code to save/load list of servers.
  191.     Added buttons and code to allow manual addition/deletion of servers.
  192.     Rewrote portions of code to allow easy addition/deletion of servers.
  193.     Added connection scripts option when launching Quake.
  194.     Added Quake property page options to:
  195.        Include connection scripts aliases
  196.        Allow an automatic disconnect and display a top 10 list
  197.           of servers.
  198.        Specify which character to bind the above to.
  199.  
  200. v2.3    07/20/96
  201.     Added button to refresh (re-ping/re-query) selected servers.
  202.        (updated information is not checked against the filter criteria)
  203.     Added the ability to stop the server information retrieval process.
  204.     Added the ability to stop the server refresh process.
  205.  
  206. v2.2    07/17/96
  207.     Added some more status messages to indicate QSpy is doing something.
  208.     Added a proper icon to the application :-)
  209.     Fixed: If the close button was pressed during the pinging process,
  210.            the application window closed, but the process continued to
  211.            run.
  212.     Fixed: The property page settings were never initialized unless the
  213.            property page was activated.
  214.  
  215. v2.1    07/15/96
  216.     Fixed pointer bug (for real) this time (hey, it was late).
  217.     Added a property page accessed through the Configure button.
  218.     Added ][ronMan's server web page to the Sources property page.
  219.     Added Filtering options to the property page and implemented them.
  220.     Added Quake property page to allow definition of command line and
  221.        working directory.
  222.     Added ability to launch Quake by double clicking a list item.
  223.     Added a Ping property page to allow number of pings and timeout
  224.        values to be adjusted.
  225.  
  226. v2.01    07/13/96
  227.     Fixed stupid pointer bug that happened when the process was restarted.
  228.  
  229. v2.0    07/12/96
  230.     Converted application to a 32-bit Win95/NT application.
  231.     Filter out duplicates in the Stomped output.
  232.     Display results sorted by ping time.
  233.  
  234. v1.0    07/11/96
  235.     Initial Public Release as a Console Application.
  236.  
  237. LEGAL DISCLAIMER
  238.  
  239.     We're not responsible for anything that happens to your system while
  240.     Quake Spy is running.  Period!  Hey, what do you expect for free?
  241.