[htcarnage]

Description:
This plugin provides a convenient way for players to teleport to one another. When a teleport request is made, a menu is displayed to the target player that will allow them to:

Accept
Deny
Block the individual player
Block ALL players
Accept all future requests

After a request is made, a client enters a cool down period in which they can not request any more teleports until the period has passed.

The plugin makes use of admin overrides that will allow admins with a certain flags to bypass client authorization and bypass the cool down period. Admins are able to forcefully bring a player to them, and players can teleport themselves back to their previous location.

As of version 1.3.6, admins with ADMFLAG_KICK authorization can ban players from making goto requests.

How is this different from other teleport plugins?
This plugin offers simple teleport access for non-admins, and also implements an authorization system to prevent unwanted teleports. Has translation support. Allows admins to ban players from using the plugin.

Requirements:
SDKTools
A noblock plugin of your choice



PLAYER COMMANDS:
sm_goto <player>
sm_unblock <player|all>
sm_tpb
sm_goback

ADMIN COMMANDS:
By default, these commands are tied to ADMFLAG_KICK.
sm_bring <player>
sm_goto_ban <player>
sm_goto_unban <player>
sm_goto_listbans



Database Setup
GoTo bans are stored using SQLITE.
Add the following to addons/sourcemod/configs/databases.cfg

	"goto_bans"
	{
		"driver"			"sqlite"
		"host"				"localhost"
		"database"			"goto_bans"
	}

CVars:
gt_cooldowntime 60.0 ||| Time between a player's use of the goto command.
gt_target_opposite_team 1 ||| Allow clients to target players of the opposite team.
gt_teleport_back_limit 0 ||| Prevent users from teleporting back to their saved location multiple times.

The plugin auto-creates a config in cfg/sourcemod/goto.cfg with the above cvars for easy access.



This plugin uses Sourcemod's built in admin override system to change command access:

How to change command access:
Example addons/sourcemod/configs/admin_overrides.cfg

Overrides
{
    "sm_goto_cooldown_bypass"    "c"
    "sm_goto_auth_bypass"        "z"
    "sm_tpb"                ""
    "sm_goback"            ""
    "sm_bring"                ""
    "sm_goto"                ""
}

The above would restrict the cooldown period bypass to admins with "c" flag, and would allow admins with "z" flag to bypass authorization completely. All other commands would be available to regular players. To restrict them, simply add a flag between the quotes.


Changelog:

Spoiler

1.0.0: Initial Release.
1.1.0: -Allow users to block TP requests from other users, or all users.
       -Allow admins to bring clients to them without authorization. Did not make available to clients because its functionality is so similar to sm_goto
       -Fixed an Invalid Handle error
1.2.0: -Actually fixed the Invalid Handle error...
       -Added function to allow users to ACCEPT all TP requests without displaying a menu
       -Cleaned up code a bit
1.3.0: -Added command to go back to previous location. (sm_tpb or sm_goback)
1.3.1: -Cvar to prevent users from teleporting to their previous location more than once. Prevents its usage as a checkpoint.
1.3.2: -Code cleanup.
1.3.3: -Added Cvar to make the plugin Admin Only
1.3.4: -Plugin now uses override system to change command access
1.3.5: -Translation support
1.4.0: -Added ban functionality, code cleanup. Moved validation to separate .sp file

Credits:
johan123jo for helping me with the teleport authorization menu
11530 for his advice on code cleanup

Servers using this plugin


766