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.
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"
}
}