Join the Game4Freak Discord Get exclusive plugin sneak peeks, talk directly with VisEntities, never miss important updates, and unlock special discount codes!
Kill Awards

Kill Awards 1.4.0

Sign in to download
Reward players with items, kits, XP, and more for reaching kill milestones
Documentation License Changelog (6) Reviews (2) Version History Discussion
Dependencies
Kits (Optional), Economics (Optional), Server Rewards (Optional), X Perience (Optional), Skill Tree (Optional)
This plugin rewards players when they reach kill milestones during their life. Configure multiple kill thresholds with custom rewards including health restoration, ammo refills, items, economy integration, XP systems, and more.

Features

  • Configurable kill milestones - Set up multiple kill thresholds with unique rewards
  • Diverse reward types - Health, ammo, kits, items, currency, and XP systems
  • Economy integration - Supports Economics, Server Rewards, XPerience, and SkillTree plugins
  • Custom commands - Execute chat, client, or server commands as rewards
  • Flexible kill counting - Control what kills count (players, npcs, animals, teammates)
  • Death reset system - Optionally reset kill count on player death to encourage survival
  • Personal and broadcast messages - Notify players of achievements with customizable messages

Configuration

JSON: 
{
  "Version": "1.4.0",
  "Count NPC Kills Towards Milestones": false,
  "Count Animal Kills Towards Milestones": false,
  "Exclude Teammate Kills From Count": true,
  "Reset Kill Count On Player Death": true,
  "Kill Milestones": {
    "1": {
      "Health To Restore (0 to disable)": 10.0,
      "Refill Held Weapon Ammo": false,
      "Kit Name (requires Kits plugin, empty to disable)": "",
      "Server Rewards Points (requires Server Rewards plugin, 0 to disable)": 0,
      "Economics Money (requires Economics plugin, 0 to disable)": 0,
      "XPerience XP (requires XPerience plugin, 0 to disable)": 0.0,
      "Skill Tree XP (requires Skill Tree plugin, 0 to disable)": 0.0,
      "Personal Message (shown only to player, supports {playerName} and {killCount})": "You reached {killCount} kills, nice start!",
      "Broadcast Message (shown to all players, supports {playerName} and {killCount})": "{playerName} just hit 1 kill milestone!",
      "Commands To Execute": []
    },
    "2": {
      "Health To Restore (0 to disable)": 15.0,
      "Refill Held Weapon Ammo": true,
      "Kit Name (requires Kits plugin, empty to disable)": "",
      "Server Rewards Points (requires Server Rewards plugin, 0 to disable)": 0,
      "Economics Money (requires Economics plugin, 0 to disable)": 0,
      "XPerience XP (requires XPerience plugin, 0 to disable)": 0.0,
      "Skill Tree XP (requires Skill Tree plugin, 0 to disable)": 0.0,
      "Personal Message (shown only to player, supports {playerName} and {killCount})": "You reached {killCount} kills! Keep it going!",
      "Broadcast Message (shown to all players, supports {playerName} and {killCount})": "{playerName} is on a roll with {killCount} kills!",
      "Commands To Execute": []
    },
    "3": {
      "Health To Restore (0 to disable)": 20.0,
      "Refill Held Weapon Ammo": true,
      "Kit Name (requires Kits plugin, empty to disable)": "",
      "Server Rewards Points (requires Server Rewards plugin, 0 to disable)": 0,
      "Economics Money (requires Economics plugin, 0 to disable)": 0,
      "XPerience XP (requires XPerience plugin, 0 to disable)": 0.0,
      "Skill Tree XP (requires Skill Tree plugin, 0 to disable)": 0.0,
      "Personal Message (shown only to player, supports {playerName} and {killCount})": "You reached {killCount} kills and earned 50 scrap!",
      "Broadcast Message (shown to all players, supports {playerName} and {killCount})": "Watch out! {playerName} just reached {killCount} kills!",
      "Commands To Execute": [
        {
          "Command Type (Chat, Server, or Client)": "Server",
          "Command (supports {playerId}, {playerName}, {positionX}, {positionY}, {positionZ}, {grid})": "inventory.giveto {playerId} scrap 50"
        }
      ]
    }
  }
}

General Settings

  • Count NPC Kills Towards Milestones -- When enabled, killing NPC players (scientists, bandit guards, etc.) counts towards milestones. Useful for PvE servers.
  • Count Animal Kills Towards Milestones -- When enabled, killing animals (bears, wolves, boars, etc.) counts towards milestones.
  • Exclude Teammate Kills From Count -- When enabled, killing your own teammates will not count. Recommended to prevent abuse.
  • Reset Kill Count On Player Death -- When enabled, player's kill count resets to 0 on death, creating a "kill streak" system. When disabled, kills accumulate across lives.

Kill Milestones

  • Kill Milestones -- Dictionary where keys are kill counts (1, 2, 3, etc.) and values are reward configurations. When a player reaches the kill count, they receive all configured rewards for that milestone.
