KZ Necro Cup v2.0

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
KZ Necro Cup v2.0
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

A KZ Cup is a timed race between two or more players. Participants must simultaneously race through a map; the player who is farthest when the cup time expires is declared the winner.

This plugin facilitates running automated cups on public servers. A cup will only affect players who choose to participate; other players can use the server normally while a cup is in progress.

-=-=-=-=-=-=-=-=-=-=
Public Cups:
-=-=-=-=-=-=-=-=-=-=
If a cup is not running then any player can start one with the /votecup command. Other players are then given a short period of time to join the cup using the /joincup command. When the join period expires the cup participants are placed at the starting position. After a start countdown, players are released and the race begins.

During the race, afk participants are automatically moved back to the start. Participants who attempt to cheat using 'hook' or 'gocheck' type commands are automatically removed from the cup. There must be at least two players for a cup; if the number of participants drops below this number the cup will be automatically canceled.

The end countdown starts after the cup time expires. A winner is determined and recorded to the public scoreboard. A short tie-breaker round will be held in the event of a tie.

-=-=-=-=-=-=-=-=-=-=
Official Cups:
-=-=-=-=-=-=-=-=-=-=
Admin can officialize the results from a previous cup and record the score to the official scoreboard. An official cup is run like a public cup except an admin is present to observe the race and verify the result.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
IV. Public Commands
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Command: say /cup
Saying /cup will display useful information about the cup (cup time remaining, timeleft until cup start, etc).

Command: say /cuphelp
Saying /cuphelp will display a page explaining what a kz cup is and how to use the public commands.

Command: say /cupwho
Saying /cupwho will display a roster of players who are either currently competing in a cup or have joined the upcoming cup.

Command: say /votecup
Saying /cupvote will start a new cup if one is not already in progress and will add you to the cup if currently in the join phase. This command has no effect during a race; players will be told to wait for the next cup.

Command: say /joincup
Saying /joincup has the same effect as /votecup.

Command: say /cupwins
Saying /cupwins will display the number of cup wins you have. These wins are only registered if a cup official (admin) records the results.

Command: say /pubcupwins
Saying /pubcupwins will display the number of cup wins you have. These are wins automatically recorded at the end of every cup.

Command: say /cup15
Saying /cup15 will display the 15 players with the most cup wins participating in official cups.

Command: say /pubcup15
Saying /pubcup15 will display the 15 players with the most cup wins participating in public cups.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
V. Admin Commands
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Access Levels: Set the value of ADMIN_CUP_RACE, ADMIN_CUP_MARKERS, and
ADMIN_CUP_SCORES at the top of constants declarations.

Default Values:
ADMIN_CUP_RACE ~ ADMIN_CVARS
ADMIN_CUP_MARKERS ~ ADMIN_RCON
ADMIN_CUP_SCORES ~ ADMIN_IMMUNITY

Command: say /cupmenu
Access Level: ADMIN_CUP_RACE
Saying /cupmenu will display a menu of admin cup commands.

Command: say /startcup
Access Level: ADMIN_CUP_RACE
Saying /startcup will start a new cup if one is not already started and allow players to join. The admin who runs this command will not be added to the cup. Issue this command during the join phase to skip immediately to the race.

Command: say /endcup
Access Level: ADMIN_CUP_RACE
Saying /endcup will immediately bring a running cup to a close. You can also issue this command during the join phase to cancel a cup before the race begins.

Command: say /restartcup
Access Level: ADMIN_CUP_RACE
Saying /restartcup will restart a race that is currently in progress. Players will be teleported back to the start position and the race will begin again.

Command: say /resetcup
Access Level: ADMIN_CUP_RACE
Saying /resetcup will reset the cup plugin to its default state. Use this command if something unexpected or bad happens for some reason.

Command: say /recordcup
Access Level: ADMIN_CUP_SCORES
Saying /recordcup will officialize the results of the last race. The cup winner's score will be incremented and recorded to the scores file. Run this command after a cup has ended; running it during a cup will officialize results from the previous race. This command can be used only once per cup.

Command: say /unrecordcup
Access Level: ADMIN_CUP_SCORES
Saying /unrecordcup will reverse a previously issued /recordcup command. The cup winner's score will be reverted to its previous value. This command can be issued only once per cup where results were made official.

Command: say /clearcup15
Access Level: ADMIN_CUP_SCORES
Saying /clearcup15 will clear the official cup15 scores. A backup of the scoreboard is created before scores are cleared.

Command: say /clearpub15
Access Level: ADMIN_CUP_SCORES
Saying /clearpub15 will clear the public cup15 scores. A backup of the scoreboard is created before scores are cleared.

Command: say /loadcupmarkers
Access Level: ADMIN_CUP_MARKERS
Saying /loadcupmarkers will load the current map's cup markers from file.

Command: say /savecupmarkers
Access Level: ADMIN_CUP_MARKERS
Saying /savecupmarkers will save the currently loaded cup markers to file. Issue this command after creating new cup markers.

Command: say /showcupmarkers
Access Level: ADMIN_CUP_MARKERS
Saying /showcupmarkers will make the cup markers visible. Cup markers will only be visible after issuing this command or when creating new markers.

Command: say /hidecupmarkers
Access Level: ADMIN_CUP_MARKERS
Saying /hidecupmarkers will remove the cup markers from view. Cup markers are hidden by default but become visible when creating new markers or after issuing /showcupmarkers.

Command: cup_setmarker
Access Level: ADMIN_CUP_MARKERS
Console command cup_setmarker will place a marker at your current position.

