home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 22 / AACD 22.iso / AACD / Games / GameTracker / gametracker.readme < prev    next >
Encoding:
Text File  |  2001-05-21  |  7.4 KB  |  156 lines
  1. Short:    Gameserver browser for QW/Q/H2/Sin/Shogo
  2. Author:   SuRgEoN
  3. Uploader: v2615a@groenjord.dk
  4. Version:  0.6
  5. Type:     game/misc
  6. Requires: OS3.1, ixemul.library, ixnet.library, Play16 and jpeg datatype (Aminet..)
  7.  
  8. Recommended: Powersnap2.2a, KingCon (Aminet..)
  9. Homepage:    SuRgEoN's Quake1 Goodies http://users2.50megs.com/surgeon/quake/quakeworld/
  10.  
  11. Date: 08-MAY-01
  12.  
  13. GameTracker is a powerful script-based server browser and game launcher for Quake, QuakeWorld, 
  14. HereticII, Shogo & Sin. GameTracker relies on Qstat for retrieving server information.
  15.  
  16. GameTracker lets you browse and monitor servers easily and lets you join or spectate the action on the 
  17. server of your choice (spectator mode is only supported with QuakeWorld). GameTracker has user 
  18. configurable server-filters for ping, gamedir, mapname and capacity. Along with the filter that 
  19. excludes empty servers, this lets you overlook a narrow selection of servers that interest you the 
  20. most. There's also an option to play a sample when a certain event occurs on a monitored server 
  21. (available with autorefresh option but does only work if the server is not empty).
  22.  
  23. NOTE:
  24. Qstat is a gameserver-query tool by Steve Jankowski. The qstat executable included with GameTracker
  25. was ported to amiga by Thomas Frieden (Hyperion Software)
  26. If you want to use Qstat as stand-alone program, or maybe in conjunction with your own frontend,
  27. then remember to set stack to 200000. Otherwise bad things might happen.
  28. Qstat source is available at: http://www.qstat.org
  29.  
  30.  
  31. Installation & Configuration:
  32.  
  33. Just place the GameTracker dir where you wold prefer.
  34. If you use amcheapo (QuakeWorld proxy), GameTracker can launch this proxy automatically
  35. and connect through it. You should have a proxy.cfg in id1/configs/ dir
  36. for setting up your default proxy commands, such as fps optimizations.
  37. Have a look at the example (in scripts/id1/configs dir).
  38. The path id1/configs/proxy.cfg can not be changed, unless you edit connect.rc in scripts/amcheapo.
  39. Also set the amcheapo env variable to 1 in GameTracker.config.
  40. If you have amcheapo running elsewhere than localhost, port 27500,
  41. you should change the proxycmdline in gametracker.config to suit your setup.
  42.  
  43. I HIGHLY RECOMMEND to install and run PowerSnap. PowerSnap makes it easy 
  44. to copy and paste server addresses in the shell window, requester or in quake console.
  45.  
  46. All settings are stored in GameTracker/gametracker.config You should edit this file to suit your setup !! - It 
  47. should be obvious how to do this. All settings are commented. Just don't change the names of the 
  48. env vars :) The vars you have to costumize are prefs for the supported games: (quakedir, qwcmdline, 
  49. qscmdline, h2dir, h2cmdline .... The rest can be left at default settings.
  50.  
  51. qstatold variable:
  52. This has become obsolete since the inclusion of Qstat v2.4 Leave it at 0
  53.  
  54. runram variable:
  55.  If you are short on RAM you should set "runram" to "0" - this will constrain GameTracker's memory 
  56. usage to around 100K, but there will be considerable amount of hd-access.
  57.  
  58. GameTracker can be upgraded with mapshots for any of the supported games - just copy the images to 
  59. /mapshots. They have to be in .jpg format and must comply with this name syntax: mapname.jpg 
  60. (example: the quake custom-map aerowalk would be "aerowalk.jpg")
  61.  
  62.  
  63. Usage:
  64.  
  65. Doubleclick GameTracker and select the options and actions you want. Everything should be pretty 
  66. straightforward.
  67.  
  68. GameTracker lets you query masterservers, cachefiles and single servers for easy monitoring and 
  69. launching of the QuakeWorld, Quake, HereticII, Shogo and Sin client executables. The interface 
  70. consists of a series of questions. All functions are accessed using requesters. PowerSnap is very
  71. usefull for copying addresses from the generated serverstats to the server query, since the
  72. address has to be typed in a string requester. It is from the single server query that you view the
  73. complete rules, refresh the stats on a server and monitor the development of matches and/or monitor
  74. the server for user-specified event to occur. Naturally you can also and join or spectate games when
  75. it seems interesting (spectator mode is currently only supported with QuakeWorld).
  76.  
  77. Note on pingfilter with QuakeWorld:
  78. If you chose a pingfilter, and then queries a masterserver, you might not get any servers listed, 
  79. although the servers that have registered with the master is within the range. This is because the 
  80. masterserver itself sometimes gets excluded by the ping filter. Use up-to-date static master lists
  81. to avoid this probem. These lists can be generated with MasterCache.
  82.  
  83.  
  84. Utils:
  85.  
  86. MasterCache is a tool for updating the QuakeWorld masterserver cachefiles (barrysworld, ocrana, 
  87. planetquake, id_limbo, fortressfest ...) Run this when the cachefiles gets outdated.
  88.  
  89. CustomCache is a tool for generating filtered cache files. It can be used to split larger serverlists into 
  90. fitting categories (arena servers, duel servers etc). It can generate lists for all supported games
  91.  
  92. .......enjoy!
  93.  
  94. -SuRgEoN
  95.  
  96.  
  97.  Brief history:
  98.  
  99. v0.6:
  100. * Included qstat v2.4
  101. * Updated Quakeworld, Sin, Shogo and HereticII cachefiles
  102. * Added the ability to change game without quitting GameTracker
  103. * no need to copy any files to c:
  104.  
  105. v0.5:
  106. * Namechange to GameTracker (used to be QWbrowse)
  107. * Improved accuracy of ping filter (range 100 - 500 ms).
  108. * Progress indicator enabled - allowed by redirected output of all queries (v0.4+).
  109. * Can be run entirey from ram by setting appropriate config option (requires 1.2 MB).
  110. * Requesters are more readable and informative.
  111. * Alert "players": Optional SFX when server has a minimum # of active players.
  112. * Alert "mapname": Optional SFX when a particular map is active on server.
  113. * Alert "not full": Optional SFX when server (often full) becomes available for joining.
  114. * Alert "playername": Optional SFX when a particular player is on server.
  115. * Added a string requester to GameTracker, MasterCache and CustomCache
  116. * Memory flush before game-launch is now optional
  117. * Updated gametracker.config
  118. * Updated this document (as always)
  119. * Improved stability with amcheapo (QuakeWorld proxy)
  120. * Automatic launch of amcheapo if set in gametracker.config
  121.  
  122. v0.4 (not released)
  123. * Exdir filter added ( = exclude gamedir).
  124. * CustomCache had wrong requester titles - fixed.
  125.  
  126. v0.3:
  127. * Managed to get Qstat to run stable by increasing stack :)
  128. * Much improved performance (up to 300%), due to better use of Qstat options.
  129. * Support for Qstat v2.3+ (qstatold variable in qwbrowse.config).
  130. * Support for HereticII, Sin and Shogo.
  131. * Refresh option extended to master/file queries.
  132. * Auto-refresh option has been added to single-server-query mode.
  133. * Option for displaying all server-rules in single-query mode.
  134. * Filters for gamedir, capacity, mapname, and gamedir-capacity combination.
  135. * Filters for ping-limited server display.
  136. * Auto-displays ID maps (incl q1edge,base32b & death32c), ztndmX, ctfX, ctf2mX, missionpack 1&2.
  137. * Sound samples accompany actions.
  138. * A new tool, CustomCache, for generating and saving filtered serverlists.
  139. * Lots of new cache files (Quake, HereticII, Sin and Shogo).
  140. * Removed amigaguide generation - better filtering made it obsolete.
  141.  
  142. v0.2:
  143. * Added support for normal Quake.
  144. * Heavily improved configurability.
  145. * Improved readability of template output.
  146. * Added option to filter out empty servers.
  147. * Now QWBrowse doesn't quit when QuakeWorld or Quake is exited.
  148.  
  149. v0.1: (First public release)
  150.  
  151.  Future:
  152.  
  153. * Make use of qstat builtin filtering capabilities
  154. * Maybe more server-filters
  155. * Maybe improve GUI
  156.