home *** CD-ROM | disk | FTP | other *** search
/ Action Games (2008) / akcnihry1.iso / AT-Robots 2.10 / ATRT.DOC < prev    next >
Encoding:
Text File  |  1999-06-23  |  5.5 KB  |  122 lines
  1. ATRT - AT-Robots Tournament
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. This is just a quick overview of how to use ATRT to run an automatic
  5. and/or unattended tournament aith AT-Robots.
  6.  
  7. You need a functional copy of AT-Robots version 2.08 or higher,
  8. and the ATRT archive must be decompressed into the same directory
  9. as AT-Robots.
  10.  
  11. For the purposes of explaining the use of ATRT, this file will
  12. use the example tournament that is included, "DEMO.TRN".
  13.  
  14.  
  15. GETTING STARTED
  16. ~~~~~~~~~~~~~~~
  17. Using ATRT is actually quite simple. As mentioned above, make sure
  18. it is in the same directory as the ATROBOTS program. Then you will
  19. be ready to begin.
  20.  
  21. To prepare for a tournament, you must first decide which robots
  22. to include. To make things easier, it is best to create a subdirectory
  23. under the AT-Robots directory to place the robots in. But for the sake
  24. of this example, we will assume you are not doing this, and therefore
  25. all of the robots will be in the AT-Robots directory.
  26.  
  27. The next step is to create a tournament file. For this example we will
  28. use the sample file "DEMO.TRN" (tournament configuration files must end
  29. in ".TRN"). Inside of the sample file you will see some comments that
  30. describe each line. When you make your own tournament files, it will be
  31. best to base them off of the sample.
  32.  
  33. ATRT will use all of the robots it finds in the tournament directory,
  34. so because our sample has the directory line blank, it will use any
  35. and all of the sample robots in your AT-Robots directory.
  36.  
  37. The next two lines in the tournament file specify the number of matches
  38. per pairing, and the maximum time-limit for each pairing measured in
  39. thousands of game cycles. For our example, we'll leave these set to 5
  40. and 10 respectively.
  41.  
  42. The fourth line is a set of parameters that will be passed to ATROBOTS,
  43. so we'll leave that set to "/^ /G /S /A".
  44.  
  45. Next, all you need to do is run ATRT and tell it which config file to
  46. use. In this case we would run it like this:
  47.  
  48.   ATRT DEMO
  49.  
  50. ATRT assumes a ".TRN" extension and loads "DEMO.TRN", and then it scans
  51. the directory for robots. These robots undergo a verification compile, and
  52. any that are not determined to be valid robots are disqualified.
  53.  
  54. If instead of starting the tournament it says that the results are already
  55. complete, you can type "DEL DEMO.RES" and then try again to force a re-run
  56. of the competition. (for a while, ATR2 was being distributed with copies
  57. of these demo files in it by mistake)
  58.  
  59. The tournament then begins. It defaults to graphics-off, so you see a
  60. text-mode output of the current cycle count for each match, and also the
  61. results of each match. During the tournament, you can still use the
  62. standard AT-Robots keyboard commands, so you can watch the battles.
  63. In fact, you may wish to actually remove the /G command from the
  64. 4th line in the .TRN file to make it display all of the battles in
  65. graphics by default.
  66.  
  67. The tournament may take a while. If you abort it, you can resume, but
  68. you must be careful not to change ANYTHING before you resume it, or you
  69. can ruin the results, or ruin the tournament data (and thus be forced to
  70. start over).
  71.  
  72. Once the tournament is complete, the results will be written in both
  73. text and HTML formats. In this case they will be DEMO.RES and DEMO.HTM.
  74. the .RES file is how ATRT keeps track of whether the tournament has been
  75. completed or not, so if you wish to completely start over, just delete
  76. the .RES file and ATRT will allow you to use the same .TRN file again.
  77. Just keep in mind that you lose the old results, unless you backed them
  78. up first. Personally, I name my tournament files sequentially (such as
  79. T1, T2, etc), to keep them all seperate.
  80.  
  81. There will also be a .LOG file created during the tournament, which is
  82. a log of the individual pairings in the competition, so you can see which
  83. robots did well against which other robots.
  84.  
  85. And that's it! Enjoy!
  86.  
  87. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  88.  
  89. REVISION HISTORY:
  90.  
  91.   1.01   - Changed terminology. Now the term 'pairing' is used instead of
  92.              'bout' to make things less confusing.
  93.          - Now uses /R3 report mode, and can thus track kills, deaths,
  94.              and shots fired.
  95.  
  96.   1.02   - Now uses /R4 report mode.
  97.          - Displays the best robots for several categories.
  98.  
  99.   1.03   - Now passes entire custom parameter list for the test-compile
  100.              phase to disqualify robots based on settings (particularly
  101.              when using /#).
  102.  
  103.   1.04   - Added option to score off a single /R4 report file (great for
  104.              doing large rumbles).
  105.          - "Best Marksman" and "Most Haphazard" now display the numbers
  106.              correctly in the results outputs.
  107.  
  108.   1.05   - You can now put a '/y' parameter *after* the tournament name
  109.              to make it automatically assume "yes" for yes/no questions).
  110.          - Generates an overall report for the entire tournament in the
  111.              standard /R4 format.
  112.          - Maximum number of robots decreased to 512 to save some memory.
  113.          - Fixed an uninitialized variable issue or three.
  114.          - Changed the output stats to consolidate a few things.
  115.          - Added "longest reign" and "newest contender" to generated
  116.              results (which only show up if the number of matches differ
  117.              between the robots).
  118.          - Sorting of robots made a little cleaner, so that in the ranking,
  119.              ties get broken by kills, then deaths, damage, longevity, and
  120.              finally error rate.
  121.  
  122.