MAC SCARE 1.3.3
---------------

WHAT IS IT?
MacScare is an clone of ADRIFT Runner for MacOS X. You can use MacScare to run Interactive Fiction (Text Adventures) created with ADRIFT on your Mac.

WHY DOESN'T IT PLAY GAME X?
MacScare should be able to play any ADRIFT games created using ADRIFT 3.8 and later. If a game doesn't work, it very likely is either an even older game, or it uses the ADRIFT battle system, which is also unsupported.

Or maybe you're playing the Comp03 release of "Sophie's Adventure", that has a bug in it that prevents it from working in SCARE ("invalid integer at line 225749"). If you want to run this game, the author has made a fixed version available at his web site, shadowvault.net. 

WHAT COMMANDS CAN I USE?
Standard SCARE builds lack the graphical toolbar of the Adrift runner. Instead, SCARE implements the "verbose" and "brief" game commands, the "notify on/off" commands, and just always displays room names in bold.  Similarly, use "save" to save a game, "restore" or "load" to restore a saved game, "quit" to exit a game, "undo" to undo a turn (SCARE limits undo to one turn) and "restart" to start again from the beginning.

MacScare, being a variant of Glk SCARE implements an additional command, "glk".  Use this to set or request interpreter information.  Valid Glk commands are

    glk script             - Turn game transcript on or off
    glk inputlog           - Save typed commands to a file
    glk readlog            - Read input from a file (normally created using
                             'glk inputlog')
    glk abbreviations      - Turn standard IF abbreviations on or off
    glk version            - Show the version of Glk built into glkscare
    glk commands           - Turn off the special "glk" command; once off, it
                             cannot be turned back on again

Glk SCARE automatically expands the following abbreviations, common among many standard IF systems:

	'c' -> "close"		'g' -> "again"		'i' -> "inventory"
	'k' -> "attack"		'l' -> "look"		'p' -> "open"
	'q' -> "quit"		'r' -> "drop"		't' -> "take"
	'x' -> "examine"	'y' -> "yes"		'z' -> "wait"

If you want to suppress abbreviation expansion, you can prefix your input with a single quote character (like putting literal strings into a spread-sheet).  If you do this, Glk SCARE will strip the quote, then pass the rest of the string to the main interpreter without any more changes.  So for example,

	'x something

will pass the string "x something" in to the game, whereas

	x something

will pass "examine something" in to the game.  The single quote will also suppress the special "glk" commands, in the (unlikely) event that you need to pass a line starting with "glk" to the Adrift game itself.

CAN I USE OTHER PEOPLE'S SAVE-GAMES?
SCARE's saved game file format is designed to be fully compatible with the Adrift version 4.00 runner's.  Games saved from the Adrift runner may be loaded by SCARE.  The converse may be true, but in selected cases may not. The problem cases are games that use Adrift string variables.  The Adrift runner mishandles these in its save format, and so may be upset to find that SCARE is handling them correctly.

LICENSE
MacScare is subject to the GNU GPL. See the "Copying" file in this folder for the license.

AUTHORS
Simon Baldwin and Mark J. Tilford - Scare (for Unix etc.)
Andrew Hunter - CocoaGlk (the GUI library used to display the actual games)
M. Uli Kusterer - MacScare, modifications to CocoaGlk, Icon.

CONTACT
Get new versions of MacScare and the source code at http://www.zathras.de
Contact the author and maintainer of MacScare at
witness (dot) of (dot) teachtext (at) gmx (dot) net
macscare (at) zathras (dot) de
witness (at) zathras (dot) de