Koth - Revision history

Zehra: /* Server Commands */ added wiki table

2016-12-05T21:51:31Z

Server Commands: added wiki table

← Older revision		Revision as of 21:51, 5 December 2016
Line 86:		Line 86:

	There are several administrator commands available with the plugin:		There are several administrator commands available with the plugin:
			{\|{{Prettytable}}
	/kothon - this will turn King of the Hill mode on, if turned off previously.		\|-
	/kothoff - this will turn King of the Hill mode off for normal gameplay.		\| {{Hl3}} \|'''Command'''
	/kothtimemult - this will set auto time multiplier (per new player).		\| {{Hl3}} \|'''Description'''
	/kothtimemultmin - this will set minimum auto time multiplier.		\|-
	/kothautotimeon - this will enable the autotime function.		\| /kothon \|\| this will turn King of the Hill mode on, if turned off previously.
	/kothsoundon - this will enable the plugin's sounds.		\|-
	/kothsoundoff - this will disable the plugin's sounds.		\| /kothoff \|\| this will turn King of the Hill mode off for normal gameplay.
	/kothautotimeoff - this will disable the autotime funtion.		\|-
	/kothtime <seconds> - this will change King of the Hill hold time 1 -> 7200 seconds.		\| /kothtimemult \|\| this will set auto time multiplier (per new player).
	/kothstatus - this will return the status of the plugin modes, times, etc.		\|-
			\| /kothtimemultmin \|\| this will set minimum auto time multiplier.
			\|-
			\| /kothautotimeon \|\| this will enable the autotime function.
			\|-
			\| /kothsoundon \|\| this will enable the plugin's sounds.
			\|-
			\| /kothsoundoff \|\| this will disable the plugin's sounds.
			\|-
			\| /kothautotimeoff \|\| this will disable the autotime funtion.
			\|-
			\| /kothtime <seconds> \|\| this will change King of the Hill hold time 1 -> 7200 seconds.
			\|-
			\| /kothstatus \|\| this will return the status of the plugin modes, times, etc.
			\|}

	=Deprecation=		=Deprecation=

Zehra: /* Usage */ added wiki table

2016-12-05T20:41:15Z

Usage: added wiki table

← Older revision		Revision as of 20:41, 5 December 2016
Line 28:		Line 28:

	The parameters of the King of the Hill (koth) map definition are follows:		The parameters of the King of the Hill (koth) map definition are follows:
			{\|{{Prettytable}}
	* '''position <x> <y> <z>'''		\|-
	Required. This determines the location of the "hill"		\| {{Hl3}} \|'''Parameter'''
			\| {{Hl3}} \|'''Description'''
	* '''size <x> <y> <z>'''		\|-
	Required for rectangular hills. This determines the size of the rectangular zone		\| '''position <x> <y> <z>''' \|\| Required. This determines the location of the "hill"
			\|-
	* '''rotation <degrees>'''		\| '''size <x> <y> <z>''' \|\| Required for rectangular hills. This determines the size of the rectangular zone.
	Optional. Only for rectangular zones, you can set the rotation as any other object.		\|-
			\| '''rotation <degrees>''' \|\| Optional. Only for rectangular zones, you can set the rotation as any other object.
	* '''radius <radius>'''		\|-
	Required for cylindrical hills. The radius of the cylindrical hill		\| '''radius <radius>''' \|\| Required for cylindrical hills. The radius of the cylindrical hill.
			\|-
	* '''height <units>'''		\| '''height <units>''' \|\| Required for cylindrical hills. The height of the hill; the z-axis.
	Required for cylindrical hills. The height of the hill; the z-axis.		\|-
			\| '''teamplay''' \|\| Optional. This will enable the teamplay mode of King of the Hill (see above). If not included, teamplay is disabled and it becomes as basic free for all King of the Hill mode.
	* '''teamplay'''		\|-
			\| '''holdtime <seconds>''' \|\| Optional. This defines the time (in seconds) required to occupy the King of the Hill volume before a player is declared King of the Hill and other teams/players are zapped. If not included, the default setting is 60 seconds (1 minute). The limits of this setting are controlled to a minimum of 1 second and a maximum of 7200 seconds.
	Optional. This will enable the teamplay mode of King of the Hill (see above). If not included, teamplay is disabled and it becomes as basic free for all King of the Hill mode.		\|-
			\| '''autotime <multiplier> <minimum multiplier>''' \|\| Optional. This will enable the automatic time reduction feature of the plugin that will reduce the time to hold the hill, 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).
	* '''holdtime <seconds>'''		\|-
			\| '''nosound''' \|\| Optional. This will disable sounds associated with Keep Away plugin (some clients seem to have issues with this feature).
	Optional. This defines the time (in seconds) required to occupy the King of the Hill volume before a player is declared King of the Hill and other teams/players are zapped. If not included, the default setting is 60 seconds (1 minute). 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 hill, 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).

	* '''nosound'''

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

	=Examples=		=Examples=

