Timedctf - Revision history

Zehra: improved wording

2016-07-16T01:18:58Z

improved wording

← Older revision		Revision as of 01:18, 16 July 2016
Line 1:		Line 1:
			Timedctf is a standard [[Plug-ins\|plug-in]] that is shipped with the [[BZFlag Source]] code.
	The timedctf plugin will start a timed capture the flag game in which a team must capture another team's flag in a configurable amount of time.		The timedctf plugin will start a timed capture the flag game in which a team must capture another team's flag in a configurable amount of time.

JeffM2501: This was shipped, it's not a dev thing anymore

2013-02-10T08:30:01Z

This was shipped, it's not a dev thing anymore

← Older revision		Revision as of 08:30, 10 February 2013
Line 62:		Line 62:
	/fairctfon - this will enable the fair ctf function.<br />		/fairctfon - this will enable the fair ctf function.<br />

	~~[[Category:Development]]~~
	[[Category:Plug-Ins]]		[[Category:Plug-Ins]]

Cobra Fast: complete article review, DoDoc removed

2010-09-28T15:33:13Z

complete article review, DoDoc removed

← Older revision		Revision as of 15:33, 28 September 2010
Line 1:		Line 1:
	~~{{DoDoc\|cleanup~~ the ~~article according to the standards, and other plug-~~in ~~articles}}~~		The timedctf plugin will start a timed capture the flag game in which a team must capture another team's flag in a configurable amount of time.

	==Description==		=Description=
			* If the time expires before the team captures a flag, all members of the team will be destroyed and the timer will restart for that team.
			* If the team captures another team's flag before their time expires, their timer is reset and starts counting down again.
			* All 4 teams have individual timers.

	~~The timedctf plugin will start a timed capture the flag game in which a team must capture another team~~'s flag in a configurable amount of time. If the time expires before the team captures a flag, all members of the team will be destroyed and the timer will restart for that team. If the team captures another team'~~s flag before~~ their time ~~expires, their timer is reset and~~ starts ~~counting down again. All 4 teams have individual timers.~~		There are '''warning messages''' sent to individual teams as their time starts to expire:

	~~There are~~ warning ~~messages sent to individual teams as their~~ time ~~starts to expire:~~		* A warning every minute (with time remaining) until the last minute.<br />
			* A warning at 30 seconds before time expires.
			* A warning at 20 seconds before time expires.
			* A warning at 10 seconds before time expires.

	~~A warning every minute (with time remaining) until~~ the ~~last minute.<br />~~		The plugin also monitors the '''balance of teams''' and will disable the timer if teams are uneven. To determine if teams are balanced or not, at least a 75% match is used. This means that even teams would be considered:
	~~A warning at 30 seconds before time expires.<br />~~
	~~A warning at 20 seconds before time expires~~.~~<br />~~
	~~A warning~~ at ~~10 seconds before time expires~~.~~<br />~~
	~~(boom)~~

	~~The plugin also monitors the balance of teams and will disable the timer if teams are uneven. To determine if teams are balanced or not, at least a~~ 75% ~~match is used. This means that even teams would be considered:~~		These would work:
			* 2 vs 2 (100%)
			* 3 vs 4 (75%)

	~~1 vs 1 (100%)<br />~~		These won't:
	2 ~~vs 2 (100%)<br />~~		* 2 vs 4 (50%)
	~~3 vs 3 (100%)<br />~~		* 1 vs 4 (25%)
	3 vs 4 (75%)~~<br />~~
	4 vs 4 (~~100~~%)~~<br />~~		The percentage is calculated this way:
	~~4 vs 5 (80%)<br />~~		smaller team / larger team * 100
	~~5 vs 5 (100%)<br />~~
	~~5 vs 6 (83%)<br~~ />
	~~and so on.~~

	If the teams are uneven, capture the flag is disabled; if a player tries to pick up a team flag, it will almost immediately be dropped.		If the teams are uneven, capture the flag is disabled; if a player tries to pick up a team flag, it will almost immediately be dropped.
Line 42:		Line 43:
	present before allowing timed CTF to take place.		present before allowing timed CTF to take place.

	==Usage==		=Usage=

	The plugin will allow the time limit to be passed to the plugin through the -loadplugin command line with bzfs. The format is as follows:		The plugin will allow the time limit to be passed to the plugin through the -loadplugin command line with bzfs. The format is as follows:
Line 49:		Line 50:


	==Server Commands==		=Server Commands=
			The plugin has the following '''administration''' commands available:
	The plugin has the following commands available ~~to administrators~~:

	~~"tctftime <iii>" : this will change required capture time to <iii> (1-120 minutes).<br />~~
	~~"tctfoff" : this will disable timed CTF.<br />~~
	~~"tctfon" : this will enable timed CTF.<br />~~
	~~"tctfsoundoff" : this will disable timed CTF sounds.<br />~~
	~~"tctfsoundon" : this will enable timed CTF sounds.<br />~~
	~~"tctfstatus" : this will return the current status of functions and the current time limit.<br />~~
	~~"fairctfoff" : this will disable the fair ctf function.<br />~~
	~~"fairctfon" : this will enable the fair ctf function.<br />~~


			/tctftime <iii> - this will change required capture time to <iii> (1-120 minutes).<br />
			/tctfoff - this will disable timed CTF.<br />
			/tctfon - this will enable timed CTF.<br />
			/tctfsoundoff - this will disable timed CTF sounds.<br />
			/tctfsoundon - this will enable timed CTF sounds.<br />
			/tctfstatus - this will return the current status of functions and the current time limit.<br />
			/fairctfoff - this will disable the fair ctf function.<br />
			/fairctfon - this will enable the fair ctf function.<br />

	[[Category:Development]]		[[Category:Development]]
	[[Category:Plug-Ins]]		[[Category:Plug-Ins]]

