Kill Rewards

The <kill-rewards> module allows players to get items or a kit when they kill a player. A kill reward can contain either individual items, kits or references to kits. The reward can optionally filter which players are eligible to receive the reward, or when/where the reward is active.

This module can, for example, be used to give upgrades to players by giving them gold ingots. Then, once they have collected enough ingots, they can craft armor, etc.

Kill Rewards Element

Element	Description	Value/Children
<kill-rewards> </kill-rewards>	Node containing all kill reward definitions.	Kill Reward elements
Kill Rewards Sub-element
<kill-reward> </kill-reward>	A single kill reward.	Kill Reward Sub-elements
Kill Reward Attributes
filter	Property Filter who can claim this reward and when.	Filter
kit	Property The kit to give players as the kill reward.	Kit ID
Kill Reward Sub-elements
<item>	Individual items given as a kill reward.	Item
<filter>	Property Filter who can claim this reward and when.	Filters
<kit>	PropertyThe kit to give as the reward.	Kits

Examples

<kill-rewards>
    <!-- Give two emeralds for all kills -->
    <kill-reward>
        <item amount="2" material="emerald"/>
    </kill-reward>

    <!-- Give a cactus to players on the red team for every third kill -->
    <kill-reward>
        <filter>
            <all>
                <team>red</team>
                <kill-streak count="3"/>
            </all>
        </filter>
        <item material="cactus"/>
    </kill-reward>
</kill-rewards>

Kill rewards with kits

<kill-rewards>
    <kill-reward>
        <kit>
            <item slot="0" material="iron sword"/>
            <helmet material="iron helmet"/>
            <potion amplifier="2">speed</potion>
        </kit>
    </kill-reward>

    <!-- Give the "reward-kit" to the player for every 8th kill -->
    <kill-reward>
        <filter>
            <kill-streak count="8" repeat="true"/>
        </filter>
        <kit id="reward-kit"/>
    </kill-reward>
</kill-rewards>