The score module can be used to give matches a score limit and modify how many points are added to the score for each kill or death. It can also be used to create score boxes that give a player or team a certain amount of points when they enter it.
Score Element | Description | ||
---|---|---|---|
<score> </score>
|
Node containing the score settings and score boxes. | ||
Sub-elements | Value/Children | Default | |
<limit>
|
Max score that can be reached before the match ends. | String | No limit |
<kills>
|
Points to give to a team for killing an enemy player | Number | 0 |
<deaths>
|
Points to deduct from a team for the accidental death of a team member | Number | 0 |
<box>
|
A single score box. | Score Box |
Example
<score>
<!-- First team to reach 100 points wins the match -->
<limit>100</limit>
<kills>3</kills> <!-- +3 points for every kill -->
<deaths>2</deaths> <!-- -2 points for accidentally dying -->
</score>
A score box will give points to a players team when they enter or bring a redeemable item to the score box region. Portals should be setup to remove the player from the immediate vicinity of the score box to prevent multiple scores.
Score Box Element | Description | Value/Children |
---|---|---|
<box>
|
A single score box. | Score Box Sub-elements |
Attribute | Description | Type | Default |
---|---|---|---|
points
|
Points awarded for entering the box. | Number | 0 |
silent
|
Don't notify players when points are scored in this box. | true/false | false |
region
|
Property Required The location and size of the score box. | Region | |
filter
|
Property Filter who can score in this box. | Filter | No Filter |
trigger
|
Property Dynamic conditions under which this score box is applied. | Dynamic Filter |
Element | Description | Value/Children | |
---|---|---|---|
<redeemables>
|
Items that can be redeemed at this score box for points. |
<item points="1">
|
|
<region>
|
Property Required The region where this score box is located. | Regions | |
<filter>
|
Property Filter who can score in this box. | Filters | |
<trigger>
|
Property Dynamic conditions under which this score box is applied. | Dynamic Filters |
Example
<score>
<!-- Only allow red team to use this score box, and give them two points -->
<box points="2" filter="only-red">
<region><cylinder base="21,8,63" radius="1" height="2"/></region>
</box>
</score>
<score>
<box value="8" filter="cyan" region="cyan-scorebox"/>
</score>
A score box can also award points in exchange for particular items carried by the player when they
enter the box. These items are defined inside a <redeemables>
score box sub-element as <item>
tags.
Each item contains a material name
and an optional points="..."
attribute specifying the number of points awarded for each item.
Example
<score>
<box filter="only-red" region="red-depot">
<redeemables>
<item points="5">diamond</item>
<item points="3">emerald</item>
<item points="1">gold nugget</item>
</redeemables>
</box>
</score>
Give the match a time limit, the result attribute determines how the winning team or player is calculated when the time runs out. Result can be the name of a team, or one of the special values; “tie” for no winner, or “objectives” for the team that has the most objectives completed. The time limit can be specified in minutes, etc., by formatting it as a time period.
NOTE!
This tag is not placed inside the score module, instead it is located in the root <map>
element.
<time result="objectives">5m</time>
Attribute | Description | Type | Default |
---|---|---|---|
result
|
Change how the winning team or player is calculated.
Accepts default , tie , objectives or a Team ID.
|
Victory Condition | Team ID | default |
show
|
Show the remaining time in the chat and boss bar. | true/false | true |