home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 1 / FFMCD01.bin / bbs / libdisks / d700t799 / disk799.lha / HackLite / HackLiteV2.lha / MultiCnfs < prev    next >
Encoding:
Text File  |  1992-12-15  |  6.8 KB  |  135 lines
  1. CONFIGURATION FILES
  2.  
  3. Many players of Hack Lite will be content to play a single character.
  4. Others, however, may want to define several different characters which
  5. might play independently.  One situation where this is convenient is a
  6. shared family computer, where each family member might define his or her
  7. own unique character.  Another situation would be that of a Hack fanatic
  8. (er, enthusiast) who wants to experiment with many different kinds of
  9. characters.
  10.  
  11. To support these modes of play, Hack Lite supports multiple configuration
  12. files, each of which defines a set of game preferences.  The master
  13. configuration is HACKLITE.CNF, which is created by HackInstall when the
  14. game is installed.  (It is created in ENV:/ENVARC: if these paths are
  15. defined on your system, and otherwise in S:.)  Other .CNF files can be
  16. created in the Hack Lite game directory by the HackConfig program, or
  17. manually.  The way in which a configuration file is chosen and used
  18. depends on whether you play from the CLI or from Workbench.
  19.  
  20. PLAYING FROM THE CLI
  21.  
  22. If you play from the CLI, the default configuration file is used unless
  23. you use the -u argument when you start the game.  For instance, if you
  24. start up the game with the command "hacklite2 -uMordred", Hack Lite looks
  25. first for a file named Mordred.CNF.  If Mordred.CNF does not exist, then
  26. the standard configuration is used.  Note that you can use other arguments
  27. to override the configuration.    For instance "hacklite2 -uMordred -I" will
  28. start up an immortal-mode game, even if the Mordred character is not
  29. normally immortal.  (See Hack.man for more information on Hack Lite
  30. command line arguments.)
  31.  
  32. The search for a configuration is actually a little more complicated than
  33. stated in the last paragraph.  The full search for a .CNF file is as
  34. follows:
  35.  
  36. 1.  Look in the current directory for playername.CNF, and then for
  37.     HACKLITE.CNF.
  38. 2.  Look in ENV:/S: for playername.CNF, and then for HACKLITE.CNF
  39. 3.  Look in the Hack game directory for playername.CNF, and then for
  40.     HACKLITE.CNF.
  41.  
  42. PLAYING FROM WORKBENCH
  43.  
  44. Hack Lite is even more flexible when you invoke it from a Workbench icon.
  45. It makes use of the icon "tool types" to take the place of command-line
  46. arguments for common startup requirements.  The meaningful tool types are
  47. as follows:
  48.  
  49. CONFIG=filename - specifies the name of a configuration file to be used
  50.     for this game.  If there is no CONFIG tool type, the configuration
  51.     file is found as described below.
  52.  
  53. NAME=playername - specifies the player name.  If there is no NAME tool
  54.     type, the player name is taken from the icon name.    If there is no
  55.     CONFIG tool type, the configuration file name is assumed to be
  56.     playername.CNF.
  57.  
  58. CLASS=letter - specifies the character class, e.g., CLASS=K to play a
  59.     knight.  If there is no CLASS tool type, the class is read from the
  60.     configuration file.
  61.  
  62. (There is also a SAVE= tool type.  This tool type is set by the game when
  63. it creates icons representing saved games, and should not be set by you.)
  64.  
  65. Once the configuration file name has been determined, the search for the
  66. configuration file takes place as described above for the CLI.    The
  67. "current directory" here is the directory containing the icon.
  68.  
  69. USING HACKCONFIG TO DEFINE CONFIGURATIONS
  70.  
  71. When you invoke HackConfig, it always reads the master configuration file.
  72. You can use the "Load Config" button to read some other configuration file
  73. instead.  The "Update Player" button is used to store back the
  74. configuration you most recently loaded, with any changes you've requested.
  75. (If you haven't loaded any other configurations, HACKLITE.CNF is
  76. rewritten.)  The "Add Player" button is used after you've changed the
  77. player name to create a new configuration.  Note that if you select
  78. "Update Player" when the player name does not already have a
  79. configuration, or select "Add Player" for a player name that does have a
  80. configuration, HackConfig will "do the right thing". In particular, it
  81. will not create a configuration where the file name and the player name
  82. specified in the file differ, such as a Mordred.CNF specifying a player
  83. name of Lancelot.
  84.  
  85. Additional controls are provided by the HackConfig menus.  The "Save
  86. Config", "Save As" and "Save as Default" menu selections allow you more
  87. control over where a configuration file is stored.  You should avoid "Save
  88. As" unless you know what you're doing!  Note that "Save As Default" is
  89. most useful if you want to change the name of your default character,
  90. since "Update Player" does not let you change the player name.
  91.  
  92. If you play from Workbench, you may also wish to use the "Add Icon"
  93. control. You would use "Add Icon" when you want to add an icon for an
  94. existing player. For instance, suppose your character Mordred is defined
  95. in the configuration file as a Knight.    Every time you click on the
  96. Mordred icon, you will play as a Knight.  Now you decide you would
  97. sometimes like to play Mordred as a Wizard.  If you set Mordred's
  98. character class to Wizard and select "Update Player", the Mordred.CNF file
  99. will be rewritten to show that Mordred is a Wizard by default.    If you
  100. wanted instead to sometimes play Mordred as a Wizard, but keep the default
  101. of Knight, you would select "Add Icon" instead. A new Mordred-W icon will
  102. be created to let you play Mordred as a Wizard, and MORDRED.CNF will not
  103. be changed.
  104.  
  105. SAVE FILE CONSIDERATIONS
  106.  
  107. One of the unique features of Hack is the use of "bones files", which
  108. allow a player to encounter the ghost of another player (or of himself) as
  109. he explores the dungeon.  When several players use the same computer, you
  110. may need to be careful to allow the "bones" of any player to be accessed
  111. by the others.    The considerations depend on which of the four
  112. configurations you selected when you installed the game.
  113.  
  114. Full Hard Disk:  No problem!  The "bones files" are all stored in the
  115.     common "Saved Games" directory.
  116.  
  117. Minimal Hard Disk:  No problem!  The "bones files" are stored on your hard
  118.     disk.  Each player can have his own save disk, or they can all share.
  119.  
  120. Two Floppy Setup:  The "bones files" are all stored on the save disk that
  121.     was created at install time.  For this reason, if possible, all players
  122.     should share the same save disk.  If this is not possible, a player who
  123.     uses another save disk will sometimes be required to swap in the "bones"
  124.     disk.  Note that Hack Lite save files are fairly small.  A single floppy
  125.     can comfortably hold at least 4 save files for games with many levels,
  126.     and more for typical games.
  127.  
  128. One Floppy Setup:  The "bones files" are stored in the common "Saved
  129.     Games" directory on the floppy.  So you will have no problem accessing
  130.     them, but you may find yourself cramped for space on this disk.  Note
  131.     that you could play with an additional save disk, if you selected
  132.     "Requestor for Saved Games" when you installed.  Even if you use a
  133.     separate save disk, it is still possible to run out of space during a
  134.     game which generates many levels.
  135.