home *** CD-ROM | disk | FTP | other *** search
/ Amiga ACS 1997 #4 / amigaacscoverdisc1997-041997.iso / games / installers / z2install / z2install.doc < prev    next >
Text File  |  1997-05-19  |  15KB  |  443 lines
  1. Short:    Zeewolf 2 Hard Drive Installer
  2. Author:   girv@girvnet.demon.co.uk (John Girvin)
  3. Uploader: girv@girvnet.demon.co.uk (John Girvin)
  4. Type:     game/patch
  5. Replaces: game/patch/Z2Install.lha
  6. Requires: 1.5Mb RAM, 900K hard drive space, Installer, Zeewolf 2 ;)
  7.  
  8. TITLE
  9.  
  10.     Z2Install
  11.  
  12.  
  13. VERSION
  14.  
  15.     2.00
  16.  
  17.     Latest updates available from my homepage:
  18.     http://www.girvnet.demon.co.uk/
  19.  
  20.  
  21. AUTHOR
  22.  
  23.     John Girvin
  24.  
  25.     E-Mail: jgirvin@bfs.unibol.com (work)
  26.             girv@girvnet.demon.co.uk (play)
  27.  
  28.     WWW:    http://www.girvnet.demon.co.uk/
  29.  
  30.     SnailMail:
  31.         John Girvin,
  32.         25 Moorgate Street,
  33.         Belfast BT5 5BZ,
  34.         Northern Ireland,
  35.         United Kingdom.
  36.  
  37.  
  38. DESCRIPTION
  39.  
  40.     This is a hard drive installer for the Binary Asylum polygon
  41.     helicopter blaster "Zeewolf 2 - Wild Justice".
  42.  
  43.     Please read this document *thoroughly* before attempting to use
  44.     the installer! There are some important points you may miss if
  45.     you just dive right in, so much as it may be against your nature,
  46.     I REALLY DO THINK YOU SHOULD READ THIS FILE. You have been warned!
  47.  
  48.  
  49. ARCHIVE CONTENTS
  50.  
  51.     Z2Install.info
  52.     Z2Install/Install_Zeewolf_2
  53.     Z2Install/Install_Zeewolf_2.info
  54.     Z2Install/Z2Boot
  55.     Z2Install/Z2Install.doc
  56.     Z2Install/Z2Install.doc.info
  57.     Z2Install/Z2MakeDat
  58.     Z2Install/Zeewolf2_HD
  59.     Z2Install/Zeewolf2_HD_icon
  60.     Z2Install/Zeewolf2_icon
  61.  
  62.  
  63. INSTALLING THE GAME
  64.  
  65.     Read the "SPACE REQUIREMENTS" and "BUGS/CAVEATS" sections of
  66.     this document NOW! They are important. Really.
  67.  
  68.     Workbench or CLI use.
  69.  
  70.     Installation is best handled by using the "Installer" program
  71.     from Commodore, which should have been provided with your
  72.     original system disks. It is also available from Aminet as:
  73.  
  74.     util/misc/Installer-43_3.lha
  75.     (NB: the version number might have changed!)
  76.  
  77.     After installation is complete, you may delete the directory
  78.     produced by extracting this archive ("Z2Install"). All files
  79.     required for running the game will be found in the "Zeewolf 2"
  80.     directory created during installation.
  81.  
  82.  
  83.     FROM WORKBENCH:
  84.     ---------------
  85.     Extract all files in the archive to your system.
  86.     They will be extracted to a drawer called "Z2Install"
  87.  
  88.     Open the newly created "Z2Install" drawer and double click on
  89.     the "Install_Zeewolf_2" icon found there.
  90.  
  91.     Follow the instructions given to you by the Installer program:
  92.     - all trainer and trainer-GUI related choices you make will only
  93.       apply if you start the Zeewolf2_HD program from Workbench. If
  94.       you start the trainer program from CLI (or from a script) then
  95.       these options will be ignored.
  96.  
  97.     - all trainer and trainer-GUI related choices are *default* values
  98.       only and may be changed after installation by editing the
  99.       icon tooltypes of the "Zeewolf_HD" program or using the
  100.       trainer GUI.
  101.  
  102.     - when asked to insert your game disk, do so and wait for the
  103.       floppy activity light to go out before clicking the 'Proceed'
  104.       button.
  105.  
  106.     The game will be installed to a directory you select on your
  107.     hard drive. You will be alerted if installation fails for any
  108.     reason.
  109.  
  110.  
  111.     FROM CLI/SHELL:
  112.     ---------------
  113.     Extract all files in the archive to your system.
  114.     They will be extracted to a directory called "Z2Install"
  115.  
  116.     CD to the "Z2Install" directory created when you extracted
  117.     the acrhive.
  118.  
  119.     Type "Installer Install_Zeewolf_2" and press RETURN.
  120.  
  121.     Follow the instructions given to you by the Installer program:
  122.     - when asked to select a "User Level" you *must* choose "Expert".
  123.  
  124.     - all trainer and trainer-GUI related choices are *default* values
  125.       only and may be changed after installation by editing the
  126.       icon tooltypes of the "Zeewolf_HD" program or using the
  127.       trainer GUI.
  128.  
  129.     - when asked to insert your game disk, do so and wait for the
  130.       floppy activity light to go out before clicking the 'Proceed'
  131.       button.
  132.  
  133.     The game will be installed to a directory you select on your
  134.     hard drive. You will be alerted if installation fails for any
  135.     reason.
  136.  
  137.  
  138.     THE HARD WAY:
  139.     -------------
  140.     As of version 1.00 the Hard Way has become VERY HARD INDEED
  141.     and so I have discontinued support for this installation method.
  142.  
  143.     If you absolutely cannot use the supplied Installer script then
  144.     get in touch with me and I'll try to sort you out, but I really don't
  145.     recommend doing things The Very Hard Indeed Way.
  146.  
  147.  
  148. CONFIGURING THE GAME
  149.  
  150.     The Zeewolf2_HD program icon has a number of tooltypes which may be
  151.     modified at any time to change the way in which it operates. Note that
  152.     if you start the program from CLI then options saved in the program's
  153.     tooltypes are ignored.
  154.  
  155.  
  156.     "NOGUI"
  157.     -------
  158.     Specify this tooltype to disable the trainer GUI. If the GUI is
  159.     disabled then the game will run with the default options specified
  160.     in the other tooltypes.
  161.  
  162.     If the NOGUI tooltype is not present then the trainer GUI will appear.
  163.  
  164.  
  165.     "INF_LIVES"
  166.     "INF_ARMOR"
  167.     "INF_CANNON"
  168.     "INF_ROCKET"
  169.     "INF_AAM"
  170.     "INF_FUEL"
  171.     ------------
  172.     Specify any combination of these tooltypes to set the default state of
  173.     the corresponding trainer. For example, if you specify the "INF_LIVES"
  174.     and "INF_FUEL" tooltypes then the infinite lives and infinite fuel
  175.     trainers will default to being active.
  176.  
  177.     If any of the above tooltypes are not present, then the corresponding
  178.     trainer will default to being inactive.
  179.  
  180.  
  181.     "START_MISSION=<value>"
  182.     -----------------------
  183.     Specify this tooltype and a mission number to set the mission that you
  184.     will begin playing at. <value> should be between 1 and 33; if it is not
  185.     then mission 1 will be used by default
  186.  
  187.     If the START_MISSION tooltype is not present then you will begin, as
  188.     normal, on mission 1.
  189.  
  190.     To re-access mission 1 within the game, enter the "start" password.
  191.  
  192.  
  193. PLAYING THE GAME
  194.  
  195.     Read the "BUGS/CAVEATS" section of this document NOW!
  196.  
  197.     FROM WORKBENCH
  198.     ==============
  199.  
  200.     From Workbench, open the "Zeewolf2" drawer created during
  201.     installation and click on the "Zeewolf2_HD" icon.
  202.  
  203.     From the CLI/Shell, CD to the "Zeewolf2" directory and
  204.     type "Zeewolf2_HD".
  205.  
  206.  
  207.     IF YOU OPTED TO USE THE TRAINER MENU
  208.     ------------------------------------
  209.     Read this if you did not specify "NOGUI" in the icon tooltypes.
  210.  
  211.     The trainer window will open allowing you to select the trainers you wish
  212.     to use while playing the game and a selection of levels that you may choose
  213.     as your starting mission. Initially all trainers and the starting mission
  214.     number are set to the default values specified in the program tooltypes.
  215.  
  216.     To activate a trainer, e.g.: Infinite lives, you must click on the
  217.     appropriate gadget. A checkmark (tick) will appear in the box beside
  218.     any activated trainer; if the box is empty then the trainer is inactive.
  219.  
  220.     To select a starting level, choose it from the cycle gadget below the
  221.     trainer gadgets. The selected starting mission is displayed in the body
  222.     of the cycle gagdet and indicates the mission you will begin playing at.
  223.  
  224.     When you have selected the trainers and start mission you want, click the
  225.     "Play" gadget in the lower left of the window. The game will now load and
  226.     run if possible.
  227.  
  228.     If you started Zeewolf 2 by mistake, or have changed your mind and do
  229.     not want to play the game right now then click the "Cancel" gadget
  230.     in the lower right of the window..
  231.  
  232.  
  233.     IF YOU OPTED TO DISABLE THE TRAINER MENU
  234.     --------------------------------------
  235.     Read this if you did specify "NOGUI" in the icon tooltypes.
  236.  
  237.     The game will load and run if possible. No trainer window will appear.
  238.     Active trainers and starting mission will be determined from the default
  239.     values as specified by the other tooltypes of the Zeewolf2_HD program.
  240.  
  241.  
  242.     FROM CLI/SHELL
  243.     ==============
  244.  
  245.     Change Directory to the directory you have Zeewolf 2 installed in.
  246.     To start the trainer, type "Zeewolf2_HD" followed by the options you
  247.     wish to activate. Note that if you start the trainer from CLI then
  248.     options saved in the program's tooltypes are ignored.
  249.  
  250.     "NOGUI"
  251.     "INF_LIVES"
  252.     "INF_ARMOR"
  253.     "INF_CANNON"
  254.     "INF_ROCKET"
  255.     "INF_AAM"
  256.     "INF_FUEL"
  257.     "START_MISSION"
  258.     ---------------
  259.     These command line options correspond to the tooltypes described in
  260.     the previous section.
  261.  
  262.     For example:
  263.  
  264.     Zeewolf2_HD NOGUI INF_LIVES INF_ARMOR
  265.  
  266.     would start Zeewolf 2 and give the player infinite lives and armor.
  267.     No trainer GUI would appear.
  268.  
  269.  
  270. SPACE REQUIREMENTS
  271.  
  272.     Requires approximately 900K of free space on your hard drive.
  273.     Please do not attempt installation if you have less than this
  274.     amount free on the partition you intend to install Zeewolf 2
  275.     on.
  276.  
  277.     The "Zeewolf2.dat" file (the big one, about 880K) may be crunched
  278.     using a packer/patch combination that modifies the dos.library
  279.     "Open" and "Read" functions eg: XData or PPData. This should save
  280.     you a few hundred Kb of hard disk space if you need it. You will
  281.     still require approximately 900K of hard drive space to do the
  282.     installation however.
  283.  
  284.     The game disk is cached in memory during play, so you will
  285.     require approximately 1.5Mb of free RAM in order to play the
  286.     game. If this amount of memory is not available the loader
  287.     will report the error and quit.
  288.  
  289.     Due to the stringent memory requirements, owners of 2Mb machines
  290.     may be unable to run the game while Workbench is loaded.
  291.  
  292.     If, for whatever reason, the loader stops with a "could not
  293.     allocate xyz" error, then close down some applications or
  294.     commodities to free memory and try again. If this does not
  295.     work then reboot and try running the game again from a minimal
  296.     system (boot with no startup-sequence).
  297.  
  298.  
  299. BUGS/CAVEATS
  300.  
  301.     Z2Install is provided "as is" and is used at your own risk.
  302.  
  303.     The author is not liable for any loss or damage caused by the
  304.     use or misuse of this program. It almost certainly *wont* destroy
  305.     your Amiga, but if it does (or does anything else untoward) then
  306.     I cannot be held responsible.
  307.  
  308.     Z2Install cannot be used to create pirate versions of Zeewolf 2.
  309.     The installer does not affect the protection system of the game
  310.     in any way - you will still need your original game manual to
  311.     enter the required protection codes.
  312.  
  313.     When running the installer it is advisable to disable any virus
  314.     checking software you may have running. The original game disk
  315.     uses a non-standard bootblock which will most likely cause your
  316.     virus checker to complain and this could interefere with the
  317.     installation process. It is not necessary to disable such programs
  318.     before playing the game once it is installed.
  319.  
  320.     The installer is written in as system friendly a way as possible,
  321.     but the game is not. Owners of heavily expanded Amigas may have
  322.     problems running the game, but this is not the fault of Z2Install
  323.     and there is little I can do about it :( Try the usual system
  324.     degrading tricks if you run into difficulties, or get in touch
  325.     and Ill try to sort you out.
  326.  
  327.     Multitasking is disabled while the game is running and it is not
  328.     possible to return to Workbench (or whatever) after you have
  329.     finished playing. A system reboot is necessary. Sorry, but theres
  330.     nothing I can do about it - its the way the game was written.
  331.  
  332.  
  333. TESTING INFORMATION
  334.  
  335.     Created on A1200/68030+68882-40Mhz/8Mb/KS39.106, but should run on
  336.     any Amiga with enough RAM that the original Zeewolf 2 would run on.
  337.  
  338.     I have also tested the patched version on a vanilla 2Mb A1200 and
  339.     and a 50Mb A4000/060.
  340.  
  341.     If you have a problem running Z2Install then I WANT TO KNOW! Please,
  342.     feel free to get in touch.
  343.  
  344.  
  345. HISTORY
  346.  
  347.     0.90  First version, beta only.
  348.           Released to Aminet in August 1996.
  349.  
  350.     0.91  Internal version, not released.
  351.  
  352.     0.92  Added cheat menu.
  353.           Made crashing less likely by allocating disk image memory
  354.           at a high address. Not guaranteed to work, but increases
  355.           the odds a lot :)
  356.           Released to Aminet in September 1996.
  357.     
  358.     1.02  Bug fixed in Z2Boot - would free memory twice if loading failed.
  359.           Completed the game from hard drive.
  360.           Manual installation (The Hard Way) no longer supported.
  361.           Added ability to install or not install the cheat menu.
  362.           Version number moved in line with ZInstall.
  363.           Released to Aminet in November 1996.
  364.  
  365.     1.03  Internal version, not released.
  366.  
  367.     1.04  Added trainer to select start level.
  368.           Added infinite armor trainer.
  369.           Trainer GUI now uses GadTools gadgets.
  370.           Added ability to store a default configuration in icon tooltypes.
  371.           Can now disable/enable GUI with tooltypes.
  372.  
  373.     1.05  Fixed stupid bug in GUI that would cause a crash sometimes.
  374.           Released to Aminet in March 1997.
  375.  
  376.     1.06  Internal, not released.
  377.  
  378.     1.07  Rewrote GUI to avoid bugs in the Blitz2 compiler >:(
  379.           Released to Aminet in March 1997.
  380.  
  381.     2.00  Rewrote GUI in SAS/C to make it font sensitive.
  382.  
  383.  
  384. FUTURE
  385.  
  386.     - Better select level trainer:
  387.       - change level accessed by 'start' password to the chosen level.
  388.  
  389.  
  390.     - Add a "Quit" option to return you to WorkBench after the game.
  391.       (this seems possible :)
  392.  
  393.  
  394. HOST NAMES
  395.  
  396.     Uploaded to wuarchive.wustl.edu (Aminet) probably in game/patch
  397.  
  398.  
  399. FILE NAMES
  400.  
  401.     Z2Install.lha
  402.     Z2Install.readme
  403.  
  404.  
  405. PRICE
  406.  
  407.     One email message - Z2Install is emailware.
  408.     (if you use it then let me know :)
  409.  
  410.     I'd also appreciate a postcard of your home town, especially if you
  411.     live outside of the UK! This isnt required, but it would be *nice* :)
  412.  
  413.  
  414. DISTRIBUTABILITY
  415.  
  416.     (c) 1996-1997 John Girvin. No modifications may be made to either the
  417.     program or its accompanying documentation without my consent.
  418.  
  419.     Freely Distributable, provided all files are included unchanged
  420.     in any distribution and no more than minimal handling/media
  421.     costs are charged.
  422.  
  423.  
  424. ACKNOWLEDGEMENTS
  425.  
  426.     "Zeewolf 2" is (c) 1995 Binary Asylum.
  427.     Piracy is theft. If you like the game then buy it
  428.     (and run it from your hard drive with Z2Install) !
  429.  
  430.     v2.00- GUI written in Blitz Basic v2.10.
  431.     Blitz Basic is (c) 1995 Acid Software http://www.acid.co.nz/
  432.  
  433.     v2.00+ GUI developed from code supplied by Hans Guijt
  434.     (h.guijt@inter.nl.net) as used in his fMSX-Amiga project
  435.     (Amiga MSX Emulator).
  436.  
  437.     BIG thanks to Chris Coulson (c.j.coulson@newcastle.ac.uk)
  438.     for helping me debug and update the patch for his A4000/060
  439.     and different versions of Zeewolf. Chris's homepage is at:
  440.     http://www.ncl.ac.uk/~n0afx/
  441.  
  442. --------------------------------------------------------------------------
  443. $VER: Z2Install documentation version 2.00 (c) 1996-1997 John Girvin