home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / games / volume15 / xtb / part01 / README < prev    next >
Text File  |  1993-01-27  |  6KB  |  191 lines
  1.  
  2. WHAT YOU NEED TO HAVE
  3. =====================
  4.  
  5. An X11R3 or greater X server.  (It might work on earlier X11 releases,
  6. but I havn't tried)
  7.  
  8. A display of at least 1024(W)*800(H) pixels.  (1080 pixels wide is better)
  9.  
  10. A three button mouse (It's playable with a two button mouse). 
  11.  
  12. A fastish (and unloaded) CPU and reasonable drawing speed.
  13.  
  14. A fastish network.
  15.  
  16. Nothing better to do.
  17.  
  18. Software that supports the following system/library calls and UDP sockets.
  19.     Socket/network related
  20.         socket(), bind(), connect() ,gethostbyname() ,htonl() ,ntohl()
  21.     Timing related
  22.         gettimeofday(), setitimer()
  23.     General
  24.         gethostname(), getpwuid()
  25.  
  26. Machines with non 32-bit int's could be a problem (Sorry). 
  27.  
  28. Two or more players.  (The more the better). 
  29.  
  30. The program works on mono, greyscale and colour displays, and looks
  31. exactly the same on each (I havn't got a colour node :-( ). 
  32.  
  33. COMPILATION OPTIONS
  34. ===================
  35.  
  36. If you have more than 10 people wanting to play, try increasing the
  37. value if MAXUSERS in "defs.h" up to a maximum of 24.  This should work,
  38. but is untested. 
  39.  
  40. COMPILING
  41. =========
  42.  
  43. Type
  44.     make
  45.  
  46. This should create three programs, xtb, xtbd and rtb.
  47.  
  48. STARTING THE GAME
  49. =================
  50.  
  51. Pick a node (can be any machine with or without X) and run the server (xtbd).
  52.  
  53.     hostname% xtbd
  54.  
  55. For each player at a workstation run the client (xtb).
  56.  
  57.     workstation% xtb -h hostname
  58.     (ignore messages about datagrams and fielddata)
  59.     
  60. RUNNING TWO (OR MORE) PLAYERS ON THE SAME NODE
  61. ==============================================
  62.  
  63. The second and further players, should pick different port numbers to
  64. the default (and each other).  eg the second player might type
  65.  
  66.     workstation% xtb -h hostname -i 1624
  67.  
  68. To run two or more servers on the same node, use a different port number
  69. to the default.  eg. 
  70.  
  71.     hostname% xtbd -p 1627
  72.  
  73. to contact this server the player would need to type
  74.     workstation% xtb -h hostname -o 1627
  75.  
  76. ROBOT TANKS
  77. ===========
  78.  
  79. If you are short of people or want to practice, the program rtb adds
  80. robot tanks.  To create 4 robot tanks type
  81.  
  82.     robothost% rtb -h hostname -n4
  83.  
  84. Robots re-start when killed after a 5 second delay.  The -i and -o flags
  85. for xtb that change the port numbers used are also valid for rtb.  For
  86. 'n' robots 'n' port numbers are used. 
  87.  
  88. Note: Robot tanks can use a lot more network bandwidth than human players.
  89.  
  90. SHELL VARIABLES
  91. ===============
  92.  
  93. The shell variables are overridden by the command line options.
  94.  
  95. XTB_SERVER    The hostname of the server to contact by default.
  96. XTB_INPORT    The input (client) port number to use.
  97. XTB_OUTPORT    The output (server) port number to use.
  98.  
  99. KNOWN TO WORK
  100. =============
  101.  
  102. Known to work as a server
  103.     Sun 4, DecStation 3100, Microvax 2, Sun 3, HP 9000s827
  104.  
  105. Known to work as a client (display)
  106.     Sun 4, DecStation 3100,  HP9000s710 (With X dev. kit)
  107.  
  108. Works as a client with only a small number of players
  109.     Sun 3
  110.  
  111. OPTIONS
  112. =======
  113.  
  114. The -w flag turns on warping of the mouse cursor on scrolling.  The
  115. default is for the mouse cursor not to be moved when the screen is
  116. scrolled (ie.  the square under the cursor remains the same.) (Use what
  117. you find intuitive)
  118.  
  119. For xtb the -p and -b flags change the method used to draw tanks.
  120. -p uses polygons (as per previous versions)
  121. -b (default) uses bitmaps (pixmaps), this takes much more X server memory,
  122. but seems faster on most machines.
  123.  
  124. PLAYING
  125. =======
  126.  
  127. The display has several areas, the main battlefield, (you appear as a
  128. solid black tank, all others display their id) the radar, a damage
  129. display, a message window, a quit button and a list of players and their
  130. id's. 
  131.  
  132. The controls are simple.
  133.  
  134. Left button   -> Fire (in the direction the tank is facing)
  135. Middle button -> Reverse
  136. Right button  -> Forward
  137.  
  138. If you only have a two button mouse, you can use the keyboard to reverse
  139. the tank motion, any key press causes the motion to be reversed, any key
  140. release returns to normal.  If you have auto-repeat on your keyboard
  141. (most do), use a key that does not auto repeat (ie.  shift,control etc)
  142. This will not work for a window manager that does not implement the
  143. input (push-focus) window manager hint. 
  144.  
  145. The tank will rotate towards the mouse cursor when the cursor is in the
  146. main field. 
  147.  
  148. The solid black squares are obstacles, and cannot be moved through or
  149. fired through. 
  150.  
  151. The hatched areas are rough ground, you can only move at half speed
  152. across these. 
  153.  
  154. The shells have a range of about four squares, you cannot fire again for
  155. 2.5 sec after firing. 
  156.  
  157. Explosions do damage according to the (inverse square of the) distance
  158. from the explosion.  Two direct hits is sufficient for a kill, near
  159. misses cause smaller amounts of damage. 
  160.  
  161. Killing another player clears your own damage (to encourage friendly
  162. play!). 
  163.  
  164. Quitting should be done using the quit button (NOT the window manager
  165. frame)
  166.  
  167. It is possible to shoot through the diagonal of two blocks. 
  168.  
  169. NOTES
  170. =====
  171.  
  172. This was only my third ever X11 program, initially written only with the
  173. on-line manuals for reference.  If I were to re-write it, I'd probably
  174. do it differently. 
  175.  
  176. One of the design specifications was that the program should be easy to
  177. install, configure and run, so it does not use any files (other than the
  178. executables) or require require root permissions to install/run.
  179.  
  180. The program is entirely mouse controlled (unless you only have a two
  181. button mouse)
  182.  
  183. The program comes with no warranty.  I would like the conditions that
  184. apply to GNU software to apply to this software.
  185.  
  186. Good Luck!
  187.  
  188. Bernard Hatt
  189. bmh@terminus.ericsson.se
  190. Camtec Electronics (Ericsson), Leicester, England, LE1 4SA.
  191.