Zehra: added related wiki link

2016-11-24T02:01:32Z

added related wiki link

← Older revision		Revision as of 02:01, 24 November 2016
Line 1:		Line 1:
	The plugin will create a King of the Hill game mode in which a team (or player) can occupy a defined volume ("Hill") for a defined amount of time and kill all other teams (or players) if occupied long enough.		The plugin will create a [[Game Modes#King of the Hill\|King of the Hill]] game mode in which a team (or player) can occupy a defined volume ("Hill") for a defined amount of time and kill all other teams (or players) if occupied long enough.

	=Description=		=Description=
Line 19:		Line 19:

	* When Hill is initially occupied and when hill is taken, standard team audio alerts take place.		* When Hill is initially occupied and when hill is taken, standard team audio alerts take place.


	=Usage=		=Usage=

Allejo: Update wording in example description

2015-05-22T23:08:09Z

Update wording in example description

← Older revision		Revision as of 23:08, 22 May 2015
Line 74:		Line 74:
	end		end

	This would set up a King of the Hill volume 60 x 60 x 30, ~~centered~~ at 0 0 25. Teamplay would be enabled and the required time to occupy the "Hill" would be 60 seconds (1 minute). Time to hold would not automatically adjust downward with new players.		This would set up a King of the Hill volume 60 x 60 x 30, at position 0 0 25. Teamplay would be enabled and the required time to occupy the "Hill" would be 60 seconds (1 minute). Time to hold would not automatically adjust downward with new players.

	koth		koth
Line 86:		Line 86:
	end		end

	This would set up a King of the Hill cylindrical volume 30 x 30 x 20, ~~centered~~ at 0 0 30. Teamplay would be enabled and the required time to occupy the "Hill" would be 100 seconds. The time to occupy the hill would adjust downward with an increasing number of players (see autotime description above). Each new player after 2 will reduce the hold time by 5% to a minimum of 25% of the hold time (25 seconds). The sounds associated with the plugin would be disabled.		This would set up a King of the Hill cylindrical volume 30 x 30 x 20, at position 0 0 20. Teamplay would be enabled and the required time to occupy the "Hill" would be 100 seconds. The time to occupy the hill would adjust downward with an increasing number of players (see autotime description above). Each new player after 2 will reduce the hold time by 5% to a minimum of 25% of the hold time (25 seconds). The sounds associated with the plugin would be disabled.

	The plugin must be loaded at startup or else the server it will not recognize these map parameters.		The plugin must be loaded at startup or else the server it will not recognize these map parameters.

Allejo: Updated example with correct value

2015-05-22T23:05:23Z

Updated example with correct value

← Older revision		Revision as of 23:05, 22 May 2015
Line 77:		Line 77:

	koth		koth
	position 0 0 30		position 0 0 20
	height 20		height 20
	radius 15		radius 15

Allejo: Added deprecation notice

2015-05-22T22:51:07Z

Added deprecation notice

← Older revision		Revision as of 22:51, 22 May 2015
Line 108:		Line 108:
	/kothtime <seconds> - this will change King of the Hill hold time 1 -> 7200 seconds.		/kothtime <seconds> - this will change King of the Hill hold time 1 -> 7200 seconds.
	/kothstatus - this will return the status of the plugin modes, times, etc.		/kothstatus - this will return the status of the plugin modes, times, etc.

			=Deprecation=

			* '''bbox <Xmin> <Xmax> <Ymin> <Ymax> <Zmin> <Zmax>'''
			* '''cylinder <X> <Y> <Zmin> <Zmax> <radius>'''

			Support for the '''bbox''' and '''cylinder''' parameters in a Koth zone has been deprecated and will be removed in the future.

	=External Links=		=External Links=

Allejo: Update parameters

2015-05-22T22:48:54Z

Update parameters

← Older revision		Revision as of 22:48, 22 May 2015
Line 30:		Line 30:
	The parameters of the King of the Hill (koth) map definition are follows:		The parameters of the King of the Hill (koth) map definition are follows:

	* '''~~bbox~~ <~~Xmin~~> <~~Xmax~~> <~~Ymin~~> <~~Ymax~~> <~~Zmin~~> <~~Zmax~~>'''		* '''position <x> <y> <z>'''
	* '''~~cylinder~~ <~~X> <Y> <Zmin> <Zmax~~> <radius>'''		Required. This determines the location of the "hill"
	Required. ~~These define~~ the ~~volume on the map to be occupied~~ for the ~~King of~~ the ~~Hill~~.
			* '''size <x> <y> <z>'''
			Required for rectangular hills. This determines the size of the rectangular zone

			* '''rotation <degrees>'''
			Optional. Only for rectangular zones, you can set the rotation as any other object.

			* '''radius <radius>'''
			Required for cylindrical hills. The radius of the cylindrical hill

			* '''height <units>'''
			Required for cylindrical hills. The height of the hill; the z-axis.

	* '''teamplay'''		* '''teamplay'''
Line 51:		Line 62:

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


	=Examples=		=Examples=

Allejo: Update examples to use new syntax

2015-05-22T22:43:33Z

Update examples to use new syntax

← Older revision		Revision as of 22:43, 22 May 2015
Line 58:		Line 58:

	koth		koth
	~~bbox -~~30 ~~30 -30 30 10 40~~		position 0 0 25
			size 60 60 30
	teamplay		teamplay
	holdtime 60		holdtime 60
Line 66:		Line 67:

	koth		koth
	~~cylinder~~ 0 0 20 40 15		position 0 0 30
			height 20
			radius 15
	holdtime 100		holdtime 100
	teamplay		teamplay
Line 75:		Line 78:
	This would set up a King of the Hill cylindrical volume 30 x 30 x 20, centered at 0 0 30. Teamplay would be enabled and the required time to occupy the "Hill" would be 100 seconds. The time to occupy the hill would adjust downward with an increasing number of players (see autotime description above). Each new player after 2 will reduce the hold time by 5% to a minimum of 25% of the hold time (25 seconds). The sounds associated with the plugin would be disabled.		This would set up a King of the Hill cylindrical volume 30 x 30 x 20, centered at 0 0 30. Teamplay would be enabled and the required time to occupy the "Hill" would be 100 seconds. The time to occupy the hill would adjust downward with an increasing number of players (see autotime description above). Each new player after 2 will reduce the hold time by 5% to a minimum of 25% of the hold time (25 seconds). The sounds associated with the plugin would be disabled.

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


	=Server Commands=		=Server Commands=

Cobra Fast: complete article review, DoDoc removed

2010-09-28T15:10:23Z

complete article review, DoDoc removed

Show changes

Ha You Got Shot By Me at 00:11, 28 June 2009

2009-06-28T00:11:15Z

← Older revision		Revision as of 00:11, 28 June 2009
Line 110:		Line 110:
	"kothtime <seconds>" - this will change King of the Hill hold time 1 -> 7200 seconds.<br />		"kothtime <seconds>" - this will change King of the Hill hold time 1 -> 7200 seconds.<br />
	"kothstatus" - this will return the status of the plugin modes, times, etc.		"kothstatus" - this will return the status of the plugin modes, times, etc.

			==External Links==
			An easy way to make bboxes is located here: http://d41games.freehostia.com/bzflag.php?map=bbox