Skip to content
NordBots.
Back to KillStreaks

KillStreaks configuration

The KillStreaks config.json controls how the plugin runs on your Ark Survival Ascended server. Every setting is listed below with what it does and its default value.

Open the configuration editorPrefer clicking to typing? Build the file with sliders and toggles.

Where it lives

Drop the file on your server at ArkApi/Plugins/KillStreaks/config.json then reload the plugin or restart the server. Keep a backup before large changes.

Every setting

General

Debug
togglefalse
Debug: flip to true when you want the noisy log trail in ArkApi.log. Normal servers keep it false.
AutosaveSeconds
number30
AutosaveSeconds: how often the plugin saves streak stats to disk, in seconds. 30 is fine. A smaller number saves more often. A bigger number saves less often.

Commands

Commands: what a player types in chat to reach these. Pick your own words, or blank one out with "" to kill it.

StreakCMD
text"/streak"
show your streak and stats. Add a name to see another player.
TopCMD
text"/topstreaks"
show the best streaks on the server.

Streaks

Streaks: the main rules.

OnlyCountPvP
toggletrue
OnlyCountPvP: set to true so streaks are a pure player versus player thing. Only a kill by another player builds a streak, and only a death to another player ends one. A dino, a fall, or a suicide does not reset your streak. Set to false to make any death end your streak, even a death to the world.
BlockSameTribe
toggletrue
BlockSameTribe: set to true so a kill between tribe mates does not build a streak. This stops a tribe from farming each other for bonuses.
AnnounceFrom
number3
AnnounceFrom: the streak size that starts the server wide call outs. 3 means the first shout is at 3 kills in a row. A bigger number keeps small streaks quiet.
ShutdownAnnounceFrom
number3
ShutdownAnnounceFrom: when a player on a streak this big or bigger dies, the server is told who ended it. 3 means a 3 kill streak or more gets a shutdown shout.
ListCount
number10
ListCount: how many rows the /topstreaks leaderboard shows.
Milestones
list[3,5,10,15,20,25]
Milestones: the streak steps that get a name, a shout, and a bonus. These three lists line up by position. Milestones[0] uses MilestoneNames[0] and BonusPerMilestone[0]. Keep all three lists the same length.
MilestoneNames
list["Killing Spree","Rampage","Dominating","Unstoppable","Godlike","Legendary"]
MilestoneNames: the title shown at each step above. Change these to fit your server.
BonusPerMilestone
list[50,100,250,500,1000,2500]
BonusPerMilestone: the ArkShop points paid at each step above. Set a value to 0 for no points at that step. If ArkShop is off, no points are paid and it is just bragging rights.
MaxBonusPerLife
number5000
MaxBonusPerLife: the most milestone points one player can earn in a single streak run. This caps a long streak so it can not drain the point economy. The count resets to 0 when the player dies. 5000 means one life can pay at most 5000 milestone points.
AnnounceServerRecord
toggletrue
AnnounceServerRecord: set to true to shout to the whole server when a player beats the highest streak the server has ever seen.

FirstBlood

FirstBlood: the first player kill after the server starts.

Enabled
toggletrue
Enabled: set to true to call out the first kill and pay a one time bonus.
Bonus
number100
Bonus: ArkShop points for the first kill. Set to 0 for a shout with no points.

Nemesis

Nemesis: the player who ended your last streak becomes your nemesis. Kill them back to get revenge.

Enabled
toggletrue
Enabled: set to true to track nemesis and revenge.
RevengeBonus
number150
RevengeBonus: ArkShop points paid when you kill the player who ended your streak. Set to 0 for a shout with no points.

Shutdown

Shutdown: the reward for ending someone else's big streak.

BonusEnabled
toggletrue
BonusEnabled: set to true to pay the player who ends a streak.
BonusPerStreakPoint
number25
BonusPerStreakPoint: points paid per kill in the streak you ended. If you end a 10 kill streak and this is 25, you earn 250 points before the cap.
MaxBonus
number2000
MaxBonus: the most a single shutdown can pay. This caps huge streaks so one kill does not pay too much. 2000 means a shutdown pays at most 2000 points.

