%CLS
`6-------------------------------------------------------------------------
`7 Welcome to the wonderful world of the IGS Script.  I `%Strongly `7suggest
`7 you turn on your `%Screen Capture `7mode or your `%Log File `7mode now.
`6-------------------------------------------------------------------------

                    `$How to create your OWN IGS SCRIPT!

                   `4       Impress your friends
                   `4     Make your enemies jealous
                   `4 Add your own creation to Lunatix!

                   `@I'm about to tell you how to do it!


%KEY

`3An IGS Script is a story, which you can write, that can be added to the
`3Library in Lunatix (and probably to other Doors when I write them) -- and
`3if anyone wants to keep my "logic" it could also work in other games as
`3well.  An IGS can be a simple story, or it can involve the player by
`3giving him choices about how to progress.  The script can also have the
`3Lunatix Color-Codes to make it look nice and neat -- in fact, you are
`3reading an IGS Script right now.

`3There are a handful of IGS commands you'll need to know.  IGS Commands and
`3Section Labels begin with a percent (%) sign.  If it isn't a built-in
`3command, then it will be interpreted as a label.

%KEY

`!IGS Command set (these should begin at the far left of the line)

`# %CLS `5- Clears the screen
`# %KEY `5- Asks the user to press a key, and then clears the screen
`# %ESC `5- Exits back to the command parser
`# %COM `5- Command set specifier.  It is followed by a number count
`#      `5  This is used to read in more lines, which are the labels for
`#      `5  those options.

`3Any other "%" command is treated as a label.

%KEY
%CLS

`3The first section of your IGS should be the title page, the cover, or
`3just whatever the player sees when they "open" the book.  It, and any
`3other "page" can have a %COM block that declares the commands.  Here is
`3an example of the first page of some IGS Script.  I am not using color
`3codes in this example so you can easily see what the script looks like.

%KEY

`7 
 %CLS
 Welcome to the Interactive Luny's Journal, by Mike Snyder
 This could have looked a lot nicer, but I was in a big hurry.

 Once upon a time there was this guy.  Now you get to choose:

     1) The guy's name is Fred
     2) The guy's name is Abdul
     3) The guy has no name

 %COM 3  ;Tells that there are 3 commands, and those are listed next
 Name-Is-Fred
 Name-Is-Abdul
 No-Name
 %ESC

%KEY
%CLS
`3 Each one of those 3 commands should then have a label with the same name
`3 that begins with the "%" sign.  These can also lead to more choices, or
`3 just use an %ESC without the %COM block to let it be an "end" choice. Note
`3 that %ESC is also needed regardless of commands or ending.  Example:
`7
 %Name-Is-Fred
 %CLS
 The Guy's name is Fred, and one day he died.

        The End!

 %ESC

%KEY
%CLS
`3Lunatix 3.1a (the first to have IGS Support) has a file named "BOOKS.DAT"
`3Which, like IGM.DAT for IGM's, contains specs about the IGS's that are
`3installed for Lunatix's Library.  If you write an IGS and wish to
`3distribute it, it would be nice to have an install program that installs
`3the IGS to the IGS.DAT.  However, a little later I will tell of another
`3alternative (a freeware IGS-Installer).  However, an install program is
`3not mandatory, as long as you give instructions about how to install
`3your IGS by editing the BOOKS.DAT in Lunatix.
`3The format of the BOOKS.DAT file is the book name on one line, and then
`3the file name on the next line.  For simplicity, the IGS's should just
`3be copied directly into the Master Lunatix directory.  Here is an example
`3of 2 IGS Scripts that might be in the BOOKS.DAT File:

`7         Snyder's Teriffic Novel
`7         NOVEL1.TXT
`7         Another Book Goes Here
`7         ANOTHER.TXT

`3Kind of simple, huh?

%KEY
%CLS

`3I am working on a FreeWare utility called "IGS Kit" that will have sample
`3IGS's for you to view.  It also has an IGS-VIEW utility so that as you
`3develop your IGS, you can easily "test" it.  It will also have a generic
`3Install program that you can distribute with your IGS (in case you aren't
`3a programmer, you could still provide an install program for it).  However,
`3with a little practice, you could easily write an IGS without the Kit.
`3Look for IGS-K10A.ZIP (the 10A will change if I create new versions).

`!My hope is that the IGS Script concept will catch on.  Since *anybody* can
`!create an IGS without being a programmer, I'm hoping I'll begin to see
`!lots of IGS's.  Lunatix only reads 26 at a time, but if it catches on, I'm
`!sure there will be IGS Managers and lots more.  Good luck, and if you need
`!any additional help, or would like info about the "Lunatix Story" so that
`!your book could tell a little about that, just let me know.  Our BBS
`!Number is at the second title screen when you start the game. :)

%ESC
