Keep Away

[LouMan]

keepaway plugin

Author: LouMan
Description: See below.
Min Version: Latest CVS 2.0 branch code (to compile), bzfs 2.0.8

** NOTE: the plugin is committed to CVS; can be obtained there.

Credit to JeffM2501 for custom map object code (from flagStay plugin) and Thumper for the brilliant idea

The plugin will create a Keep Away game mode in which a player/team must hold a "Keep Away" flag (defined in map file) for a defined amount of time; if held long enough all other teams (or players) are killed.

There are 2 modes of play available:

1) Teamplay: if a player from a team holds the Keep Away flag long enough, all other teams (except his/hers) are killed. Score credits are given to the team, but not given to player that kept the flag. If a rogue manages to hold the Keep Away flag long enough in this mode, all players (except him/her) are killed and he/she gets individual score credit for all of the kills.

2) No teamplay: for this mode it is recommended to set up a map with only rogue players allowed. If a player holds the Keep Away flag long enough, all other players are killed and score credit is given to the player who held the Keep Away flag for all of the kills. Obviously, if teams are allowed in this mode, it would result in repeated team kills - no fun. Basically this is a free-for-all mode for Keep Away.

Plugin features/notes:

* Server messaging for Keep Away flag is free (which one to hold), Keep Away flag held (by whom and how long they have to hold it), regular countdown warnings while someone is holding the Keep Away Flag (every minute and 30, 20 & 10 seconds until flag is held long enough), and successful Keep Away announcements. Long callsigns are truncated in server messages.

* Players cannot pause while holding Keep Away flag - if they try the flag will be taken away with a warning message not to do so.

* Keep Away will be disabled until there are 2 or more teams, 2 or more rogue players, or at least 1 rogue player and 1 or more team player(s).

* It is highly recommended to add exactly 1 flag to the map file for each type of flag that might be considered the Keep Away flag. Duplicate Keep Away flags has not been tested.

* There is an autotime function (optional) that will reduce the time to hold the Keep Away flag, based on the number of players in the game. With this option enabled, the time is reduced a certain percentage (default is 3%) with every additional player (after 2) to a certain minimum percentage (defaut is 50%) of the original specified time to hold. This means that (with default settings) the time to hold would not be affected for 2 players, but would be reduced by 3% for 3 players, 6% for 4 players and so on. The minimum 50% of the original time to hold would be reached at about 19 players and would remain at 50%, no matter how many additional players were to join after that.

* Local sounds for dropped Keep Away flag, team grab, successful Keep Away, etc. are incorporated into plugin. In general, these sounds correspond to standard CTF sounds.

* There is a "/kas <message>" command available to all players to send a message to person holding the Keep Away flag.

* There is a "/kaf" command available to all players that will return the current Keep Away flag to find.

-------------------------------------------------------------------------------------

The parameters of the Keep Away (keepaway) map definition are follows:


teamplay

Optional. This will enable the teamplay mode of Keep Away (see above). If not included, teamplay is disabled and it becomes as basic free for all Keep Away mode.


holdtime <seconds>

Optional. This defines the time (in seconds) required to hold the Keep Away flag before a player is declared winner and other teams/players are zapped. If not included, the default setting is 120 seconds (2 minutes). The limits of this setting are controlled to a minimum of 1 second and a maximum of 7200 seconds.


autotime <multiplier> <minimum multiplier>

Optional. This will enable the automatic time reduction feature of the plugin that will reduce the time to hold the Keep Away flag, based on the number of players in the game (see description above). The multiplier field will set the hold time reduction percentage per new player. The minimum multiplier field will set the minimum hold time reduction percentage. If these fields are left blank, the default multiplier = 3% and the default minimum multiplier = 50%. The multiplier fields should be between 1 and 99 (percent).


forcedflags

Optional. This will force sequential Keep Away flag selection based on flags defined in flag parameter (below). If a player is holding the next flag to be used as Keep Away flag, it is taken away from him/her with a message apologizing for the take ("Sorry, server needs your flag for Keep Away :/"). If this parameter is not included, the plugin will take away the winner's flag and search for the next available Keep Away flag that is not held. If it cannot find one, it will repeat the Keep Away flag that was just used.


keepawayflags <flag type> <flag type> <flag type> <flag type> <flag type>...

Required. This will define which flags the plugin will cycle through as Keep Away flags. At least one is required. If no flags are defined, the plugin will be effectively disabled. Remember, the plugin has not been tested for duplicate flags on the map, so it is highly recommended to explicitly define only 1 flag per Keep Away flag type to be present on map.


