Translocators

REQUIREMENTS

• Eventscripts 1.5.0 build 171 (or newer)
• ES_Tools .417 (or newer)
• Auth provider

Note again: this script needs you to have the latest beta version of EventScripts (as of 23th June 2007) and ES_Tools for it to work.

WHAT?
This script addon provides your Source server (should work in any Source game) with translocators the players can use.

A Translocator is a personal device that can be thrown and the player can later teleport himself to it. These translocators also have built-in camera which the player can use!

HOW?
The players need to bind a few keys to be able to use the translocator. The console commands that should be bound are:

• trans_throw - throw the translocator or retrieve it back
• trans_use - teleport where the translocator currently is
• trans_cam - switch between using the spy camera or player's own view

Players can type !trhelp to chat anytime to see the list of console commands. Admins can use !trans to configure some parts of the script on the fly.

!trans 1 - enables the script functionality !trans 0 - disables the script functionality !trans del - deletes somebody from special list - can be userid, steamid or partial user name !trans set - sets someone special colors - can be userid, steamid or partial user name - is the color of the translocator when this user is playing in team 2 (in CS: Terrorist) - is the color of the translocator when this user is playing in team 3 (in CS: Counter-T)

For example if I was the server admin and I wanted myself to have black translocators when playing in T side and golden translocators when playing in CT side, I'd write this:

!trans set GODJonez 0 0 0 255 255 32

The custom colors will automatically be saved on round_end or when the script is unloaded.

COOL!
The translocators are real physics objects reacting to players, world and other objects. Bullets will go through their energic nature, but grenades have enough firepower to make them fly.

There are some effects on teleporting, nothing fancy but still cool. I may need some sounds too, any suggestions of the built-in sounds in the game? (I don't want to steal them from UT ;))

What if you teleport somewhere where the player cannot really be? How about inside walls? Yes that's possible, but this script has fairly effective means to detect being stuck after teleportation and will undo your action. This also applies if you somehow manage to teleport yourself outside the game world (it happened to me a few times when testing in some maps).

Now you are wondering if the players could get stuck by teleporting inside each other. That won't happen so easily. If you try to teleport inside your teammate and friendly fire is off, you will just get your translocator back. However, if friendly fire is on or you are teleporting inside your enemy player, you kill them! TELEFRAG! Of course you as a player are rewarded from the kill.

AUTH?
This script has two permissions that can be configured in your Auth provider:

• use_translocator - players with this permission can request help and use the console commands (def. #known)
• admin_translocator - players with this permission can use !trans say command (def. #admin)

EVENTS?
For interaction with other scripts, this addon also fires it's own custom events. This makes it possible to for example include Telefrags to Quake sounds.

The events and their variables are here:

"translocator_throw" // when user thows translocator { "userid" // user throwing the translocator "trans_index" // entity index of the translocator "trans_name" // entity targetname of the translocator } "translocator_retrieve" // when user calls the translocator back { "userid" // user retrieving the translocator } "translocator_camera" // starts or stops using the camera { "userid" // user using the camera "trans_index" // entity index of the translocator "trans_active" // 1 if the camera is active } "translocator_teleport" // when player uses translocator to teleport { "userid" // user teleporting "trans_from" // vector where player teleported from "trans_to" // vector where player teleported to } "translocator_telefrag" // when player telefrags another player { "userid" // the VICTIM userid "attacker" // the ATTACKER userid }

All the events also have normal user-specific event variables such as es_steamid, es_username etc.

BOTS?
This script has experimental (not tested) support for bots using translocator also. To use this feature you need to load the subscript bots yourself after the main script is loaded:

es_load translocator/bots

IMPORTANT!
This script makes use of Auth provider. You need to have one loaded and configured before loading this script addon. For more info about Auth, see www.eventscripts.com/Authorization_FAQ

An example of how your autoexec.cfg could contain:

es_load examples/auth/basic_auth BASIC_AUTH_ADMIN_LIST "STEAM_ID_LAN;"   es_load translocator es_load translocator/bots

If you do not use bots or don't want them to use translocators, you don't need the second es_load command.