Command: cup_removemarker
Access Level: ADMIN_CUP_MARKERS
Console command cup_removemarker will remove the last cup marker created (cup marker with largest id).

Command: cup_nearestmarker
Access Level: ADMIN_CUP_RACE
Console command cup_nearestmarker will display the id of the nearest marker. Use this command to lookup marker ids.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
CVARs:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

cvar: cup_time (180)
The value of this cvar sets the time a cup match will last (in seconds). Set a unique value for each map.

cvar: cup_jointime (120)
This value of this cvar sets the period of time players can join a cup after one has been started (in seconds).

cvar: cup_advertise_interval (30)
The value of this cvar sets the period of time between each cup advertisement (in seconds). A cup will advertise itself during the join phase.

cvar: cup_timeleft_interval (60)
The value of this cvar determines how often the remaining time of a running cup is announced.

cvar: cup_startcount (10)
The value of this cvar determines the length of the start countdown. There will be a verbal countdown for all values less than equal 10.

cvar: cup_endcount (10)
The value of this cvar determines the length of the end countdown. There will be a verbal countdown for all values less than equal 10.

cvar: cup_public (1)
The value of this cvar determines if the public can start a cup using /votecup. A value of 1 opens cups to the public, a value of 0 restricts starting new cups for admin.

cvar: cup_singleplayer (0) (DEBUG: compile with INCLUDE_DEBUG 1)
The value of this cvar determines if single-player cups are permitted. A value of 1 allows single-player cups, a value of 0 requires at least 2 players or the cup will be canceled. This is useful for testing and debugging; in practice there is no reason to allow single player races.

cvar: cup_tiedistance (50)
The value of this cvar determines how many cup markers must lay ahead of tied players in order for them to start the tie-breaker at their current position. If there are less than this number of markers then tied players will be started at the first marker.

cvar: cup_tietime (60)
The value of this cvar determines how long a tie-breaker round will last (in seconds).

cvar: cup_minmarkers (15)
The value of this cvar determines the minimum number of markers that must be set before a cup can be started.

cvar: cup_checkafk (1)
The value of this cvar determines if afk participants are moved back to the start position. A value of 1 will check for afks, a value of 0 turns afk checking off.

cvar: cup_afktime (8)
The value of this cvar determines how long a cup participant can remain afk before being transported back to the start.

cvar: cup_triggerend (15)
The value of this cvar should be a valid cup marker id. Set a unique value for each map. The first player to reach this marker will trigger the end of the cup. Players must pass within 32 units of the marker; choose cup markers that are unavoidable and at least cup_endcount seconds from the last marker.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Special thanks to
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

* Necro for coding and donating the prototype (v1) version.
* dropsys for coming up with the idea, defining requirements, and creating the prepackaged cup data.
* DKrAyZie for providing his server for testing and debugging.
* gangien for the occasional advice and feedback.
* and the many others who participated in testing or offered suggestions...

This plugin was created for KZ communities everywhere.
This plugin is especially dedicated to the great community at KZ North America (http://www.kz-na.com).

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Bug Fixes, Feature Requests, and Support
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Send bug fixes and other requests to trooper at [email protected]. When submitting bug reports please be as detailed as possible. If I can't reproduce the bug it won't get fixed.

Are you interested in multilingual support? Contact trooper if you would like to translate messages into your native language.

-=-=-=-=-=-=-=-=-=-=-

We support and promote the modification of this plugin to everyone. Do with it what you please. There will be updated versions soon.

-=-=-=-=-=-=-=-=-=-=-
I will be posting more configs later on today or tomorrow of maps already setup with cup markers and configs for the cup_triggerend. Im doing this for all of you lazy people who want to install and go.

-=-=-=-=-=-=-=-=-=-=-

Here is the link to the thread at allied mods.
http://forums.alliedmods.net/showthread.php?t=84791

LOL AWESOME! :o

dropsys: Nice work! GJ indead! :)

Nice for releasing this! GJ! *thumbs up*

Wow pretty nice, already saw it and played in it in phoogi's
GJ on releasing it.
Adidasd from what I saw in the server the marker is kinda of a checkpoint to meassure your advance in the map.

Ok to clear some things up real quick.

1. The freezing issue at the end of the round has been resolved. the link should get updated itself. if it hasnt already, I will edit the post and say it is.

2. Cup markers are used to see how far a player is in the map. Represented by a model can soda so you can see where you just placed your marker.

3. /recordcup only works IF you have "a" flag (immunity) with amxx. we set it this way so if you have admins on your server you dont want having access to it. this is the flag to have.

4. Stewie: It displays 1st-3rd. Glow colors are represented as follows: 1st-Blue, 2nd-Red, 3rd-White. All players will glow yellow at beginning and during the cup. This plugin is made to work with kz_necromods /glow. You can alter this if needed to work with your servers glow. freezing should also be resolved now. tie-breakers were the problem. Ill keep you all posted as it gets updated.

5. rhoiswar: yes this is the one trooper was working on. it wouldnt be here if it werent for him. all thanks goes to him and necro for doing the dirty work

this is omfg uber .

sma/zip link doesnt work 4 me, i would like to have a look on the code to help im proving it. didnt test the amxx link cuz i dont care :P

I updated the first post with just the link to the thread at allied mods.

SchlumpF: you can modify this if you want. We are already receiving some help from a pro coder from Allied Mods. But as I said in the earlier post. We support and promote any modifications done to this plugin. It is free for all. Dont try to act like your going to make it better than it already is........

Originally posted by dropsys

Participants who attempt to cheat using 'hook' or 'gocheck' type commands are automatically removed from the cup.