nosound

Optional. This will disable sounds associated with Keep Away plugin (some clients may have issues with this feature).

-------------------------------------------------------------------------------------

Examples of map (.bzw) entries:


keepaway
holdtime 90
autotime 2 40
keepawayflags SB G TH MG GM L
forcedflags
teamplay
end

This would set up a Keep Away game using Super Bullet, Genocide, Thief, Machine Gun, Guided Missile and Laser flags for Keep Away flags. Teamplay would be enabled and the initial required time to hold the Keep Away flag would be 90 seconds (1.5 minutes). Time to hold would automatically adjust downward with new players; 2% per new player after 2, to a minimum of 40% of the original time to hold (36 seconds).


keepaway
holdtime 60
keepawayflags IB PZ US RO
teamplay
nosound
end

This would set up a Keep Away game using Invisible Bullet, Phantom Zone, Useless and Reverse Only flags for Keep Away flags. Teamplay would be enabled and the initial required time to hold the Keep Away flag would be 60 seconds (1 minute). Time to hold would not automatically adjust downward with new players - it would remain at 60 seconds. The sounds associated with Keep Away would be disabled.


Obviously, the plugin must be loaded to the server at startup, or it will not recoginize these map parameters.

-------------------------------------------------------------------------------------

There are two commands available to all players with the plugin:

"kas <message>" - this will send message to the player holding the Keep Away flag.
"kaf" - this will return the current Keep Away flag to be found & who holds it.

There are several administrator commands available with the plugin:

"kaon" - this will turn Keep Away mode on, if turned off previously.
"kaoff" - this will turn Keep Away mode off for normal gameplay.
"katimemult" - this will set auto time multiplier (per new player).
"katimemultmin" - this will set minimum auto time multiplier.
"kaautotimeon" - this will enable the autotime function.
"kaautotimeoff" - this will disable the autotime funtion.
"katime <seconds>" - this will change Keep Away hold time 1 -> 7200 seconds.
"kastatus" - this will return the status of the plugin modes, times, etc.
"kaffon" - this will turn on forced flags.
"kaffoff" - this will turn off forced flags.
"kaf+" - advance to next Keep Away flag.
"kasoundon" - enables Keep Away sounds.
"kasoundoff" - disables Keep Away sounds.

-------------------------------------------------------------------------------------

Please report any bugs or issues with this plugin to LouMan, and good luck.

[Saber]

It looks like KOTH but the zone is now a flag and you can move with it.

It's nice Is it hosted anywhere?

[LouMan]

Look for LouMan's Keep Away in the server list

[Davy Jones]

LouMan
Awesome?

Nice plug-in i enjoyed it when i played on your server, maybe add something for the bad flag keep away, like you get 25% more kills in the no-team mode?

Idk...it's nice how it is

[joevano]

Presently, it is at louman.bzflag2.norang.ca:4425. Of course that is always subject to change. So, if it's not there, like louman said... look for "Louman's Keep Away" on the list.

[Propane Tank]

Is there a special permission needed for administrators to run the admin commands?
Also, someone (or Lou Man) should add support for multiple flags as keep away. then so there is only one when it's that flag's turn to be keeped away, all flags reset and only one of the ka flag will spawn. IDK if anyone has tested more than one of each ka flag, but i'll surely test it.

-Propane Tank

[allejo]

Is there a special permission needed for administrators to run the admin commands?
Also, someone (or Lou Man) should add support for multiple flags as keep away. then so there is only one when it's that flag's turn to be keeped away, all flags reset and only one of the ka flag will spawn. IDK if anyone has tested more than one of each ka flag, but i'll surely test it.

-Propane Tank

Instead of asking for someone to add the support why don't you learn C++ and do it yourself.

[An SQUERRILz]

Nice plugin.
There is one code thing to fix, I think:

Code: Select all

	else if ( key == "AUTOTIME" && nubs->size() > 0 )
		keepaway.autoTimeOn = true;

	else if ( key == "AUTOTIME" && nubs->size() > 2 )
	{
		double temp1 = (double)atof(nubs->get(1).c_str());
		// etc
	}

becomes

Code: Select all

	else if ( key == "AUTOTIME" && nubs->size() > 2 )
	{
		double temp1 = (double)atof(nubs->get(1).c_str());
		// etc
	}
	else if ( key == "AUTOTIME" && nubs->size() > 0 )
		keepaway.autoTimeOn = true;

Previously the map object with line "autotime a b" would ignore the numbers a and b.