************************************************************








		  KSNiloc's Sendback System
			  Version 2


		For those of us that believe in
		      life after death...







************************************************************

			---Welcome---

I guess I was wrong about saying it would probably be the
only release. For here I have created a new version that
removes all dependencies on plugins! You should be reading 
this file in a program like Notepad. "Word Wrap" should be 
turned off.

	---What the Heck is a Sendback System?---

It is just that, a program used to send the player back to a
safer place after he dies, or even when used as a spell. This
is very useful. Say the player saves in an area before a hard
boss but he cannot defeat the boss. Let's say that you cannot
leave this particular area. Well what is the player to do?
Don't fret yet if you've set variables in the parts leading
up to this fight that if left in their current condition
would cause bugs when the player returned. You will not have
to manually change all those variables.

	  ---How do I Use the Included Files?--

\

 ksniloc_sendback.prg
 readme.txt

Here you see the directory structure of the zip. The file
"ksniloc_sendback.prg" is the actual program file. It
includes all the required methods and you can set it
to be run when a spell is used to offer the player the
choice to return to the last safe place. You are reading
"readme.txt" right now.

	---How do I get the Program Working?---

There are a few steps required...

1. Make a call to SetSprites(old$,new$,handle$).
2. The variable ksniloc_firstsave!, while not terribly
   important, should be set to 1 after the player saves
   for the first time.
3. The variable ksniloc_name$ NEEDS to contain an
   identifier unique to the file. It could be something
   like the player's name.
4. Make sure you fully understand how the system works by
   reading the rest of this file.

		---The Two Types of Points---

You must declare points to send the player back to. The
player will return to the most recently declared one.
However, there are two types of points. There's your typical,
everyday ordinary points. When evacuating, the player will
simply return to the declared coordinates. The second type
of point actually saves all progress at AN EXACT MOMENT. If
you'll remember the example at the beginning, I would create
a "special" point right before the player got into the
sequence where he would be in danger. For another example,
in the game "Dark Age", a special point would be created
before the fighting tournament. When returning to a special
point, the game is restored as if it had been saved at that
point, then the player is returned to the place marked in the
last normal point.

		    ---Customization---

It is almost MANDATORY that you do the following. Open up
"ksniloc_sendback.prg" in whatever program. Scroll down until
you see something that looks like this:


*****************************NOTE*****************************
*Info about the below code will go here.
***************************END NOTE***************************
#Code
#MoreCode
#EvenMoreCode
**************************************************************

What you should do is read the text under "NOTE" and then 
decide if you wish to modify to code below. Keep on 
scrolling down and repeating the process until you reach the
bottom.

NOTE: It is strongly recommended that you only modify the
      code within these notes. Do not attempt to modify the
      rest of the code unless you REALLY know what you're
      doing.

	---Using the Sendback System After a Game Over---

This part is very simple. At the bottom of your gameover
program, add the following lines...

#gameover!=1
#Run("ksniloc_sendback.prg")

Make sure the #Empty command has NOT been run!

		---Command Reference---

--SetSprites(old$,new$,handle$)

Configure sprite options (must be run for program to work)!

old$ - the .tem file of the character that walks around on
       the screen

new$ - a .tem file where the up walking graphics show the
       character spinning

handle$ - the handle of the character

--CreatePoint(board$,x!,y!,layer!)

Creates a normal point at the specified coordinates.

--DestroyPoint()

Destroys a normal point if one has been created.

--CreateSpecialPoint()

Creates a special point.

--DestroySpecialPoint()

Destroys a special point if one has been created.

--SpecialRedraw()

A very effective method of redrawing the screen. Use ONLY
at the end of programs.

			---Ending---

Thank you for downloading this system and reading this longer
than average readme file. Hopefully the system will be very
useful and I wouldn't mind being mentioned somewhere in your 
game.

--KSNiloc
cjf@mail15.com