Rings of the Magi
            Copyright (C) 1995 Cytherean Adventures
                     All Rights Reserved

                        DOCUMENTATION


:::::::::::::::::::=- SYSTEM REQUIREMENTS -=:::::::::::::::::::

   Rings of the Magi requires a 386sx or faster IBM PC-
compatible computer with at least 512K conventional RAM free,
VGA graphics card and monitor, a hard drive with at least 2.5
megabytes free, and a mouse and mouse driver.


::::::::::::::::::::=- STARTING THE GAME -=::::::::::::::::::::

   To start the game from DOS, you must first change to the
directory in which Rings of the Magi was installed.  For
example, type "CD \ROTM" and press the enter key.  Then type
"ROTM" and press the enter key to start the program.

   If you experience trouble getting Rings of the Magi to start
properly, see the troubleshooting section at the end of this
document.


::::::::::::::::::::::::=- THE STORY -=::::::::::::::::::::::::

   In ages long past, the mystics of Ac`Rianed realized their
powers were dwindling, and the art of the Magi was quickly
being forgotten.  The life energy of their world, which fueled
their magic, was slowly drained by some unknown, yet terrible
force.  The people of Ac`Rianed were wasting away, while the
mystics felt powerless to protect them.

   Thus is was that the mystics came together and crafted their
rings - a set of artifacts in which they could store their
remaining power.  Each mystic fashioned a set of rings from a
distinctive material, and whenever two or more of these similar
rings were brought together, the power within them could be
harnessed.  By separating the rings into different patterns and
then reassembling them, different aspects of that power could
be called upon.

   But it was not enough to simply store this power in the
