home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / MISC / GAMES / WARBOTS.ZIP / WARBOTS.DOC < prev    next >
Encoding:
Text File  |  1990-08-15  |  9.5 KB  |  180 lines
  1.                                      Warbots
  2.                              (c) 1990 by Chris Busch
  3.                                All Rights Reserved
  4.  
  5.  
  6.                                Welcome to Warbots!
  7.  
  8. The scientists gathered in the top secret briefing room.  All was
  9. quiet except for the speaker.  The words rolled slowly out of his mouth:
  10.       "Iraq has started to use massive chemical warfare on our
  11.    American troops!  They're dying by the thousands, but we've
  12.    been able to keep that a secret from the American public.
  13.    What we need to defeat the Iraqis is a war robot.  Something
  14.    that can be brought in to save countless lives.  We at the
  15.    Pentagon have chosen you, the top military robotic engineers,
  16.    to built this war machine.  This mission is to be known as
  17.    OPERATION WARBOTS and it will be absolutely TOP SECRET!"
  18. The scientists swiftly run to their labs to conduct testing.
  19.  
  20.  
  21. This game was created for people to learn the basics of programming while
  22. having fun and excitement.  With this program you can build a mighty "Warbot"
  23. and program it with many instructions.
  24.  
  25.  
  26.                  The Warbots Concise Command Reference Chart
  27.  
  28. Command:           Type:          (Very) Brief Description:
  29. -------------------------------------------------------------------------
  30. Add "variable"  n  procedure      adds n to "variable"
  31. Ahead              function       Returns: Barrier {87}, Cream {67},
  32.                                   Nothing {32}, or Warbot {87}
  33. AheadLeft          function       see "Ahead"
  34. AheadRight         function       see "Ahead"
  35. Alive              function       Returns number of alive warbots
  36. Backup             procedure      backs up the warbot
  37. Barrier            constant       same as 87 used with "Ahead" & the like
  38. BarrierCount       function       returns # of barriers surrounding it
  39. Beep               procedure      sounds an alarm
  40. Behind             function       see "Ahead"
  41. BehindLeft         function       see "Ahead"
  42. BehindRight        function       see "Ahead"
  43. Clear              procedure      Clears out all of the Warbot's variables
  44. Cream              constant       same as 67, used with "Ahead" & the like
  45. CreamCount         function       returns # of cream piles surrounding it
  46. CreamSupply        function       returns the warbot's remaining cream
  47. Done               procedure      same as Goto 1
  48. East               constant       same as 2, used with GetAim & SetAim
  49. EndIf              reserved       Used to end an If control structure
  50. Fire               procedure      fires a rocket
  51. GetAim             function       returns current aim (direction facing)
  52. GetBuffer          function       returns number in radio buffer and zeros it
  53. GetKey             function       Returns key in keyboard buffer, a negative
  54.                                   number is special key i.e. cursor keys
  55. GetX               function       returns x position (1 to 14)
  56. GetY               function       returns y position (1 to 12)
  57. Goto n             procedure      goes to memory line n
  58. Gosub n            procedure      jumps to memory line n, see Return
  59. If...EndIf         conditional    see Additional Notes #1 below
  60. Left               function       see "Ahead"
  61. Move               procedure      moves the warbot forward
  62. North              constant       same as 0, used with SetAim & GetAim
  63. NorthEast          constant       same as 1, used with SetAim & GetAim
  64. NorthWest          constant       same as 7, used with SetAim & GetAim
  65. Nothing            constant       same as 32, used with Ahead & the like
  66. NothingCount       function       returns # of nothing surrounding it
  67. Print  variable    procedure      Prints out variable for debugging
  68. Random             function       generates a number from 0 to 7
  69. Repeat...until     conditional    see Additional Notes #2 below
  70. Return             procedure      Returns back to a gosub
  71. Right              function       see "Ahead"
  72. RocketSupply       function       returns number of remaining rockets
  73. Scan x y variable  procedure      Scans the x,y spot & puts value in the varible
  74. Send n "botname"   procedure      sends a number to a warbot's radio buffer
  75. SetAim n           procedure      sets the aim absolutely (0-7)
  76. South              constant       same as 4, used with SetAim & GetAim
  77. SouthEast          constant       same as 3, used with SetAim & GetAim
  78. SouthWest          constant       same as 5, used with SetAim & GetAim
  79. Spill              procedure      causes cream to be released
  80. Subtract "var" n   procedure      subtracts n from "var"
  81. Turn ± n           procedure      turns the warbot relative to current aim
  82. Until comparision  reserved       Part of an repeat loop, see Additional Notes
  83. variables                         The letters "A" thru "Z" & "@", see
  84.                                   Additional Notes #3
  85. Wait               procedure      waits for the user to press a key
  86. Warbot             constant       same as 66, see Ahead & the like
  87. WarbotCount        function       returns # of warbots surrounding it
  88. West               constant       same as 6, used with SetAim & GetAim
  89.  
  90. Additional Notes:
  91.    1. "If" statements use the following syntax:
  92.                                 If a<>b
  93.                                    {lines of code}
  94.                                 endif
  95.       If the expression is false the warbot's program will jump to the
  96.       "endif".  "A" or "b" can be either be a varible, function or a
  97.       constant.  "If" statements have the operands: not equal "<>",
  98.       equal "=", greater than ">", and less than "<".  A "then" is not
  99.       necessary but cam be included for clarity.  The "If" statement can
  100.       be nested and indenting is optional.
  101.    2. "Repeat" statements are similar to "If" statements.
  102.                                Repeat
  103.                                   {lines of code}
  104.                                until a<>b
  105.       The same rules apply to "If" statements see above #1.
  106.    3. Warbots provides 26 normal variables to its programmers.  These
  107.       variables are "A" to "Z" single letter variables.  An example of
  108.       assigning a variable: "a = b".  "@" is also a variable but it is
  109.       used with GetBuffer and Send.  All variables are integers and each
  110.       warbot has its own set of varibles.
  111.    4. Warbots uses eight directions from 0 to 7 (North to NorthWest as
  112.       constants) with zero being up (North).
  113.    5. GetBuffer and Send operate with a one integer radio buffer.  This
  114.       can be accessed as the variable @.
  115.    6. Warbots is not case dependent.
  116.    7. Warbots also has the use of command line parameters, type WARBOTS /?
  117.       for help on those features.
  118.    8. Most of all, experiment and look at the sample bot files.
  119.  
  120. About the author and the program:
  121.  
  122.    Chris Busch lives in Northfield, Minnesota with his family.  He is
  123. 16 years old and has been programming for about five years.  Chris attends
  124. Northfield High School and has many activities one of which is programming.
  125.    This program was written in Turbo Pascal 5.5 (C) by Borland
  126. International, Chris's favorite programming language.  Some help was
  127. received from his friend, Kevin Huber on the playtesting and some program
  128. routines of the game.  The game consists of approximately 3000 lines of code
  129. so far.  Source code may be released to a registered user of Warbots
  130. at the author's discretion.  The source code may not be redistributed
  131. in any form.
  132.  
  133. Disclaimer: (I'm sorry but I must have the nitty-gritty)
  134.  
  135.    In no event will the author be liable for any damages, including any lost
  136. profits, lost savings or other incidental or consequential loss or damages
  137. arising out of the use or of the inability to use this program -- even if the
  138. author has been advised of the possibility of such damages.  The author will
  139. in no event be held liable for direct, indirect, or incidental damages
  140. resulting from the omission of any part of this product, including this
  141. document.  The author makes no warranties, either expressed or implied,
  142. respecting the software, its quality, performance, merchantability, or
  143. fitness for any particular purpose.
  144.  
  145. Author's Bill of Rights:
  146.  
  147.    Warbots is copyrighted, but may be distributed far and wide
  148.    if the following rules are followed:
  149.  
  150.    1. No fees are to be collected from the distribution of the trial
  151.       program version even for shipping and handling or otherwise
  152.       unless written permission is granted.
  153.    2. The program and associated files may not be distributed in a
  154.       modified form (except for the robot .WAR files which are
  155.       public domain).
  156.  
  157.  
  158.    Warbots is being distributed with the shareware concept in mind.  Where
  159. you the user may use this version of the program on a "trial" basis and if
  160. you find it enjoyable you should register it, and receive the newest update
  161. of Warbots.
  162.    If you register Warbots for the low amount of $10 then you'll receive
  163. password and source code to some very neat bots.  All you have do is
  164. include $2 for shipping & handling costs.  Also, with your registration,
  165. you'll gain access to the "The Warbots Help Hot Line" (my home phone number)
  166. where you the user can get in touch with the author himself (me)!  You will
  167. also be in line for new versions of Warbots when they are released.
  168. All this for such a low price!
  169.  
  170.                   Please send registrations & questions to:
  171.  
  172.                                 Chris Busch
  173.                               32820 Embry Ave
  174.                             Northfield, MN 55057
  175.  
  176.                                 Many Thanks
  177.  
  178.  
  179.  
  180.