Kill Awards 1.2.0

Rewards

• Refills the ammo of the player's active weapon.
• Heals the player by a specified amount upon reaching the milestone.
• Equips a designated gear set for the player (Requires Gear Core plugin).
• Runs custom commands that can perform a variety of actions, like granting items or triggering server events.
• Deposits points and coins to the player (Requires Server Rewards and Economics plugins).

Configuration

{
  "Version": "1.2.0",
  "Include NPC Kills": false,
  "Include Animal Kills": false,
  "Ignore Teammate Kills": true,
  "Reset Milestone On Death": true,
  "Kill Milestones": {
    "1": {
      "Amount Of Health Restored": 10.0,
      "Refill Weapon Ammo": false,
      "Gear Set To Equip": "",
      "Points Deposited": 0,
      "Coins Deposited": 0,
      "Personal Message": "You reached {killCount} kills, nice start!",
      "Global Message": "{playerName} just hit 1 kill milestone!",
      "Commands To Run": []
    },
    "2": {
      "Amount Of Health Restored": 15.0,
      "Refill Weapon Ammo": true,
      "Gear Set To Equip": "",
      "Points Deposited": 0,
      "Coins Deposited": 0,
      "Personal Message": "You reached {killCount} kills! Keep it going!",
      "Global Message": "{playerName} is on a roll with {killCount} kills!",
      "Commands To Run": []
    },
    "3": {
      "Amount Of Health Restored": 20.0,
      "Refill Weapon Ammo": true,
      "Gear Set To Equip": "",
      "Points Deposited": 0,
      "Coins Deposited": 0,
      "Personal Message": "You reached {killCount} kills and earned 50 scrap!",
      "Global Message": "Watch out! {playerName} just reached {killCount} kills!",
      "Commands To Run": [
        {
          "Type": "Server",
          "Command": "inventory.giveto {playerId} scrap 50"
        }
      ]
    }
  }
}

• Include NPC Kills - When set to true, kills on npcs will count towards kill milestones.
• Include Animal Kills - Allows kills on animals to count toward kill milestones if true.
• Ignore Teammate Kills - If enabled, kills on teammates are ignored and do not contribute to milestones.
• Reset Milestone On Death - If true, a player's kill milestone resets to zero upon death.
• Kill Milestones- Defines milestone rewards based on kill count. Each milestone can have the following reward configurations:
  • Amount Of Health Restored - Amount of health a player receives upon reaching a specific milestone.
  • Refill Weapon Ammo - If true, the player's active weapon ammo will be refilled upon milestone completion.
  • Gear Set To Equip - Name of a gear set to be equipped at this milestone.
  • Personal Message- A custom message shown only to the player who reached the milestone. Supports placeholders like:
    • {playerName} - The player's display name.
    • {killCount} - The number of kills the player has achieved.
  • Global Message - A custom message broadcast to all players when someone reaches the milestone. Also supports:
    • {playerName} - The player's display name.
    • {killCount} - The number of kills the player has achieved.
  • Commands To Run- List of commands executed at the milestone. Each command includes:
    • Type- The type of command to execute.
      • Chat - Sends the command as a chat message.
      • Server - Executes the command on the server.
      • Client - Runs the command directly on the player's client.
    • Command- The command string to be executed, supporting the following placeholders
      • {PlayerId} - The player's unique id.
      • {PlayerName} - The player's display name.
      • {PositionX}, {PositionY}, {PositionZ} - Player's position coordinates.
      • {Grid} - The map grid location of the player.
• Coins Rewarded - The amount of coins a player earns upon completing the milestone. (Requires Economics plugin.)
• Points Rewarded - The number of points a player earns upon completing the milestone. (Requires Server Rewards plugin.)

Localization

{
  "HealthRestored": "You have been healed by {0} health points!",
  "AmmoRefilled": "Your ammo has been fully topped up!",
  "GearSetGiven": "You have received the gear set {0}!",
  "PointsAwarded": "You have been awarded {0} points!",
  "CoinsAwarded": "You have been awarded {0} coins!"
}