rings.  New apprentices had to be trained, lest the secret of
the rings be forgotten and the world fall into ruin.  Thus was
created a special training board upon which novice users of the
rings could safely practice their assembly.  Only by
successfully completing this training can the apprentice hope
to restore peace to Ac`Rianed, and command the Rings of the
Magi...


::::::::::::::::::::::=- INTRO/STORY -=::::::::::::::::::::::::

   When the game loads, an introduction and story sequence is
displayed.  The intro/story consists of a number of short
scenes, each of which remains on screen for a short while
before advancing to the next scene.  You may advance to the
next scene more rapidly by pressing a key or clicking a mouse
button.  You may also bypass the intro/story sequence
completely by pressing the [Esc] key at any time.


:::::::::::::::::::::=- TITLE SCREEN -=::::::::::::::::::::::::

   The title screen is displayed immediately following the
intro/story sequence.  Press a key or click the mouse button
to proceed.


::::::::::::::::::::::=- MAIN MENU -=::::::::::::::::::::::::::

   The main menu consists of a number of buttons which allow
you to play or resume a game, load and save games, configure
the game, view the credits and the instructions, activate the
board editor or leave the game.


               Keyboard
   Button      Shortcut    Function
 -----------  ----------  -------------------------------------
 play game        P       If no game is currently loaded or in
               [Enter]    progress, a new game will be started.
                          If you have loaded a previous game or
                          are currently in the middle of a game,
                          the game will resume from your
                          previous position.

 config           G       Allows you to configure music and
                          sound volume, the speed of the
                          AutoSolve feature, and whether the
                          intro/story sequence is displayed
                          during start-up.

 credits          C       View the credits for Rings of the Magi.

 instructions     I       View the instructions for Rings of the
                          Magi.

 load/save        L       Load or Save a game.  

 high scores      H       View the high scores roster.

 editor           E       Board editor.

 exit             X       Quit the game and return to the
                [Esc]     operating system.  If you have not
                          yet saved your game, you will first be
                          asked if you wish to do so before
                          exiting.  Select "yes" to access the
                          load/save menu, or "no" to exit
                          without saving.


::::::::::::::::=- SELECTING A GAME BOARD -=:::::::::::::::::::

   The board selection screen allows you to choose which
particular game board you wish to play (or edit).  You may play
the boards in any order that you desire.  After successfully
completing a board, the game will automatically select the next
board for you when you return to the board selection screen,
however you may manually select a different board.

   In the upper left corner of the screen is the board preview
display area, where a miniature representation of the game
board is displayed.  As you select from among the game boards,
this display will change to reflect the currently selected
board.  If you have already solved the currently selected board
at least once it will be surrounded by a glowing red border.
You may, however, replay a board that you have previously
solved if you wish to attempt to improve your score on that
board.

   Just below the board preview display area is displayed your
current best score for this particular board, as well as your
total score for this game.

   The number and name of the current board are displayed just
to the right of the board preview display area.  You may select
the next or previous game board within the current difficulty
level by using the up/down buttons just below the board number
display.

   The difficulty level may be changed by pressing one of the
buttons located in the lower right corner labeled "Novice",
"Apprentice", "Journeyman", "Master" and "Custom".

   Once you have selected the desired board, press the "Accept"
button to begin playing.  Or, you may press the "Cancel" button
to return to the main menu without playing the board.


               Keyboard
   Button      Shortcut    Function
 -----------  ----------  -------------------------------------
     up          [up]     Select the next board within this
                          level

    down        [down]    Select the previous board within
                          this level

   accept       [Enter]   Begin playing this board

   cancel        [Esc]    Return to the main menu

   novice         N       Select difficulty level - easy

  apprentice      A       Select difficulty level - moderately
                          easy

  journeyman      J       Select difficulty level - moderately
                          hard

   master         M       Select difficulty level - hard

   custom         C       Select difficulty level - user
                          created


   There are 80 boards in total, 20 each in the the Novice,
Apprentice, Journeyman and Master difficulty levels.
Additionally, you may create your own custom boards within the
Custom difficulty level, or play custom boards created by other
owners of the Grand Master Edition of Rings of the Magi.


:::::::::::::::::::=- PLAYING THE GAME -=::::::::::::::::::::::

   The object of the game is to remove all of the colored rings
from the game board.  Once all the rings have been removed from
a particular board, that puzzle is considered completed and you
may move on to the next puzzle.

   Rings are removed from the game board whenever two or more
rings of the same color come into direct contact with each
another.  The rings cannot be moved directly, but are affected
by arrow buttons located throughout the game board.  Arrow
buttons indicate the direction in which they will exert their
force.  When an arrow button is pressed, all the rings in the
indicated row or column will move one step in the indicated
direction, unless blocked or hidden behind a solid object.

   Ring movement may be blocked by a solid wooden game piece,
or by an arrow button, or by another ring if that ring is
itself blocked by some solid object.  Additionally, a ring may
be blocked by the edge of the game board itself - it is not
possible to push a ring off the edge of the game board.


            Keyboard
  Button    Shortcut    Function
 --------  ----------  ----------------------------------------
   undo        U       Pressing the "undo" button will restore
                       the game board to the state it was in
                       before the most recent ring movement.
                       Only the most recent movement can be
                       undone.  If your score changed during
                       the most recent move, it is also
                       restored to its previous value.

  solve        S       Pressing the "solve" button allows you
                       to view one of the possible solutions
                       for this puzzle.  A bright green outline
                       will surround the "solve" button while 
                       the solution is in progress.  The game
                       board will then be restarted and the
                       arrow buttons will be automatically
                       pressed to solve the puzzle.  You may 
                       interrupt the solution at any time by
                       pressing a mouse button or the [Esc] key.

 restart       R       Pressing the "restart" button will
                       restore the game board to its original
                       configuration.  Your score will also be
                       reset to the value it had when this board
                       was selected.

  quit         Q       Pressing the "quit" button allows you to
             [Esc]     leave this game board without completing
                       the puzzle.  A message window pops up on
                       screen asking if you wish to exit before
                       completing the current board.  If you
                       wish to resume play, select "No".  If
                       you wish to exit and return to the board
                       selection screen, select "Yes".

             Alt-R     Pressing the Alt-R combination will
                       begin record mode for board solution
                       macros.  Record mode allows you to create
                       your own automatic solutions for the
                       custom game boards you have created.  A
                       bright red outline will surround the
                       solve button while recording is in
                       progress.  You may cancel Record mode by
                       pressing Alt-R again.  Pressing the
                       "solve," "restart" or "quit" buttons also
                       cancels Record mode before performing the
                       requested action.  Pressing the "undo"
                       button does not cancel Record mode, as an
                       undo can be recorded into the solution
                       macro.

             [F1]      Access the configuration menu.

             [F9]      Toggle sound effects on/off.

             [F10]     Toggle music on/off.

             Alt-S     Manually activate the screen saver.

Scoring
-------
   Points are awarded as the rings are matched up and removed
from the game board.  Additional points are awarded for
simultaneously removing several rings with a single movement.
The following table explains the scoring:

   Number of Rings
   Matched/Removed   Score
   ---------------   -----
          2            40
          3            90
          4           160
          5           250
          6           360
         etc.


Recovering From A Bad Move
--------------------------
   It is possible to move a ring or match up several rings in
such a way as to make the game board impossible to solve.  If
this happens you should immediately try "undo"-ing your last
move.  If you do not "undo" that move, and continue playing,
you may receive a warning message indicating that the game
board cannot be solved.  This message will only appear if the
game board cannot be solved AND the "undo" version of the game
board also cannot be solved.  You will be asked if you wish to
restart this board.  If you select "yes" the board will be
reset to its initial state and you may try to solve it again.
If you select "no" the board will remain in its current state
and you may continue to play the board as is, although it will
not be possible to actually solve the puzzle.  You may also
restart the game board manually at any time by pressing the
"restart" button.

Screen Saver
------------
   After five minutes of inactivity (no key presses or mouse
presses) the playing screen will switch to a screen saver
display in order to save wear and tear on your monitor.  Simply
move the mouse, press a key, or press a mouse button in order
to restore the playing screen.


::::::::::::::::::=- COMPLETING A GAME -=::::::::::::::::::::::

Completing a game board
-----------------------
   Upon completion of each game board, one of the Mystics of
Ac`Rianed will appear and deliver a message regarding your
performance.  You may press any key or a mouse button to
advance through this message more rapidly.


