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