Mr Burns: Deleting spam

2007-09-26T13:08:56Z

Deleting spam

← Older revision		Revision as of 13:08, 26 September 2007
Line 1:		Line 1:
	~~cnarolcdell~~
	{{DoDoc\|cleanup the article according to the standards, and other plug-in articles}}		{{DoDoc\|cleanup the article according to the standards, and other plug-in articles}}

195.246.155.219 at 12:18, 26 September 2007

2007-09-26T12:18:30Z

← Older revision		Revision as of 12:18, 26 September 2007
Line 1:		Line 1:
			cnarolcdell
	{{DoDoc\|cleanup the article according to the standards, and other plug-in articles}}		{{DoDoc\|cleanup the article according to the standards, and other plug-in articles}}

71.109.219.226 at 02:01, 27 August 2007

2007-08-27T02:01:50Z

← Older revision		Revision as of 02:01, 27 August 2007
Line 1:		Line 1:
	{{DoDoc\|~~Describe~~ the ~~basics of~~ plug-in ~~development.~~}}		{{DoDoc\|cleanup the article according to the standards, and other plug-in articles}}

	==Description==		==Description==

71.109.219.226 at 02:00, 27 August 2007

2007-08-27T02:00:43Z

← Older revision		Revision as of 02:00, 27 August 2007
Line 1:		Line 1:
			{{DoDoc\|Describe the basics of plug-in development.}}

	==Description==		==Description==

71.109.219.226 at 01:59, 27 August 2007

2007-08-27T01:59:37Z

← Older revision		Revision as of 01:59, 27 August 2007
Line 59:		Line 59:
	"fairctfoff" : this will disable the fair ctf function.<br />		"fairctfoff" : this will disable the fair ctf function.<br />
	"fairctfon" : this will enable the fair ctf function.<br />		"fairctfon" : this will enable the fair ctf function.<br />



			[[Category:Development]]
			[[Category:Plug-Ins]]

66.227.139.165: New page: ==Description== The timedctf plugin will start a timed capture the flag game in which a team must capture another team's flag in a configurable amount of time. If the time expires before...

2007-08-21T02:29:20Z

New page: ==Description== The timedctf plugin will start a timed capture the flag game in which a team must capture another team's flag in a configurable amount of time. If the time expires before...

New page

==Description==

The timedctf plugin will start a timed capture the flag game in which a team must capture another team's flag in a configurable amount of time. If the time expires before the team captures a flag, all members of the team will be destroyed and the timer will restart for that team. If the team captures another team's flag before their time expires, their timer is reset and starts counting down again. All 4 teams have individual timers.

There are warning messages sent to individual teams as their time starts to expire:

A warning every minute (with time remaining) until the last minute. 
A warning at 30 seconds before time expires. 
A warning at 20 seconds before time expires. 
A warning at 10 seconds before time expires. 
(boom)

The plugin also monitors the balance of teams and will disable the timer if teams are uneven. To determine if teams are balanced or not, at least a 75% match is used. This means that even teams would be considered:

1 vs 1 (100%) 
2 vs 2 (100%) 
3 vs 3 (100%) 
3 vs 4 (75%) 
4 vs 4 (100%) 
4 vs 5 (80%) 
5 vs 5 (100%) 
5 vs 6 (83%) 
and so on.

If the teams are uneven, capture the flag is disabled; if a player tries to pick up a team flag, it will almost immediately be dropped.

The plugin is set up for all 4 teams (red, green, blue and purple) and will monitor/time all 4 teams. However, it is best suited to 2 team capture the flag type maps in that it only looks for the 75% match between any 2 team sizes. This means that it is possible (on a 4 team ctf map) to have teams considered to be even if:

1 vs 1 vs 3 vs 1 
2 vs 2 vs 8 vs 1 
and so on.

There are also informative messages when the status of the game changes, for example:

If a new player joins/parts that causes team imbalance, a message is sent stating that teams are uneven and timed ctf is disabled. If a new player joins/parts that balances teams out, a message is sent that timed ctf is enabled and how much time there is to capture a flag. And so on...

There are also standard CTF sounds used whenever significant events take place.

Note that the balance of teams will still be monitored when the ctf timer is off, and team flags will be dropped if teams are uneven (as described above). This allows this plugin to be utilized for fair, normal ctf play as well, if the ctf timer is turned off. If both functions (tctf and fairctf) are turned off, the plugin is effectively disabled. If the fair CTF function is disabled and the timed CTF function is enabled, the plugin will check for at least 2 teams
present before allowing timed CTF to take place.

==Usage==

The plugin will allow the time limit to be passed to the plugin through the -loadplugin command line with bzfs. The format is as follows:

"'''-loadplugin <path>timedctf,i'''" where i is the timer value (in minutes)for timed ctf. For example,"-loadplugin plugins/timedctf,7" would start the plugin with the timer set for 7 minutes. The minimum is 1 minute and the maximum is 120 minutes. If no time is specified, the plugin defaults to 5 minutes.

==Server Commands==

The plugin has the following commands available to administrators:

"tctftime <iii>" : this will change required capture time to <iii> (1-120 minutes). 
"tctfoff" : this will disable timed CTF. 
"tctfon" : this will enable timed CTF. 
"tctfsoundoff" : this will disable timed CTF sounds. 
"tctfsoundon" : this will enable timed CTF sounds. 
"tctfstatus" : this will return the current status of functions and the current time limit. 
"fairctfoff" : this will disable the fair ctf function. 
"fairctfon" : this will enable the fair ctf function.