Completing all of the game boards within a difficulty level
-----------------------------------------------------------
   Upon completion of each complete level, you will be awarded
one of the symbolic finger rings which indicate the status of a
Ring Master.  Once you have collected all four finger rings you
will have truly earned the title "Ring Master."  You may then
command the Rings of the Magi, and help restore peace to the
people of Ac`Rianed.  Congratulations!


:::::::::::::::::::::=- HIGH SCORES -=:::::::::::::::::::::::::

   If your current total score qualifies you for inclusion in
the high scores roster, you will be prompted to enter your name
upon the roster before you return to the main menu.  A glowing
red border will surround the slot in which your high score will
be stored.  Enter your name using the keyboard, then press
[Enter] or use the mouse to press the "done" button to proceed.


   In order to clear the entire high scores roster, use the
mouse to press the "clear" button.


::::::::::::::::::=- CONFIGURATION MENU -=:::::::::::::::::::::

   Clicking on the "config" button from the main menu will
display a sub-menu from which you may adjust several parameters
affecting the game.  These parameters include the volume of
sound effects and music, the rate at which the solve feature
operates, and whether or not the intro sequence is displayed
when the program is started.  These configuration settings will
be automatically saved to disk so that they will remain in
effect the next time that you play Rings of the Magi.


Sound Effects And Music
-----------------------

   Sound effects may be completely disabled by clicking on the
button labelled "fx".  A red circle with a slash through it
indicates that sound effects have been disabled.  You may re-
enable sound effects by pressing this button again.  Music may
be enabled/disabled in the same manner by clicking on the
button labelled with a musical note symbol.

   The volume of the sound effects may be adjusted by
clicking on the two arrows just to the right of the "fx"
button.  Clicking on the left "<-" button will decrease the
volume, while the right "->" button will increase the volume.
The indicator labelled "VOL" will move left or right to reflect
the volume changes you have made.  The music volume may be
changed in the same manner by clicking on the buttons just to
the right of the musical note button.

Solve Speed
-----------

   The rate at which the automatic solve feature operates may
be increased or decreased by clicking on the two arrow buttons
just to the right of the "solve speed" label.  Clicking on the
left "tortoise" button will decrease the solve speed, while
clicking on the right "gazelle" button will increase the solve
speed.  The indicator labelled "<->" will move left or right to
reflect the changes you have made.

Intro On/Off
------------

   The intro and story sequence which is displayed at the
beginning of the program may be disabled by clicking on the
button labelled "I".  A red circle with a slash through it
indicates that the intro has been disabled.  (Disabling the
intro will also disable the "thunder and lightning" effect
that appears when the title screen is displayed.)  You may
re-enable the intro sequence by pressing button again.


::::::::::::::::=- LOAD/SAVE GAME MENU -=::::::::::::::::::::::

   Clicking on the "load/save" button from the main menu will
display a sub-menu from which you may either save the current
game or load a previously saved game.  A saved game remembers
all your individual board scores, as well as your total score
and the level/board that you are currently playing.  There are
sixteen "slots" in which games may be saved.  The currently
active slot is indicated by a glowing red border.  The scroll
buttons along the left side of the menu will allow you to
scroll forward or backward through the list of saved game
slots.


Saving A Game
-------------

   Click the mouse on the game slot in which you wish to save
the current game.  A glowing red border will now surround that
slot.  Next, click the mouse on the "save" button.  A glowing
red underline cursor will appear within the chosen game slot,
prompting you to enter a descriptive name by which this saved
game can be identified.  Use the keyboard to enter a name for
the game.  The backspace key may be used to remove characters
from a previously entered name.  Once the name has been
entered, press the [Enter] key or click the mouse again on the
"save" button to save the game.  The game will be saved
immediately, and you will be returned to the main menu.

Loading A Game
--------------

   Click the mouse on the game slot which contains the
previously saved game that you wish to load.  A glowing red
border will now surround that slot.  Next, click the mouse on
the "load" button.  The game will be loaded immediately, and
you will be taken directly to the board selection screen where
you may continue your game.

Canceling A Load/Save
----------------------

   If you decide that you do not wish to either load or save a
game, simply click the mouse on the "cancel" button.  You will
be returned to the main menu, and may continue your existing
game.


::::::::::::::::::::::=- CREDITS -=::::::::::::::::::::::::::::

   Clicking on the "credits" button from the main menu will
display a list of credits, displaying the names of the people
responsible for creating Rings of the Magi.  Press the mouse
button, or any key, to continue.


:::::::::::::::::::=- INSTRUCTIONS -=::::::::::::::::::::::::::

   Clicking on the "instructions" button from the main menu
will display a set of screens which provide the instructions
for playing Rings of the Magi.

            Keyboard
  Button    Shortcut    Function
 --------  ----------  ----------------------------------------
  < prev    [left]     Display the previous instructions page.
            [PgUp]

   exit     [Esc]      Return to the main menu.

  next >    [right]    Display the next instructions page.
            [PgDn]


:::::::::::::::::::::::=- EDITOR -=::::::::::::::::::::::::::::

   The board editor allows you to create your own game board
layouts - all without any programming knowledge required!
Creating new game boards is as simple as using a paint program.
Simply "color" in the game board with the desired game pieces,
and then play it!  What you see is what you get!

   You must first select one of the custom boards which you
wish to edit.  The board selection screen is used for this
purpose.  Notice that the score windows contain the word
"editor" to indicate that you are in edit mode.  You can only
select among the boards within the "custom" difficulty level
while in edit mode - you cannot edit the original game boards
that came with Rings of the Magi.


   Once you have selected a game board the edit screen will be
displayed.  On the left side of the screen is the game board
display, exactly as it will appear while playing the game.
Along the right side of the screen are the various editing
tools needed to create a game board.

   The top right window displays the currently selected
editing object.  This is the object which is ready to be placed
on the game board.  The game boards within Rings of the Magi
consist of twelve distinct game piece objects and areas of
blank space.  There are six different colored rings, one solid
wooden piece, and five wooden arrow buttons.  You may change
the current editing object by pointing to one of these game
pieces in the object selection area just below the current
object window.  The newly selected game piece will be displayed
as the current object, and will remain the current object until
a new object is selected.

   You may place the current object on the game board by
pointing to the grid cell in which you wish to place the
object, and pressing the left mouse button.  You may also
continue to hold the mouse button and drag the mouse in order
to repeatedly place the object throughout the board.

   An alternative method for selecting the current editing
object is to use the right mouse button to point to an object
on the game board and "grab" it for later use.  You may then
"place" it with the left mouse button as described above.

      Left  Mouse Button = PUT object  on  game board
      Right Mouse Button = GET object from game board


            Keyboard
  Button    Shortcut    Function
 --------  ----------  ----------------------------------------
  tile                 Clicking the mouse on one of the tiles
 select                within the tile selection area will
  area                 cause that tile to become the current
                       editing object.

  save         S       Saves the board to disk, making your
                       changes permanent.

  quit         Q       Quit the editor and return to the board
                       selection screen.  If you have made
                       changes to the current board but have
                       not yet saved them, you will be asked if
                       you wish to save this board before
                       exiting.  Select "yes" to save the board
                       before exiting, or "no" to exit without
                       saving your changes.

              Alt-X    Clear entire game board.


:::::::::::::=- SHARING USER-CREATED BOARDS -=:::::::::::::::::

   After you have created a new game board with the editor, you
are encouraged to share it with other players if you wish.  In
order to do this, you must be comfortable with copying files
from either DOS or Windows.  The game boards that you have
created are simply stored as a collection of files within your
Rings of the Magi directory.  All that is necessary to share
your game boards is to gather up these game board files and
give them to another owner of the registered version of the
program.

   The game boards are stored in files with the following
filename pattern:

      CUSTOM##.BRD

   The ".BRD" extension identifies this file as a game board.
The "##" represents the number of the board as it appears
within the game.  For example, the very first custom board will
be stored in a file named "CUSTOM01.BRD".

   In addition, you may wish to share the solution scripts that
you have recorded for your custom boards.  Again, these are
simply stored as files in the Rings of the Magi directory, and
may be copied along with the game board files.

   Solution scripts are stored in files with the following
filename pattern:

      CUSTOM##.SLV

   The ".SLV" extension identifies this file as a solution
script.  The "##" represents the number of the board as it
appears within the game.  Thus, the solution script which
accompanies the very first custom board will be stored in a
file named "CUSTOM01.SLV".

    An easy method to collect all of the custom files together
is to use a compression program such as "PKZIP".  The following
command will collect all of the custom game boards and solution
scripts into a single file called "MYBOARDS.ZIP" :

      PKZIP MYBOARDS CUSTOM*.*

      (Note:  PKZIP is a registered trademark of PKWARE, Inc.)

   Note that the custom user-created boards are the only files
which you may distribute.  You may not distribute any of the
original program files from the registered version of Rings of
the Magi.


:::::::::=- USING ALTERNATE CUSTOM BOARD SETS -=:::::::::::::::

   When you start Rings of the Magi from the command line, you
may optionally specify the prefix used to save and load the
custom boards.  This prefix may be up to 6 characters in
length, and will be used in place of the "CUSTOM" prefix
described above.

   Thus, if you wish to play or create a set of custom boards
with the filename pattern MYBORDS##.BRD, you may start Rings of
the Magi as follows:

      ROTM MYBORDS

   This will allow you to easily share and trade custom boards
with other players, without too much concern about overwriting
any existing files, since each player is free to name their
boards however they would like.

   If you specify a prefix of less than 6 characters, the
underline "_" character will appended in order to make the
prefix 6 characters long.

   If you specify a prefix of more than 6 characters it will be
truncated to the first 6 characters.

   If the board prefix is not specified on the command line, it
will default to the filename pattern CUSTOM##.BRD described
above.


:::::::::::::::::::=- MISCELLANEOUS -=:::::::::::::::::::::::::

   You may quickly quit the game immediately and return to the
operating system at any time by pressing ALT-Q.


::::::::::::::::::::=- CHEAT CODES -=::::::::::::::::::::::::::

   There are a number of cheat codes within Rings of the Magi
that allow you to access hidden features and customizing
options.  The cheat codes are entered by clicking the mouse on
several hidden buttons which are located on the main menu
screen.  Note that the main menu MUST be visible in order to
enter the cheat codes.

   The main menu is surrounded by the image of a stone floor,
and in each corner of the screen there is a single stone which
occupies the corner-most position.  The four hidden cheat
buttons are located behind these corner stones, one button in
each corner.  They are considered "hidden" buttons since they
make no sound, and do not change appearance when pressed.  Each
stone is a slightly different size and shape, so you must aim
the mouse carefully before pressing the hidden button.  For
convenience, these hidden  buttons are numbered as shown below:

            +-----------------------------+
            | 1 |                     | 2 |
            |---+                     +---|
            |       +-------------+       |
            |       |             |       |
            |       |  MAIN MENU  |       |
            |       |             |       |
            |       +-------------+       |
            |---+                     +---|
            | 3 |                     | 4 |
            +-----------------------------+


   Each cheat code is a sequence of five hidden button presses.
You must press the hidden buttons five times, in the correct
order, to activate a particular cheat.  The exact sequences of
button presses are listed below:

 Sequence    Cheat         Description
 -------- -------------   -------------------------------------
  14324   Solve Scoring - Allows points to accumulate when
                          boards are solved by the AutoSolve
                          feature.

  14132   Partial Solve - Allows AutoSolve to be interrupted
                          without restarting game board.  You
                          may then finish the board manually.

  23241   Fast Menus    - Disables menu animation.

  44122   Fast Preview  - Disables board preview display
                          animation.

  34113   Fast Pop-ups  - Disables pop-up message animation.

  22231   Fast Rings    - Disables ring movement animation
                          during game play.

  31412   Manual Pick   - Disables the automatic next board
                          selection on the board selection
                          screen.

  42331   Fireworks     - Enables ring explosion animation.
                          (Not recommended for slow computers)

  12443   Hungry Mode   - Enables the Mystic's sweet tooth
                          (He may deliver a new message,
                           listen carefully)

   So, for example, to activate the solve scoring cheat:
     -=-  press on hidden button #1 in the upper left corner
     -=-  press on hidden button #4 in the lower right corner
     -=-  press on hidden button #3 in the lower left corner
     -=-  press on hidden button #2 in the upper right corner
     -=-  press on hidden button #4 in the lower right corner

   When a cheat mode is successfully activated, a message will
be displayed at the top of the screen indicating the cheat
mode is "ON".  After activating a cheat mode, you may
deactivate it simply by entering the cheat sequence again.
The status message will now indicate that particular cheat mode
is "OFF".

   The cheat modes are saved when the game is exited.  Thus,
they behave somewhat like configuration options.  The next time
the game is started, the same set of cheat modes will be
active/inactive.


:::::::::::::::::::::=- HINTS AND TIPS -=::::::::::::::::::::::

*  If you make a mistake, use the "undo" button right away!  If
   you keep going without undo-ing your mistake you may not be
   able to solve the puzzle.

*  Take a good, long look at the board before you begin moving
   the rings.  Are there any "dead" areas which you should
   avoid moving the rings into?

*  Try counting the number of rings of each color to help plan
   your strategy.  For example, if there are five red rings on
   the board, you know that you will need to create both a
   three-ring match and a two-ring match.

*  Sometimes you may need to delay matching some of the rings
   in order to set up a configuration where the you can first
   match the other rings.

*  When pressing an arrow button, always check that you will be
   moving only the rings that you intend to move.  This is
   especially important with the 4-way arrow button.  Check in
   all four directions to verify that it's safe to press this
   button.

*  If you just can't seem to solve a particular board, try
   viewing the first portion of the solution by pressing the
   "solve" button.  Perhaps it will suggest a new strategy to
   you.

*  Often, the first match is the most difficult.  Once the
   first match has been accomplished the other matches are much
   easier.  For very difficult boards, try enabling the
   "Partial Solve" cheat, and press the "solve" button.  After
   the first match interrupt the solution and try to finish the
   board on your own.


:::::::::::::::::::::=- TROUBLESHOOTING -=:::::::::::::::::::::

Mouse
-----
   You must have a mouse to play Rings of the Magi.  You must
also have a mouse driver properly loaded before starting the
program.  This is typically accomplished by loading either
MOUSE.SYS, MOUSE.COM or MOUSE.EXE during boot-up, although the
driver may often be loaded manually by simply typing "MOUSE" at
the command line.

Memory
------
   Rings of the Magi requires approximately 512K free
conventional RAM in order to run.  If there is insufficient
memory, you may try removing unneeded TSR's or device drivers
from memory.

BLASTER environment variable
----------------------------
   Rings of the Magi will attempt to automatically detect your
sound hardware.  The vast majority of sound cards can be
detected by this method.  However, if you find that Rings of
the Magi fails to detect your sound card, you may use the
BLASTER environment variable to provide additional information
about your sound card to the auto-detect routine.  The
following command will set the BLASTER environment variable:
   SET BLASTER=A220 I5 D1

   Where the number following the "A" is the address of your
sound card.  The number following the "I" is the interrupt
level, and the number following the "D" is the DMA channel
used.  You must be certain that the values you specify are
correct for your particular setup.

SETUP program
-------------
   If you are still experiencing sound problems after having
tried setting the BLASTER environment variable, you may try
using the SETUP program.  The SETUP program will interactively
prompt you for the correct parameters for your sound card,
then test those parameters and write out a setup file to disk.

   To start the SETUP program, simply type "SETUP" from the
command prompt and press [Enter].  Then use the arrow keys and
the [Enter] key to navigate through the menus.  First, you must
configure your sound card.  Then, you should test that both
music and sound effects and working properly.  If so, you
should save those parameters and exit the program.  If not, you
may need to try again; re-configure your sound card and test it
until both music and sound effects work properly.

   If the program completes successfully it should have saved a
file named "SETUP.DAT" on your disk.  This file describes your
sound hardware to Rings of the Magi.  The parameters you
specified for your sound card will now be used instead of the
auto-detect routine within Rings of the Magi.


Windows
-------
   Rings of the Magi makes extensive use of your computer's
memory, video and sound hardware.  For these reasons it is not
recommended that you run the program from Windows.  However,
there are certain steps you can take to improve the program's
performance under Windows.

   If you experience sound or music problems when running Rings
of the Magi from Windows, it may be necessary to create a "PIF"
file in order to inform Windows of the resources which it must
allocate in order for the program to run.  In particular, you
may need to grant exclusive execution to Rings of the Magi in
order for it to assume control of your sound hardware.

   If you experience video or memory problems, there are
additional fields within the "PIF" file that will allow you to
grant both more main memory and more control over the video
hardware to Rings of the Magi.  In particular, you may need to
set Video Memory to "High Graphics" and set Memory
Requirements/KB Required to at least "512".

   The PIF Editor program, typically located in the Main
program group, will allow you to create this "PIF" file.  Check
your Windows documentation for more information on creating
"PIF" files.


:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::

Design & Programming:          David Bollinger
Art & Animation:               Tom Marlin, Marlin Studios
Composer:                      David B. Schultz, DBS Music

Voice of the Magi:             Dale Blackwood
Producer:                      C. Steven Blackwood
Publisher:                     MVP Software


:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::