
                             JailBreak v2.0
                              for Quake2!
	
	JailBreak 2.0 Coded by Dave 'anarchy' Dynerman (anarchy@planetquake.com)

       Original JailBreak coding, and JailBreak concept by Dave 'WhiteNoise' Wallin
			(dwallin@planetquake.com)
		

         **SEND ALL QUESTIONS AND BUG REPORTS TO deathpain@hexenworld.com**

0. Installing & Running

	JailBreak 2.0 is a COMPLETE CLIENT REPLACEMENT. That means you can delete your 
entire \quake2\jail directory, and use the JailBreak 2.0 client files instead. The zip
file contains the correct directory tree to install, you should unzip WITH FOLDERS to your
\quake2 directory. This will place all files in their appropriate places. You can then run
JailBreak by executing:

quake2.exe +set game "jail" +connect xxx.xxx.xxx.xxx

Where xxx.xxx.xxx.xxx is the server ip number. You can also use one of the many server 
browsing programs, such as GameSpy 3D (http://www.gamespy.com)


1. What Is Jailbreak?

        Jailbreak is a deathmatch mod in the tradition of CTF. There are two
teams, red and blue. Each team has a base, and in his base is a Jail. When
you kill an enemy, he goes to your Jail. Likewise, when you are killed you
will go to their Jail. Once you have team mates in Jail, you can free them
by penetrating the enemy's base and hitting the switch to open the Jail
doors. Other things of note: When your entire team is in Jail, you are all
automatically EXECUTED and each member of the other team's score increases
by the number of players on your team. You will then be spawned out of Jail.
Getting Executed is bad, so try not to let it happen by freeing your teammates.
Fraglimit is measured against your TEAM score, not indidual score. Note that
you also recieve points (frags) for freeing people from jail.

2. New screen elements

Your team picture is included in the upper left hand corner. Look at this
if you are unsure what team you are on. Next to it, on the right, will be
your team's current score. If someone on your team is in Jail, then bars
will appear overtop of your team picture. This means you should go rescue
them.

	The other team's pic and score is displayed as well. Your team/score
will always be displayed in the upper left, and the opponent's on the right.
The number of people in jail is also displayed for each team. This number
appears on the outside of icon (the side facing the edge of the screen).

3. Additional Controls

        You can use "/cmd changeteam" at the console to change teams if things
look a little unfair. However, I recommend that you do not abuse this feature
because that just sucks and people will hate you.
        Notice! If you try to change teams faster than 5 seconds,
you will get gibbed! Your frags are also reset everytime you change teams
so doing it is just plain dumb. It was designed to help if the teams should
somehow get unbalanced, not for you to cheat.
        A feature for server operators - The file maps.txt is included and
placed in your Quake2 directory. You can add other map names to this file
and they will get randomly loaded. The max number of map names is somewhere
around 16, so try not to go past that. Note that the map name does not
include extension or path. Players in the game can get a list of maps by doing
"/cmd showmaps". Note that if a map already has an exit, maps.txt will be
ignored, and the map defined exit will be used.
        To fire the turrets you will need to bind a key to "+use". Spacebar
works well. To get off a turret, hit jump. It is easiest to get off if the
turret is leveled or pointed slightly up.
        You can use "cmd ident" to find out who someone is (their name). Just
point at them.
        You will now be transported back to your base as soon as your
team succesfully executes the other team. This is done to stop one team from
camping out in the other team's base and ruining the game. Servers can
optionally toggle this off if they so desire. See the server ops section.
        Scoring: 1 frag for killing someone
                 1 frag escaping from jail
                 EACH player on your team gets as many frags as their
                         are players on the other team for an Execution.
                 -10 frags for walking back into either jail
        OTHER NOTES: You lose all your frags when you disconnect. If you are
using this to try to get out of jail, you are making it impossible for your
team to win. This practice is highly looked down upon and practically everyone
regards it as lame. This is cheating.

4. Clan Competition Mode
	
	If a server is running clan competition mode, you will be able to use this. It
works much like QWRing did for QuakeWorld. First, you and your buddies set a team name
a good choice is a clan abbriviation, 8 char limit. For instance, if I was in clan Evil
Incarnate, I would pull down the console, and type team Ei - as would the rest of my clan,
the opposing clan does the same. Then each person has to enter a command - ready - in the
console. When all players are ready, the match will begin. You can have only two teams, so
if 2 teams are formed, but some people did not issue their ready command, they will have 
to set their team to one of the existing ones, and enter ready.

5. For map makers..

        There are a few things to know if you intend to make a map. First
are the special spawn spots. Here is a list of special spawns:

1 = red, 2 = blue

info_team1_start        // Spots where team1 starts
info_team2_start        // spots where team2 starts
info_team1_jail         // Places where team1 members appear in jail
info_team2_jail         // same for team2

For the jails, I recommend an enclosed area with a door triggerable with a
switch. You can use the trigger_speaker to play a sound effect when the
button is hit like I have in my map. You will also need to put a trigger_jail
entity in front of the jail door. When a player touches this, the flag that says
whether he is in jail is set to false (in other words, it takes him out of
jail).. So you need that. You will also need to give it the 'nodraw' flag.

Another thing of note: for the switches which free the prisoners, you must
set the spawnflags according to which team you are freeing. For example,
if a switch is freeing team 1 (red team), then set the spawnflags to 1. Like
wise, if you are freeing team 2 (blue) set it to 2. This prevents teams from
opening their own bases.

These are the new sounds used in jailbeak:

jail/jailbrk1.wav       - "prison break in red base"
jail/jailbrk2.wav       - "prison break in blue base"
jail/jailbrk3.wav       - easy listening music for the poor souls waiting in jail.
jail/jailbrk4.wav       - More easy listening music, composed by Nate Kozloski of Team Reaction

To play a sound, use target_speaker... Go find a tutorial somewhere on using
this. It's pretty easy, but there are a bunch of options. Jailbrk3 is played
as an ambient sound ("attenuation" "3").

I will be releasing the source for my map to aid others in making JailBreak
maps.

NEW: You must put a trigger_jail with spawnflags = 64 inside the jail. This
will tell Jailbreak that a person has re-entered the jail. Stick it near the
door where people must touch it.

NEW: The Rust site can now be found on planetquake! This site is excellent if
you need a tutorial of any kind (for editing maps). I believe the address
is www.planetquake.com/rust/

NEW: Turrets can now be made multiple barreled - all you have to do is add
another "info_notnull" as a target. It will shoot from a random turret each
time you fire..

6. For server ops

If you are running a jailbreak server, you must put a fraglimit, since this
is the point of the whole game. A good fraglimit is 100 (for a 4v4 game).
Bigger games deserve higher fraglimits.

Also, be sure to see the above section in 'additional controls' which talks
about the maps.txt file. With that you can easy add new maps to your server.

Also, dmflag 4096 was added. Setting this flag will turn OFF teleporting teams
back to their own base after an execution. In order to set this flag you will
need to take your current dmflag value, whip out your calculator, and add 4096
to it. You can set that at the console.. "DMFLAGS 4096" or whatever. It's not
recommended that you do this, but I made an option for this for completeness.

It is also recommended that you run a server with FORCE_RESPAWN, and
SPAWNFARTHEST on.

7. Credits

2.0 Coding by Dave Dynerman (anarchy)
Coding, Levels, sound, some art, and concept by Dave Wallin (White Noise)

Special thanks to Danny Berlin for all his help and support. You rock Dan! ;)
Thanks to all the people in #staff who helped me test this, and had a definate
        impact on the final product. You know who you are.
