home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 8 / amigaformatcd08.iso / screenplay / shareware / yagg / yagg.guide.eng (.txt) < prev    next >
Amigaguide Document  |  1996-11-02  |  19KB  |  391 lines

  1. @database YAGG.guide
  2. @author "Francesco Leonardi - Giuliano Pochini"
  3. @node Main "Y.A.G.G."
  4.                        Black  Blade  Desing
  5.                      @{b}Y.     A.      G.     G.@{ub}
  6.                      Yet Another Gravity Game
  7. -  @{" What is Y.A.G.G.?                  " link intro}
  8. -  @{" Installation.                      " link insta}
  9. -  @{" What do you need to run Y.A.G.G.?  " link user}
  10. -  @{" Setup screen.                      " link config}
  11. -  @{" Available Weapons.                 " link weap}
  12. -  @{" Game controls                      " link game}
  13. -  @{" History.                           " link hist}
  14. -  @{" Known bugs.                        " link bugs}
  15. -  @{" Shareware notice.                  " link share}
  16. -  @{" How can you reach the author?      " link autor}
  17. -  @{" Registration - orderform.          " link reg}
  18. -  @{" Greetings.                         " link cred}
  19. Copyright 1995-96 - @{" Black Blade Desing " link BB}
  20. (sorry for my bad English...)
  21. @endnode
  22. @node intro "What is Y.A.G.G.?"
  23. YAGG  is  a  gravity game  like Roketz  and Bratwurst.  2, 3 or 4 player must
  24. destroy their opponents ASAP.
  25. @endnode
  26. @node insta "Installation"
  27. Just drag YAGG drawer anywhere you want.  No assigns are needed.
  28. If you cliks on YAGG icon once and select "icons/informations" from WB menus,
  29. you'll find the following tooltypes:
  30. @{b}FIELD@{ub}=<arena's name>.
  31. Write  here  the  default battlefield name, if you want...
  32. @{b}MAXZOOM@{ub}=<number>
  33. sets the maxinum zoom value when ships are close.  Allowed
  34. values are 0.49997 to 0.1
  35. @{b}PASS@{ub}=<Password>
  36. Your key.
  37. @{b}4FIREINVERT@{ub}=<On|Off>
  38. When it is "ON" firebuttons of joysticks 3 and 4 are exchanged.
  39. @{b}ModeIDint@{ub}=<modeid>
  40. Video mode of intro screen.
  41. @{b}ModeIDset@{ub}=<modeid>
  42. Video mode of setup screen.
  43. @{b}ModeIDgam@{ub}=<modeid>
  44. Video mode of gema screen
  45. Most common modes are:
  46. PAL mode
  47. ModeIDint=$29004
  48. ModeIDset=$29000
  49. ModeIDgam=$21000
  50. VGA mode         (Warning: Vfrq is 60Hz instead of 50Hz, so the game
  51.                   will be 20% faster)
  52. ModeIDint=$29004
  53. ModeIDset=$29000
  54. ModeIDgam=$21000
  55. dblPAL mode
  56. ModeIDint=$A9004
  57. ModeIDset=$A9000
  58. ModeIDgam=$A1000
  59. @endnode
  60. @node user "What do you need to run YAGG ?"
  61. - A fast Amiga.  68030/25MHz or above highly recommended.
  62. - Kickstart v.39  (3.0)  or above.
  63. - FastRam recommended.
  64. - At least 500KB free chip ram
  65. - AGA recommended (Blitter will thank you) but not required.
  66. YAGG is written in 40% assembly  and 60% in BlitzBasic2.  Due to using a high
  67. level language a data cache will increase the speed very much.
  68. YAGG  opens  a  standard  "intuition" screen, so you are free to use a screen
  69. promotor  to  use  a  non-PAL  screenmode (e.g.  try  to  activate  the "mode
  70. promotion" option in  Prefs/Icontrol).  Anyway  you should not use a vertical
  71. refresh frequency different by 50Hz.
  72. YAGG accesses directly to the blitter, anyway, it multitasks happily.
  73. YAGG has been successfully tested on:
  74. Amiga 4000/040        25MHz    8MB Fast + 2MB Chip Os v.3.0  SetPatch v40.16
  75. Amiga 4000/Ec030      25MHz    8MB Fast + 2MB Chip Os v.3.1
  76. Amiga 1200/TQM50 (030/50MHz)   4MB Fast + 2MB Chip Os v.3.0
  77. Amiga 4000/Cyberstorm060/50MHz 8MB Fast + 2MB Chip Os v.3.1
  78. PAL and DblPAL AGA modes and ECS/OCS emulation modes.
  79. Some other users told me Yagg also run on:
  80. Amiga 3000/Cybervision64+CyGfx 4MB Fast + 2MB Chip Os v.3.1
  81. Amiga 1200/020        14MHz    2MB Fast + 2MB Chip
  82. Amiga 1200/Blizzard 1230-III   8MB Fast + 2MB Chip
  83. @endnode
  84. @node config "Setup screen"
  85. Player1 O    @ Keyboard         Quit            Available ships
  86. Player2 o    Player name                        ----------------
  87. Player3 O    Copy              Start          |Plane           |
  88. Player4 O                                     |Eracle          |
  89.                                               |Nettuno         |
  90.  _        _                                   |                |
  91. |_| Flms |_|cmt                               |                |
  92.                                                ----------------
  93. Last match winner
  94.  _       _____                                         Shields
  95. |5| L.  |350  | g                                      Rot. sp.
  96.                                     Ship infos ---->   Ship mass
  97.             ____________                               Antispin
  98. Weapon1 O  |Nothing     |                              Acceleration
  99. Weapon2 O  |Big Gun 1   |                       _________________
  100. Weapon3 O  |            |                      |                 |
  101. Weapon4 O  |            |                      |                 |
  102.          ---==========--                       |                 |
  103. Arena:  |FourL        |                        |                 |
  104.          -------------                         |                 |
  105.    Speed   Damage                              |   Ship picture  |
  106.  Shots/s   Power                               |                 |
  107.   Deviat   Ammo     <--- Weapon infos          |                 |
  108.    Range   Time                                |                 |
  109.                                                |                 |
  110.                                                |_________________|
  111. ---------------------
  112. From top to bottom:
  113. Player ?   - Select the current player
  114. @Keyboard  - Selects  how  you want  to  drive your ship by.  Adapt3, Adapt4,
  115.              CPU modes are not yet implemented.
  116. PlayerName - Write your name here.
  117. Copy       - The setting of the current player will be copied to all other
  118.              ones.
  119. Quit       - The end.
  120. Start      - Starts a new battle.
  121. Available ships - These  are the ships  you can use.  Just  click on the name
  122.                   of the ship and it will be displayed in the box below.
  123. Flms       - Enable the "flame" effect.
  124. Cmt        - Enables the comet-like missile trails
  125. LastMatchWinner - It explains itself.
  126. L.         - The number of lives.
  127. g          - Gravity acceleration. Useful values are -3000...3000.
  128. Arena      - Click here to choose the battlefield.
  129. Weapon ?   - Each  ship  can  mount  up to  4 different weapons.  Select here
  130.              what mounting you  are going to select the weapon.  The mounting
  131.              is highlighted  in  the ship  box and you can select the type of
  132.              weapon in the list.
  133.              Each  mounting  can carry a certain amount of weight.  According
  134.              to the chip you have and the mounting you have choosed, the same
  135.              weapon can have a different amount of ammunitions.
  136. Ship Infos:
  137.   Shields  - The damage your ship can sustain.
  138.   Rot. sp. - Rotation speed.
  139.   Mass     - Ship mass.
  140.   Antispin - How fast your ship regain control after an uncontrolled spin.
  141.   Acceler. - Acceleration.
  142. Weapon infos:
  143.   Speed   - Starting bullet speed.
  144.   Shots/s - Mah, I don't know :-)
  145.   Deviat  - The lower, the better precision.
  146.   Range   - The  distance  the  bullet  can  reach.  In  case  of  autoguided
  147.             weapons  this is the  distance after  which the missile begins to
  148.             follow the nearest ship.
  149.   Damage  - Single bullet damage. (before arming and not counting splinters).
  150.   Power   - Average damage for 1 second burst.
  151.   Ammo    - Number of shots.
  152.   Time    - The duration in time of your amminutions.
  153. @endnode
  154. @node weap "Weapons"
  155. @{b}Machine Gun 1-5@{ub}           Standard gun. Medium range. Quite weak.  Each model
  156.                           have it's own speed ang Shots/s rate.
  157.                           Bullets appears grey in color.
  158. @{b}Bouncers 1-5@{ub}              Just like machine guns, but when the bullet hits a
  159.                           wall, it bounces away and splits in 2 (model 1) or 3
  160.                           (model 2) and so on. Bullets are blue.
  161. @{b}Big Gun 1-3@{ub}               Same as above, but the autofire  is very slow. It's
  162.                           between 5 and 6 time more dangerous than MG.
  163.                           This is a long range weapon.  Bullets are orange.
  164. @{b}Small Rocket 1-3@{ub}          They  have  accelerated  movement  and  an exposive
  165.                           warhead.  They  strike  a damage just like BG1, but
  166.                           can bump your opponent against a wall.
  167.                           The color is white.
  168. @{b}Frag.Rocket 1-6@{ub}           They are a bit stronger than SRs. They release a
  169.                           lot of slinters, so you can damage your opponent
  170.                           even if you don't hit him. If you don't want to
  171.                           damage yourself, you should fire these weapons
  172.                           when you are stopped.
  173.                           Higher model are more powerful, faster and long
  174.                           range oriented, but you can fire them at a lower
  175.                           rate.
  176. @{b}Medium Rocket 1-3@{ub}         They  are  similar to  SR, but  they are slower and
  177.                           3-4 time more harmful.
  178. @{b}Large Rocket 1-3@{ub}          More  dangerous  versions  of  MR. They  are really
  179.                           powerful, but  also  very  heavy. Usually  you  can
  180.                           carry only a few shells.
  181. @{b}Turbo Gun 1-3@{ub}             High powered  version of machine guns. Only  little
  182.                           ships (which can't mount heavier weapons) can carry
  183.                           these guns.
  184. @{b}Missiles 1-4@{ub}              Simple  missiles.  They  are  quile easy  to  avoid
  185.                           beacuse  of their strong inertia, but don't  try to
  186.                           exceed them in speed!
  187.                           When you  launch a missile, it  starts just  like a
  188.                           small  rocket.  After  a  certain  amount  of  time
  189.                           (lower  in  Mis-1, higher  in  Mis-4), the  missile
  190.                           begins to follow the nearest ship.  So don't launch
  191.                           a   missile-1  when  your  opponent   is   far  and
  192.                           vice-versa.
  193. @{b}Mini Gun 1-3@{ub}              Between MG and TG.
  194. @{b}Shooting missile 1-4@{ub}      :-))  Really  bad  weapon.  After  they  are  armed
  195.                           (arming  time  varies  very little), they  begin to
  196.                           shot  to  the nearest ship.  The  higher the model,
  197.                           the longer is the lifetime.
  198. @{b}Class-A Smart Missile 1-4@{ub} Slow  and hard  to avoid  missiles.  They are a bit
  199.                           less powerful than standard missiles.
  200. @{b}Auto Rockets 1-3@{ub}          Just like  Small rockets, but they  can change they
  201.                           direction  a bit.  You  can  hit yor  opponent much
  202.                           more easily. Higher models have higher precision.
  203. @{b}Shooting Mine 1-5@{ub}         Very   very   slow   shooting   missiles. You   are
  204.                           recommended to not collide with them....
  205. @{b}Class-B Smart Missile 1-4@{ub} Faster version of Class-A smart missiles.
  206. @{b}Mine 1-4@{ub}                  Simple and powerful proximity mines.
  207. @{b}Missile Mine 1-3@{ub}          These mise launch 4,5 or 6 mini missiles. They are
  208.                           quite weak, but they are good against small and fast
  209.                           ships which can easily avoid standard mines.
  210. If  a missile  (mines, smarts and FR too) hits before being armed, it strikes a
  211. very low damage.  Actually, you waste a bullet.
  212. @endnode
  213. @node game "The game"
  214. Ship controls are:
  215. Left and right      - Rotate the ship.
  216. Up                  - Accelerate.
  217. Fire   e            - Shoots weapons 1 and 2.
  218. Down                - Shoots weapons 3 and 4.
  219. Keys:
  220.                           5
  221. Keyboard 1    LShift   1  2  3        numeric pad
  222.                           W
  223. Keyboard 2    RShift   A  S  D   B
  224.                 ^                ^
  225.                 |----------------|-- Double key
  226. @{b}P@{ub}    Pause on/off
  227. Try to not bump against the wall. You  must destroy  your opponent before you
  228. can do it with you.
  229. To the edges of the screen are displayed the following informations:
  230. Lives  (2 pixel = 1 life)
  231. Shields
  232. Ammo1  (1 pixel = 16 bullets)
  233. Ammo2  (1 pixel = 16 bullets)
  234. Ammo3  (1 pixel = 2 bullets)
  235. Ammo4  (1 pixel = 2 bullets)
  236. Number of missiles that are following you.
  237. @endnode
  238. @node hist "History"
  239. DO NOT USE OTHER VERSIONS BUT THE FOLLOWING ONES !!
  240. v1.0   * First release.
  241. v1.8   * Fixed  stupid  bug in  the  GUI.  Now  player  1 has no more need to
  242.          reselect the first weapon after every match.
  243.        * Simple mine added. (Old mines are renamed to Shooting mine).
  244.        * Some changes to the ships.
  245.        * Minor changes.
  246.        * Added "Arena:" button to choose the battlefield at runtime.
  247.        * Added some undocumented weapons.
  248.        * Speeded up by 50% ship's points calculation.
  249.        * The direction of weapons in the pre-battle screen was wrong.
  250.        * Small change to the sound routine
  251.        * New intro screen
  252. v1.12  * When you ship is damaged you cannot shoot well
  253.        * Ships no more reappear over another ship.
  254.        * Stupid bug that trashed 115KB of memory removed
  255.        * Now missile trails are much more fun :))
  256.        * Now you cannot completely disable the flames
  257.        * Little bug in the GUI fixed
  258. v1.13  * Now takes care of the ship mass when you are hit.
  259.        * Code is a bit shorter
  260.        * Two ships added
  261. v1.14  * Stupid bug introduced in v1.13 fixed
  262.        * Various changes in collision handling routines
  263.        * "Eracle" collision detection error fixed.
  264. v1.15  * Yet another little gub removed.  I'm sorry for allt these bugs,
  265.          but I can't work well for free.
  266. v1.16  * Rewritten collisions handling.  Improved playability.
  267.        * Some minor changes
  268. v1.17  * Boom3 sound changed.
  269.        * Updated copyright note.
  270.        * Some minor changes
  271. v1.18  * 17-6-96
  272.        * MAXZOOM icon tooltype added
  273. v1.19  * 21-6-96
  274.        * "Copy" button added
  275. v1.21  * 1-7-96
  276.        * Some optimizations
  277.        * Added support for 4-joysticks adapter (not tested yet).
  278. v1.22  * 6-7-96
  279.        * Really stupid bug in LoadArena() routine fixed.
  280. v1.23  * 20-7-96
  281.        * 4-played adapter should work now (I hope...)
  282. v1.25  * 02-11-96
  283.        * Pause key added
  284.        * Three new weapons
  285.        * Three new tooltypes
  286.        * Ship rotation improved
  287.        * When a player dies, he restarts away from others
  288. @endnode
  289. @node bugs "Known bugs"
  290. - On A1200s the keyboard controller can't handle  multiple key  pressings, so
  291.   you can't control your ship by keyboard on A1200s :-(
  292. - YAGG seems to hang when QuickGrab is running.
  293. - Don't run SuperDuper while playing Yagg.
  294. WARNING: I haven't a 4-joy adapter, so I couldn't test my routines. If you
  295. find any problem contact @{"Me" link autor}.
  296. If firebuttons are exchanged, try setting @{"4FireInvert" link insta} tooltype to ON.
  297. Please report all the bugs you find !!
  298. @endnode
  299. @node share "Shareware notice"
  300. This program is shareware.  If you often use it, you @{u}must@{uu} register.
  301.  This software is  subject to the "Standard Amiga FD-Software Copyright Note"
  302.  It  is  SHAREWARE as  defined in  paragraph  4s. If you  like it  and use it
  303.  regularly please send $8 to me (see below).
  304.  For more information please read "AFD-COPYRIGHT" (Version 1 or higher).
  305. @{b}This game can be included in Aminet, Aminet Set, Fred Fish and
  306. Meeting Pearls CDROMs.@{ub}  In all other cases you must ask me a written
  307. permission.
  308. YAGG has the following limitations:
  309. - You can load only 7 ships.
  310. - When you load the game, you must wait 10 seconds.
  311. - After 3-5 matches YAGG quits and you have to reload it.
  312. If you want to regiter, fill the form at the end of this document and send it
  313. to me.
  314. If you DON'T want to register, delete Yagg from you disk.
  315. Please send  only cash, EUROcheque  or postal  orders.  I cannot cash foreign
  316. cheques.  I'll  send you  the password to disable  all the above limitations.
  317. I also  accept the registered  version of a your  program  (if I like it,  of
  318. course.  Please contact me first).
  319. If I will not receive enought registration agreements, I'll stop development.
  320. @endnode
  321. @node autor "How can you reach the author?"
  322. To pay the registration fee, send bugreports, ...
  323. Write to:
  324.   Giuliano Pochini
  325.   Via Torino 34
  326.   19122 La Spezia
  327.   Italy
  328.   Tel. +39-187-714863
  329. Or via e-mail:
  330.   2:332/807.18@fidonet
  331.   pochini@denise.shiny.it
  332. @endnode
  333. @node cred "Greetings" 
  334. Thanks to:
  335. Francesco Leonardi  -  Black Blade Desing - Betatester, designer  and  author
  336.                        of presentation screens.
  337. Dario Pochini       -  My brother, author of a few ships and betatester.
  338. Jukebox/talent      -  Author of the really good PD music.
  339. Acid Software       -  For BlitzBasicII!!
  340. Martin Huttenloher  -  For MagicWB.
  341. Prrrr!  to:
  342. My mum              -  To be so much demoralizer.
  343. Acid Software       -  To not fix those stupid old bugs!!!
  344. Stefano             -  My brother's friend.  He  promiser to draw some ships,
  345.                        but he did nothing, wasting my time.
  346. Fucked pirates      -  
  347. @endnode
  348. @node BB "Black Blade Desing"
  349.                              Black Blade Desing
  350.                                      is
  351.                    Giuliano Pochini and Francesco Leonardi
  352.               Giuliano Pochini             Francesco Leonardi
  353.               via Torino, 34               via Aurelia, 251
  354.               19122 La Spezia              19020 Ricc
  355.  del Golfo (SP)
  356.               Italy                        Italy
  357.               EMail:                       EMail:
  358.               2:332/807.18@fidonet         2:332/807.19@fidonet
  359.               pochini@denise.shiny.it      leonardi@denise.shiny.it
  360.               Coding, Concept              Concept, Desing
  361.               and Programming              and Graphic
  362. @endnode
  363. @node reg "Registration"
  364.      To:
  365.      Giuliano Pochini
  366.      via Torino, 34
  367.      19122 La Spezia
  368.      Italy
  369.      I would like to receive the registered version of YAGG
  370.      Name:     __________________________________________________________
  371.      Address:  __________________________________________________________
  372.                __________________________________________________________
  373.      EMail:    __________________________________________________________
  374.      Hardware config: ___________________________________________________
  375.                __________________________________________________________
  376.      Other:    __________________________________________________________
  377.                __________________________________________________________
  378.                __________________________________________________________
  379.                __________________________________________________________
  380.      I send the registration fee by...
  381.            o  Lit. 12.000 (or $8 or equivalent) in  cash  included in this
  382.               letter.
  383.            o  An international postal money order of Lit. 12.000.
  384.            o  A registered version of a my program, included in this pack.
  385.      I read all the copyright notes of this program and I completely agree
  386.      with  them. I  will  install the registered  copy  of YAGG only on my
  387.      Amiga and I will not distribuite it.
  388.      _____________________  ___________________________________________
  389.              Date                             Sign
  390. @endnode
  391.