AntiFarm

AntiFarm: stops two players from trading kills to farm streaks and bonuses.

SameVictimCooldownSeconds
number120
SameVictimCooldownSeconds: if you kill the same player again inside this many seconds, that kill does not build your streak and pays no bonus. 120 means you must wait two minutes before the same target counts again. Set to 0 to turn the guard off.

Permissions

Permissions: gate the admin console commands. Needs Permissions.dll to do anything.

Enabled
toggletrue
Enabled: true makes the plugin ask Permissions before an admin command runs. If Permissions.dll is missing, the admin commands still work from the server console, since the console is trusted.
AdminPermission
text"KillStreaks.Admin"
AdminPermission: the permission node an RCON caller needs for the admin commands.

ArkShop

ArkShop: the points economy for bonuses. Needs ArkShop.dll.

Enabled
toggletrue
Enabled: set to true to pay point bonuses through ArkShop. If ArkShop.dll is missing or this is false, streaks still work but pay no points. It is just bragging rights.

Discord

Discord: post streak highlights to a channel through a webhook.

Enabled
togglefalse
Enabled: true starts the Discord posts. Keep it false and the highlights stay in game only.
WebhookURL
textempty
WebhookURL: the Discord webhook for normal highlights (milestones, first blood, revenge).
AlertWebhookURL
textempty
AlertWebhookURL: an extra webhook for the biggest moments (shutdowns and server records). Leave it "" to send those to WebhookURL as well.
Username
text"KillStreaks"
Username: whatever name you want on the posts in Discord.
ServerName
text"My ARK Server"
ServerName: the footer label on streak posts. Set it to your server name.

The full commented config

This is a reading copy with notes. It is not valid JSON, so do not load it. Use the editor or the plain config.json instead.

