Modules

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>


Score Boxes

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
Score Box Attributes
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
Score Box Sub-elements
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>


Redeemables

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>


Time Limit

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>
Time Attributes
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