Plugin_teleport
===============

Author:
   bahrmanou  - Amiga5707@hotmail.com

Date:
   8 April 2002

Latest revision:
   18 august 2005


The goal of this plugin is to facilitate teleporting. It is specially useful  in cooperative maps,
concjumps and pipejumps maps where it can be very  frustrating for players to die after long and
hard work...

Installation:
=============
a) Unzip the  files in your <mod> folder, e.g.: tfc, cstrike, etc...
   NOTE: check that 'use folder names' is checked in Winzip or in your archive program!
b) Go to folder '<mod>\addons\adminmod\config' and add the line in the file 'add this to plugin.ini'
   to your file plugin.ini (in the same folder).
c) Read this to the end ;)

Usage:
======
Teleporting is handled in two ways :

   a) Any player can ask to remember his position in the map, then later he can ask to be teleported
   to this point. For this to work,  global teleporting must  have  been allowed ('admin_posallow':
   enabled by default) and user teleporting must have been allowed ('admin_posallowuser': enabled
   when the player connect).

   Commands :
   ==========
	say saveme	save current position
	say posme	teleport to saved position (see 'Teleport allowing')
	say destuckme	shift up the position (Z-axis) (useful when stuck)
	say saveme2	save current position (2nd)
	say posme2	teleport to 2nd saved position (see 'Teleport allowing')
	say poshelp	display a little reminder


   b) Admins or at least players with permission level ACCESS_TELEPORT have  access to a table of
   positions ('slots'). They can add or replace positions in this table in  the way they like.
   Finally, they can save the table  on  disk  and  reload  it  when required. By default, the table
   contains 40 slots maximum and will be  saved by default in folder '<your_mod>/pos/' (which you
   must create yourself BEFORE using this  plugin  !!), but you can save it wherever you like.


   Commands :
   ==========

	Teleport allowing:
	==================
	admin_posallow [flag]				Global teleporting flag.
							If no flag is given, get current status.
							If OFF, users cannot teleport themselves.
							By default, posallow is <ON>.

	admin_posallowuser [#user] [flag]		User teleporting flag.
							If no flag is given, get current status of
							player. For a user to be able to teleport
							himself, set posallow to <ON> AND posallowuser
							(for that particular user) to <ON>.
							By default, all users are <ON>.

      	admin_posdelay [delay]				Set delay users must wait between two 'posme'.
      							If no delay is given, get the delay status.
      							If delay==0, set delay <OFF>, that is users
      							can teleport themselves at any moment.
      							(by default, delay is set to 5 secs).


	Table relatives:
	================
	admin_pos [<#user> [#slot]]			Teleport user to the position in the slot.

	admin_posadd [#user]				Add a slot to the end of the table.

	admin_posempty					Empty the slot table.

	admin_poslist					Display the slot table in console.

	admin_posload [filename]			Load the table in memory.

	admin_posmem <#user> <#slot>			Replace the slot in the table by the user
							position.

	admin_posname <#slot> [name]			Name the slot in the table.
							'name' can be any text.

	admin_possave [filename]			Save the table on disk.
							If no filename is given, the table will be
							saved to the file '<mod>\pos\mapname.pos'

	Sound:
	======
	admin_possound [flag]				Teleporting sound flag.
      							Sound can be played when a player saves his
      							position or is being teleported by saying
      							'saveme' or 'posme'. For this to work, you
      							have to have a file named 'possound.cfg' in
      							your <mod> folder (see the file coming with
      							this package). But for the players hearing
      							the sound, they must have the corresponding
      							sound files on there '<mod>\sound\misc' folder.

	Others:
	=======
	admin_poscopy <#user1> <#user2>			Copy user1 saved position to user2.
							User2 have to say 'posme' to be teleported
							to this position.

	admin_possend <#user1> <#user2> [Zshift]	Send directly user1 to the current user2
							position.
							(on his head actually because Zshift by
							default is 96).

	(NOTE: 'flag' here mean the strings 'on', 'off', '0' or '1').

Map change:
==========
If a table already exists for the current map, it will be  loaded  automatically at map change.
By default, teleportation is enabled for common users.
If you want to disable the teleportation for certain maps, go in your server folder and edit/create
the file maps\<mapname>.cfg
In the end of file, add the following line:

teleport_allowed 0

The say commands will then be disabled.


For comments or suggestions, please email me at Amiga5707@hotmail.com

Enjoy!!