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 | Description | Value/Children |
|---|---|---|
<kill-rewards> </kill-rewards>
|
Node containing all kill reward definitions. | Kill Reward elements |
| Kill Rewards Sub-elements | ||
<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>
|
Property The kit to give as the reward. | Kits |
Examples
XML Documentation
<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 their 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>