Control Points

Control points give a certain amount of points to the team currently holding it. Once a team has captured all points, or reached a certain score (using the score module) the match ends. Control points can be mixed with and used in addition to other gamemodes. Other uses of control points include unlocking an area of the map using objective filters, etc.

<control-points capture-rule="lead" show-progress="true">
    <control-point name="Center" capture-time="20s">
        <capture><cylinder base="0.5,23,7.5" radius="7" height="5"/></capture>
        <progress><cylinder base="0.5,22,7.5" radius="7" height="4"/></progress>
        <captured><cylinder base="0.5,64,7.5" radius="7" height="5"/></captured>
    </control-point>
</control-points>

Control Points Element	Description	Value/Children
<control-points> </control-points>	Node containing a single control point or a group of control points.
Sub-elements
<control-point> </control-point>	A single control point.	Control Point Sub-elements

Control Point Attributes

Attribute	Description	Value	Default	KotH
id	Unique identifier used to reference control points from other places in the XML.	String
name	Name of the control point, displayed on the scoreboard.	String
required	Specify if this objective is required to win the match. Teams completing all of their required objectives will win regardless of score or Blitz configuration.	true/false
capture-time	Time to capture the control point.	Time Period	30 sec
points	Points to give per second to the owning team.	Number	1
points-growth	Number of seconds for the point rate to double. If given, the rate at which the control point gives points will exponential increase with time.	Number	0
owner-points	Gives a set number of points to a team when captured. When the control point is captured by another team, the points are revoked.	Number	0
capture-rule	Rule used to decide who is in control of the point at any given moment.	Capture Rule	exclusive
time-multiplier	Adjust capture time relative to the amount of team players on the control point.	Decimal	0	0.1
show-progress	Show capture percentage in the sidebar.	true/false	false	true
neutral-state	Control point must be un-captured before it can be captured again.	true/false	false	true
recovery-rate	The rate for a control point to recover to its current state. Applies when the owning team is dominating (only having players of the capturing team on the point).	Number	depends	0
decay-rate	The rate for a control point to decay to its current state. Applies when nobody is dominating the point (contested by multiple teams or no teams on the point). Can be determined by capture-rules.	Number	depends	0
contested-rate	The rate for a control point to decay to its current state. Applies when the point is contested.	Number	decay-rate
owned-decay-rate	The rate for a control point to decay from captured to neutral. Applies when nobody is dominating the point. Takes precedence over decay-rate.	Number	depends	0
incremental	DeprecatedCapture progress is retained even if capturing is interrupted. If incremental is true, sets recovery-rate to 1,decay-rate to 0, and owned-decay-rate to 0. If incremental is false, recovery-rate anddecay-rate are both infinite, and owned-decay-rate is 0. This has been replaced with the recovery & decay attributes which allow more control over progress.	true/false	false	true
permanent	Control point can only be captured once during the match.	true/false	false	true
initial-owner	The team owning the control point when the match starts.	Team ID
show-messages	Broadcast messages related to the control point in chat.	true/false	true
show-effects	Play sounds, fireworks and other effects related to the control point.	true/false	true
show-info	Display the control point under commands such as /match.	true/false	true
show-sidebar	Displays the control point on scoreboard.	true/false	true
stats	Determines if this control point counts as a win condition.	true/false	true
show	Specify if the control point should be hidden from all visible locations to the player. These locations include chat, the boss bar, and the scoreboard. NOTE:This attribute sets all five values above to true/false.	true/false	true
visual-materials	Filter the materials modified when updating the progress regions. Defaults to wool, carpet, stained clay, stained glass & stained glass panes.	Block Filter
capture	PropertyRequiredRegion where this control point can be captured.	Region
progress	PropertyRegion where this control points progress is displayed.	Bounded Region
captured	PropertyRegion where this control points owner is displayed.	Bounded Region
capture-filter	PropertyFilter teams that can capture this control point, defaults to all teams. Teams that don't match this filter can still prevent other teams from capturing by standing on the control point. They can also uncapture the control point if neutral-state is enabled.	Filter
player-filter	PropertyFilter players who can control this control point. Players who don't match this filter cannot affect the control point in any way.	Filter

Control Point Sub-elements

Element	Description	Value/Children
<capture>	PropertyRequiredThe region players have to stand in to capture the control point.	Regions
<progress>	PropertyThe region to display capture progress.	Bounded Regions
<captured>	PropertyThe region to display if the control point is captured.	Bounded Regions
<capture-filter>	PropertyFilter teams that can capture this control point, defaults to all teams. Teams that don't match this filter can still prevent other teams from capturing by standing on the control point. They can also uncapture the control point if neutral-state is enabled.	Filters
<player-filter>	PropertyFilter players who can control this control point. Players who don't match this filter cannot affect the control point in any way.	Filters

Capture Rule

The capture rule defines the logic used to decide which team is in control of the point. Values for capture-rule can be one of the following:

exclusive The team must be the only team with players on the control point. (default)
majority The team must have more players on the control point than all other teams combined.
lead The team must have more players on the control point than any other single team.

Players who match either capture-filter or player-filter are counted when calculating the capture-rule. Players who don't match either filter cannot affect the control point at all.

Control Point Regions

Capture progress is displayed inside the defined <progress> region using the dominating teams color. After a control point is captured the <captured> region is also filled with that color. The progress and captured regions must be bounded regions, e.g. cylinders & cuboids will work, circles and squares will not. Only the default visual materials or materials defined in visual-materials will be modified in the progress regions when they are updated.

King of the Hill (deprecated)

caution

The <king>, <hill> and <hills> tags have been deprecated. Use the <control-point> and <control-points> tags, which work the same but with differrent default values.

KotH is a gamemode in which you capture and hold a hill to collect points. The first team to reach a preset amount of points wins.

KotH maps use control points to define hills. Instead of being called <control-points> they are called <hills> and must be defined inside a main <king> element. The main difference between hills and control points is what their default values are. Default values for time-multiplier, show-progress, neutral-state, incremental and permanent differ between <control-point> and <hill>.

<king>
    <hills>
        <hill name="Hill" capture-time="10s" points="1">
            <capture><region id="hill"/></capture>
            <progress><cuboid min="-5,71,-5" max="5,71,5"/></progress>
        </hill>
    </hills>
</king>

Scoring

KotH games use the <score> module to end the game when one team reaches a preset amount of points. The <king/> tag prevents teams from getting points when killing players, this means they have to actually capture the hill to get points.

King of the Hill maps may not have a time limit.

<score>
    <limit>500</limit>
    <king/>
</score>

Control Point Attributes​

Control Point Sub-elements​

Capture Rule​

Control Point Regions​

King of the Hill (deprecated)​

Scoring​