Post: #1

Hello everyone,

This script is about a Prison War Event and what it basically consists in is:

- 2 teams fight against each other
- Upon being "killed" by a member of the opposite team, a player is jailed instead of dying, and its killer receives a Key to the Prison Cell where he is imprisoned in
- In order to release an imprisoned teammate, players from his team must kill the member from the opposite team carrying its Prison Cell Door Key, to retrieve that same Key and then double-click the imprisoned player Prison Cell Door
- It's up to you how to appoint the winner. For example, first team to jail every player from the other team, or team with less players jailed after X time, etc.

Lets see an example of what's explained above:

- Player A kills Player B
- Player A is teleported alive to a Prison Cell and Player B is given its Prison Cell Door Key
- Player C kills Player B and retrieves the Prison Cell Door Key where Player A is imprisoned in
- Additionally, Player B is jailed and Player C is given a Key to his Prison Cell Door
- Player C double-clicks at the Prison Cell Door where Player A is imprisoned in and Player A is teleported to Player C location

How to set up the event and some instructions (This can also be found in the script):

1) Add 1 "i_prison_war_positioner", check its UID with .info and then replace the script DEFNAME with it so the event TAG's are properly stored. DON'T delete the stone after replacing the DEFNAME UID or the script won't work.
Double-clicking the stone will open a dialog where you will be able to enter up to 32 Prison Cells Locations and 32 Prison Cells Doors UID's. (The dialog has 4 pages)
You don't need to fill in every Prison Cell Location/Prison Cell Door UID, nor need to enter them by any order, but you MUST be sure that a Prison Cell Location matchs that same Prison Cell Door UID.
Once you are done filling in all the Prison Cells Locations and Prison Cells Doors UID's you want, you can just right-click to close the dialog. Changes will be saved as you do them.
Clicking in "Reset Event" will reset the stone, release any prisioner, etc. This won't delete your saved Prison Cells Locations and Prison Cells Doors UID's.
Clicking in "Restore Defaults" however, will do the same as "Reset Event" plus cleaning up your saved Prison Cells Locations and Prison Cells Doors UID's.

2) Add 1 "i_prison_war_gate_entry1" and 1 "i_prison_war_gate_entry2", one for each Team to use.
Set the MOREP for each gate created to the respective team base location and make sure players use them to get into the arena.
Use the "i_prison_war_gate_exit" to clean up player tags, events and keys once the event is over.
Set its MOREP to wherever you want players to be teleported to once they step on it.

3) Killing a player will teleport him to a Prison Cell and give you its Prison Cell Door Key.
Players from the player team you have just killed then have to kill you in order to retrieve the Prison Cell Door Key and free their teammate.
If every Prison Cell already has a player, the player will just normally die instead of being jailed. You can change this behaviour under @DEATH to stone the player or anything else you want.

4) Add 32 (Or as many as you want, but not more than 32) "i_prison_war_door" (one for each Prison Cell)
Players must double-click the Prison Cell Door to free their teammate inside it
To free a teammate players must be hold a Key to their cell

5) Players may talk with their team members by using .pw <message>
Staff members will also read those messages

Additional notes:

- There are several warnings when a player dies and other gets his prison cell door key, like emotes and sysmessages
- Prison Cells Door Keys can not be moved by players
- If you kill someone, ALL the Prison Cells Door Keys that player is holding will be transferred to you, even the ones that player had retrieved to free a teammate of his
- Single-clicking a Prison Cell Door will tell you who imprisoned that player, so you know who you have to focus/kill in order to free that player
- The arena layout is totally up to you. Just make sure you have individual cells locked with the doors in the script
- If you comment the line 774, after players have been jailed 32 times (not necessary 32 but the number of jails you set up), they will just normally die. For example, if you have 2 teams of 8 players each and have only 4 jails, once 4 players have been jailed the event will just become a normal team pvp, because players will just start dying. Can also be another mode for this event, like if players had "Lifes".


I don't think I'm forgetting anything, but since its an event there's probably missing information. Just ask if you have any doubt. Ill try to clear up some text later.