This wiki is archived and useful information is being migrated to the main bzflag.org website

Difference between revisions of "Keepaway"

From BZFlagWiki
Jump to: navigation, search
(keepaway plugin summary)
 
(Removing all content from page)
Line 1: Line 1:
<PRE>
 
keepaway plugin
 
  
Author: LouMan
 
 
Credit to JeffM2501 for custom map object code (from flagStay plugin),
 
which I have modified to fit this application.  Also, credit to
 
Thumper for brilliant idea :)
 
 
Description:
 
 
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 &amp; 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 &lt;message&gt;" 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 &lt;seconds&gt;
 
 
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 &lt;multiplier&gt; &lt;minimum multiplier&gt;
 
 
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 &lt;flag type&gt; &lt;flag type&gt; &lt;flag type&gt; &lt;flag type&gt; &lt;flag type&gt;...
 
 
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 seem to have issues with this feature).
 
 
 
noflagreset
 
 
Optional.  This will disable automatic flag reset function of the Keep
 
Away plugin (enabled as default).
 
 
-------------------------------------------------------------------------------------
 
 
Examples of map (.bzw) entries:
 
 
 
keepaway
 
  holdtime 90
 
  autotime 2 40
 
  keepawayflags SB G TH MG GM L
 
  forcedflags
 
  teamplay
 
  noflagreset
 
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).  The automatic flag reset function of the plugin would be
 
disabled.
 
 
 
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 &lt;message&gt;" - this will send message to the player holding the Keep Away flag.
 
"kaf" - this will return the current Keep Away flag to be found &amp; 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 &lt;seconds&gt;" - this will change Keep Away hold time 1 -&gt; 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.
 
"kaflagreseton" - enables Keep Away sounds.
 
"kaflagresetoff" - disables Keep Away sounds.
 
 
-------------------------------------------------------------------------------------
 
 
Please report any bugs or issues with this plugin to LouMan, and good luck.
 
</PRE>
 

Revision as of 02:33, 20 August 2007