{
  // KillStreaks cheat sheet. Every knob in config.json, spelled out.
  // The notes here mean the server can not read this file, so put your
  // real changes in config.json and keep this one around to look stuff up.

  "General": {
    // Debug: flip to true when you want the noisy log trail in ArkApi.log. Normal servers keep it false.
    "Debug": false,

    // AutosaveSeconds: how often the plugin saves streak stats to disk, in seconds.
    // 30 is fine. A smaller number saves more often. A bigger number saves less often.
    "AutosaveSeconds": 30
  },

  // Commands: what a player types in chat to reach these. Pick your own words, or blank one out with "" to kill it.
  "Commands": {
    "StreakCMD": "/streak",     // show your streak and stats. Add a name to see another player.
    "TopCMD": "/topstreaks"     // show the best streaks on the server.
  },

  // Streaks: the main rules.
  "Streaks": {
    // OnlyCountPvP: set to true so streaks are a pure player versus player thing. Only a
    // kill by another player builds a streak, and only a death to another player ends one.
    // A dino, a fall, or a suicide does not reset your streak. Set to false to make any
    // death end your streak, even a death to the world.
    "OnlyCountPvP": true,

    // BlockSameTribe: set to true so a kill between tribe mates does not build a streak.
    // This stops a tribe from farming each other for bonuses.
    "BlockSameTribe": true,

    // AnnounceFrom: the streak size that starts the server wide call outs. 3 means the
    // first shout is at 3 kills in a row. A bigger number keeps small streaks quiet.
    "AnnounceFrom": 3,

    // ShutdownAnnounceFrom: when a player on a streak this big or bigger dies, the server
    // is told who ended it. 3 means a 3 kill streak or more gets a shutdown shout.
    "ShutdownAnnounceFrom": 3,

    // ListCount: how many rows the /topstreaks leaderboard shows.
    "ListCount": 10,

    // Milestones: the streak steps that get a name, a shout, and a bonus. These three
    // lists line up by position. Milestones[0] uses MilestoneNames[0] and BonusPerMilestone[0].
    // Keep all three lists the same length.
    "Milestones": [3, 5, 10, 15, 20, 25],

    // MilestoneNames: the title shown at each step above. Change these to fit your server.
    "MilestoneNames": ["Killing Spree", "Rampage", "Dominating", "Unstoppable", "Godlike", "Legendary"],

    // BonusPerMilestone: the ArkShop points paid at each step above. Set a value to 0 for
    // no points at that step. If ArkShop is off, no points are paid and it is just bragging rights.
    "BonusPerMilestone": [50, 100, 250, 500, 1000, 2500],

    // MaxBonusPerLife: the most milestone points one player can earn in a single streak run.
    // This caps a long streak so it can not drain the point economy. The count resets to 0
    // when the player dies. 5000 means one life can pay at most 5000 milestone points.
    "MaxBonusPerLife": 5000,

    // AnnounceServerRecord: set to true to shout to the whole server when a player beats
    // the highest streak the server has ever seen.
    "AnnounceServerRecord": true
  },

  // FirstBlood: the first player kill after the server starts.
  "FirstBlood": {
    // Enabled: set to true to call out the first kill and pay a one time bonus.
    "Enabled": true,

    // Bonus: ArkShop points for the first kill. Set to 0 for a shout with no points.
    "Bonus": 100
  },

  // Nemesis: the player who ended your last streak becomes your nemesis. Kill them back
  // to get revenge.
  "Nemesis": {
    // Enabled: set to true to track nemesis and revenge.
    "Enabled": true,

    // RevengeBonus: ArkShop points paid when you kill the player who ended your streak.
    // Set to 0 for a shout with no points.
    "RevengeBonus": 150
  },

  // Shutdown: the reward for ending someone else's big streak.
  "Shutdown": {
    // BonusEnabled: set to true to pay the player who ends a streak.
    "BonusEnabled": true,

    // BonusPerStreakPoint: points paid per kill in the streak you ended. If you end a
    // 10 kill streak and this is 25, you earn 250 points before the cap.
    "BonusPerStreakPoint": 25,

    // MaxBonus: the most a single shutdown can pay. This caps huge streaks so one kill
    // does not pay too much. 2000 means a shutdown pays at most 2000 points.
    "MaxBonus": 2000
  },

  // AntiFarm: stops two players from trading kills to farm streaks and bonuses.
  "AntiFarm": {
    // SameVictimCooldownSeconds: if you kill the same player again inside this many seconds,
    // that kill does not build your streak and pays no bonus. 120 means you must wait two
    // minutes before the same target counts again. Set to 0 to turn the guard off.
    "SameVictimCooldownSeconds": 120
  },

  // Permissions: gate the admin console commands. Needs Permissions.dll to do anything.
  "Permissions": {
    // Enabled: true makes the plugin ask Permissions before an admin command runs. If Permissions.dll is missing, the admin
    // commands still work from the server console, since the console is trusted.
    "Enabled": true,

    // AdminPermission: the permission node an RCON caller needs for the admin commands.
    "AdminPermission": "KillStreaks.Admin"
  },

  // ArkShop: the points economy for bonuses. Needs ArkShop.dll.
  "ArkShop": {
    // Enabled: set to true to pay point bonuses through ArkShop. If ArkShop.dll is missing
    // or this is false, streaks still work but pay no points. It is just bragging rights.
    "Enabled": true
  },

  // Discord: post streak highlights to a channel through a webhook.
  "Discord": {
    // Enabled: true starts the Discord posts. Keep it false and the highlights stay in game only.
    "Enabled": false,

    // WebhookURL: the Discord webhook for normal highlights (milestones, first blood, revenge).
    "WebhookURL": "",

    // AlertWebhookURL: an extra webhook for the biggest moments (shutdowns and server records).
    // Leave it "" to send those to WebhookURL as well.
    "AlertWebhookURL": "",

    // Username: whatever name you want on the posts in Discord.
    "Username": "KillStreaks",

    // ServerName: the footer label on streak posts. Set it to your server name.
    "ServerName": "My ARK Server"
  }
}