Each milestone entry supports the following rewards:
  • Health To Restore-- Amount of health to restore to the player.
    • Example: 25.0 heals the player for 25 HP
    • Healing is instant and can exceed current health up to max (100 HP)
  • Refill Held Weapon Ammo-- When true, fully refills ammo for the weapon the player is currently holding. Only works if holding a weapon with a magazine.
    • Does not give extra ammo to inventory, only refills the magazine
    • Has no effect if player isn't holding a weapon
  • Kit Name-- Name of kit to give the player via the Kits plugin. Leave empty ("") to disable. Requires Kits plugin installed.
  • Server Rewards Points -- Amount of Server Rewards points to award. Set to 0 to disable. Requires Server Rewards plugin.
  • Economics Money -- Amount of Economics currency to award. Set to 0 to disable. Requires Economics plugin.
  • XPerience XP -- Amount of XPerience XP to award. Set to 0 to disable. Requires X Perience plugin.
  • Skill Tree XP -- Amount of SkillTree XP to award. Set to 0 to disable. Requires Skill Tree plugin.
  • Personal Message -- Message shown only to the player who reached the milestone. Leave empty to disable. Supports placeholders: {playerName} (player's display name), {killCount} (current kill count).
  • Broadcast Message -- Message shown to all players on the server when someone reaches this milestone. Leave empty to disable server-wide announcements. Supports same placeholders as Personal Message.
  • Commands To Execute-- Array of command entries to execute when milestone is reached. Each entry has two properties:
    • Command Type -- Type of command. Options: "Chat" (executes as player chat command), "Server" (executes as server console command), "Client" (executes as client-side command for the player).
    • Command -- The command string with placeholder support.
Command Placeholders:
  • {playerId} -- Player's Steam ID as string
  • {playerName} -- Player's display name
  • {positionX} -- Player's X coordinate
  • {positionY} -- Player's Y coordinate
  • {positionZ} -- Player's Z coordinate
  • {grid} -- Player's grid position (e.g., "G15")
Example command entries:
JSON: 
"Commands To Execute": [
  {
    "Command Type (Chat, Server, or Client)": "Server",
    "Command (supports {playerId}, {playerName}, {positionX}, {positionY}, {positionZ}, {grid})": "inventory.giveto {playerId} scrap 50"
  },
  {
    "Command Type (Chat, Server, or Client)": "Server",
    "Command (supports {playerId}, {playerName}, {positionX}, {positionY}, {positionZ}, {grid})": "inventory.giveto {playerId} rifle.ak 1"
  },
  {
    "Command Type (Chat, Server, or Client)": "Chat",
    "Command (supports {playerId}, {playerName}, {positionX}, {positionY}, {positionZ}, {grid})": "I just got a kill streak!"
  }
]

Stored Data

JSON: 
{
  "Players": {
    "76561198012345678": {
      "Kills": 2
    },
    "76561198087654321": {
      "Kills": 5
    }
  }
}
Stores each player's current kill count indexed by their Steam ID.
  • Kills -- Current kill count for that player

Localization

JSON: 
{
  "Reward.HealthRestored": "You have been healed for <color=#90EE90>{0}</color> health!",
  "Reward.AmmoRefilled": "Your weapon ammo has been fully refilled!",
  "Reward.KitGiven": "You have received the <color=#87CEEB>{0}</color> kit!",
  "Reward.PointsAwarded": "You have been awarded <color=#FFD700>{0}</color> Server Rewards points!",
  "Reward.MoneyAwarded": "You have been awarded <color=#FFD700>{0}</color> money!",
  "Reward.XPerienceXpAwarded": "You have been awarded <color=#DDA0DD>{0}</color> XPerience XP!",
  "Reward.SkillTreeXpAwarded": "You have been awarded <color=#DDA0DD>{0}</color> SkillTree XP!"
}
  • Like
Reactions: nexusking
Author
VisEntities
Downloads
97
First release
Last update

Ratings

5.00 star(s) 2 reviews
Contribute on GitHub

Also by VisEntities

Latest updates

  1. 1.4.0

    Added Skill Tree XP support as milestone reward. Replaced Gear Core integration with Kits...

  2. 1.3.0

    Added optional XP rewards for kill milestones.

  3. 1.2.0

    You can now send a message just for the player when they hit a kill milestone. You can now...
Read more…

Latest reviews

Jeff Goldblum
Very nice simple free killstreak plugin!
great on custom rewards and simple config to adjust to get it going 10/10
Upvote 0 Downvote
Rynki
This is a great little plugin, nice and easy to configure and gives you the ability to create actions from other plugins.
Upvote 0 Downvote
Read more…
Back
Top
Chat commands start with a /, while console commands can be entered directly in the F1 console or server console. Use find <keyword> in console to search for available commands related to the plugin. Parameters in < > are required, while [ ] are optional.
This plugin uses Oxide's permission system. Grant or revoke permissions using oxide.grant and oxide.revoke. You can assign them to individual players or groups using their Steam id or group name.
Settings are stored in the config file found under the config/ directory. You can edit this file manually, then reload the plugin to apply your changes.
Persistent data is saved in the data/ directory. This includes things like saved settings, usage stats, or player progress depending on the plugin. Deleting a data file will reset stored progress or customizations.
Language files are located in the lang/ folder. To translate messages, copy the en.json file into your target language folder (e.g. fr, de) and edit the values. Reload the plugin after changes to apply new messages.
This section lists public methods exposed by the plugin for use in other plugins. You can call these via the CallHook method. Ensure the plugin is loaded before calling its API to avoid null reference errors.
These are custom hooks that other plugins can listen for. Simply define a method with the same name and expected parameters in your plugin to handle the event. Hooks are triggered at key moments and are useful for extending or reacting to plugin behavior.
These hooks are injected into the game's code using Harmony. They let the plugin run code at key points in the game's internal logic. You can return values to block or modify behavior. Use with caution — these are powerful and can affect core mechanics.
Cart

Cart

Total -