Thanks to the makers of Loki's Minion's CTF for the awesome player skins
        (and LM CTF!)
Thanks to Majestyk for doing the FAQ
Tin again for the new player skins!
Extreme thanks to Ridah for releasing his player controlled Turret code, and
        for his work in general in the Quake community.
Also thanks to DeathPain who did the web page, and Tin who made the Jailbreak
        logo (the Jailbreak site is at www.planetquake.com/rxn/jail/)
Whoever the musician is who wrote "It's only just begun" and the respective
        music company.. I downloaded the midi off a music page and I don't
        really know who it is, so I can't thank them properly. This is the
        song played in the jails. NEW: The musician is Carpenter but I don't
        anything else.
Also, thanks to Planetquake for all the wonderful services they've provided
        me and other similiar Quake fanatics with. ;)
Thanks to TechnoMage for the intro cinematic, and Nate Kozloski for the sounds
        accompanying it.
Thanks to David 'Zoid' Kirsch for some CTF textures and DLL code.

**Special thanks to the author of the map aasoap (map1) You know who you are, and
you rock! :)

Maps:

Cool places to go:

www.planetquake.com/rust/
        Awesome level editing site - they have tons of tutorials. I consulted
        them myself when trying to figure out the turrets.
www.planetquake.com
        For your every Quake related need
impact.frag.com/
        Look for the Morbo model here, as well as the Eraser bot and other cool things
        from Ridah, Rowan Crawford and the other cool impact people.
www.frag.com/deconstruct
        Deconstruct, a modelling and art site from the dude that did the Waste model
www.gamespy.com
        Get Gamespy here! BUY IT!!!~~! (shameless plug)
inside3d.com/skinning
        Spawn22 and Tigger have a skinning page here

A word from the author:

One final request - I don't want to see a million versions of Jailbreak out
there.. Like Bob's Jailbreak, or Billy's Jailbreak.. Please respect my wishes,
and my idea. You are allowed (of course) to do levels. If you do a level, and
it's REALLY good, send it to me and I'll consider putting it in the next pak.

You can email me at anarchy@planetquake.com
You can email WhiteNoiz (modgod) at dwallin@planetquake.com
Please direct any questions to Deathpain, at deathpain@hexenworld.com
The JailBreak page is: www.planetquake.com/rxn/jail/
Please stop by for the latest updates and news.
