BountyBoard configuration
The BountyBoard 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/BountyBoard/config.json then reload the plugin or restart the server. Keep a backup before large changes.
Every setting
Language
LangAutoFill
SenderName
General
- Debug togglefalse
- Debug: flip this to true and BountyBoard chatters more in ArkApi.log. Keep it false day to day.
- AutosaveSeconds number30
- AutosaveSeconds: how often the plugin saves bounty data to disk. 30 is fine.
Server
- Name textempty
- NameFromParams list["-ServerName=","-serverkey=","-clustermap=","?SessionName="]
- UseSessionName togglefalse
- Id textempty
Cluster
- Enabled toggletrue
- SharedPath textempty
- FolderName text"BountyBoard"
- HeartbeatSeconds number30
- StaleAfterSeconds number180
- ShowOtherMapsInGame toggletrue
Board
- Enabled toggletrue
- WebhookURL textempty
- EveryMinutes number5
- MaxRowsPerMap number5
- MaxMaps number12
- PostWhenEmpty toggletrue
Commands
Commands: what players type in chat. Change any word you like, or make one "" to switch it off.
- BountyCMD text"/bounty"
- place a bounty, or type it alone to see the list.
- TopCMD text"/bountytop"
- show the best bounty hunters.
- MineCMD text"/mybounty"
- show bounties on you and bounties you placed.
- FindCMD text"/bountywho"
Targeting
- MatchCharacterName toggletrue
- MatchPlatformName toggletrue
- MatchTribeName toggletrue
- MatchOldNames toggletrue
- AllowOffline toggletrue
- OfflineDays number30
- FuzzyTypos toggletrue
- MaxTypos number2
- MinTypoLength number3
- ConfirmNearMiss toggletrue
- ShowChoices number5
- PickSeconds number90
- RevengeTarget toggletrue
- RevengeMinutes number30
Bounty
Bounty: the rules.
- MinBounty number100
- MinBounty and MaxBounty: the smallest and biggest points a player can put on one bounty.
- MaxBounty number100000
- BlockSameTribe toggletrue
- BlockSameTribe: set to true so a kill between tribe mates does not pay out. This stops a tribe from farming its own bounties.
- BlockSelf toggletrue
- BlockSelf: set to true so a player can not put a bounty on themselves.
- HouseCutPct number0
- HouseCutPct: the share the server keeps when a bounty is paid. 0.0 means the killer gets the whole pot. 0.1 means the server keeps 10 percent and the killer gets 90.
- NotifyTarget toggletrue
- NotifyTarget: set to true to warn a player when a bounty is placed on them. Set it to false for stealth bounties, where the target does not know they are hunted.
- AnnounceToAll toggletrue
- AnnounceToAll: set to true to tell the whole server when a bounty is placed.
- ExpireHours number0
- ExpireHours: how long a bounty lasts before it is refunded to the placers. 0 means bounties never expire. 48 means a bounty that no one claims in two days gives the points back.
- AnnounceMostWanted toggletrue
- AnnounceMostWanted: set to true to call out the biggest open bounty now and then.
- AnnounceMostWantedMinutes number15
- AnnounceMostWantedMinutes: how often the most wanted call out runs, in minutes. 15 means every 15 minutes. Set AnnounceMostWanted to false to turn it off.
- ListCount number10
- ListCount: how many rows the /bounty list and /bountytop show.
- PingPoolAtOrAbove number100000
- PingPoolAtOrAbove: when a claimed bounty pot is this big or bigger, the Discord post adds an @here ping. Set it very high to never ping.
- AllowHouseBounties toggletrue
Levels
- Enabled toggletrue
- MinTargetLevel number0
- MaxTargetLevel number0
- MinPlacerLevel number0
- MaxLevelsBelowPlacer number0
- WhenLevelUnknown text"allow"
- CheckOnKill toggletrue
- RefreshSeconds number60
- RememberDays number30
Permissions
Permissions: gate who can place a bounty. Needs the Permissions plugin.
- Enabled toggletrue
- Enabled: turn this off and anyone can place a bounty, no Permissions check at all. When it is true and the Permissions plugin is installed, a player needs the "BountyBoard.Use" node. Grant it to your Default group, or normal players can not place a bounty. Admin groups with a wildcard already have it.
- AdminPermission text"BountyBoard.Admin"
- AdminPermission: the node for admin actions. Not required for v1.
- CheckAdminConsole togglefalse
ArkShop
ArkShop: the points economy. When it is on and ArkShop.dll is loaded, bounties use ArkShop points. When it is off or ArkShop is missing, the plugin keeps its own point count per player so it still runs.
- Enabled toggletrue
- Provider text"Auto"
Panel
- Enabled toggletrue
- RowsPerPage number10
- TopCount number10
- BuffTag text"NordBotsUIBuff"
- BuffPath text"NordBotsUI/Buff_NordBotsUI"
- SingletonPath text"Blueprint'/NordBotsUI/NordBotsUI_Singleton.NordBotsUI_Singleton'"
- RequireHandshake togglefalse
ApiUtilsMod
- Enabled toggletrue
- BackdropColor list[0,0,0,0.55]
- ScreenPosition text"Center"
- TextAlign text"Center"
- TextScale number1
- MessageSeconds number6
- AlsoShowInChat toggletrue
MapName
- Pretty toggletrue
- Overrides group
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.
{
// Hey there. This is the BountyBoard guidebook for config.json.
// The notes below mean the server can not read this file, so please leave
// it be and make your changes over in config.json.
"General": {
// Debug: flip this to true and BountyBoard chatters more in ArkApi.log. Keep it false day to day.
"Debug": false,
// AutosaveSeconds: how often the plugin saves bounty data to disk. 30 is fine.
"AutosaveSeconds": 30
},
// Commands: what players type in chat. Change any word you like, or make one "" to switch it off.
"Commands": {
"BountyCMD": "/bounty", // place a bounty, or type it alone to see the list.
"TopCMD": "/bountytop", // show the best bounty hunters.
"MineCMD": "/mybounty" // show bounties on you and bounties you placed.
},
// Bounty: the rules.
"Bounty": {
// MinBounty and MaxBounty: the smallest and biggest points a player can put on one bounty.
"MinBounty": 100,
"MaxBounty": 100000,
// BlockSameTribe: set to true so a kill between tribe mates does not pay out. This
// stops a tribe from farming its own bounties.
"BlockSameTribe": true,
// BlockSelf: set to true so a player can not put a bounty on themselves.
"BlockSelf": true,
// HouseCutPct: the share the server keeps when a bounty is paid. 0.0 means the killer
// gets the whole pot. 0.1 means the server keeps 10 percent and the killer gets 90.
"HouseCutPct": 0.0,
// NotifyTarget: set to true to warn a player when a bounty is placed on them. Set it
// to false for stealth bounties, where the target does not know they are hunted.
"NotifyTarget": true,
// AnnounceToAll: set to true to tell the whole server when a bounty is placed.
"AnnounceToAll": true,
// ExpireHours: how long a bounty lasts before it is refunded to the placers.
// 0 means bounties never expire. 48 means a bounty that no one claims in two days
// gives the points back.
"ExpireHours": 0,
// AnnounceMostWanted: set to true to call out the biggest open bounty now and then.
"AnnounceMostWanted": true,
// AnnounceMostWantedMinutes: how often the most wanted call out runs, in minutes.
// 15 means every 15 minutes. Set AnnounceMostWanted to false to turn it off.
"AnnounceMostWantedMinutes": 15,
// ListCount: how many rows the /bounty list and /bountytop show.
"ListCount": 10,
// PingPoolAtOrAbove: when a claimed bounty pot is this big or bigger, the Discord post
// adds an @here ping. Set it very high to never ping.
"PingPoolAtOrAbove": 100000
},
// Permissions: gate who can place a bounty. Needs the Permissions plugin.
"Permissions": {
// Enabled: turn this off and anyone can place a bounty, no Permissions check at all.
// When it is true and the Permissions plugin is installed, a player needs the
// "BountyBoard.Use" node. Grant it to your Default group, or normal players can not
// place a bounty. Admin groups with a wildcard already have it.
"Enabled": true,
// AdminPermission: the node for admin actions. Not required for v1.
"AdminPermission": "BountyBoard.Admin"
},
// ArkShop: the points economy. When it is on and ArkShop.dll is loaded, bounties use
// ArkShop points. When it is off or ArkShop is missing, the plugin keeps its own point
// count per player so it still runs.
"ArkShop": {
"Enabled": true
},
// Discord: post bounty events to a webhook. Off by default.
"Discord": {
// Enabled: switch this on to send bounty news to Discord. Fill in a WebhookURL too.
"Enabled": false,
// WebhookURL: drop the webhook link for your Discord channel right here.
"WebhookURL": "",
// Username: the name your bounty posts show up under in Discord.
"Username": "BountyBoard",
// ServerName: this shows in the footer of each post. Set it to your server's name.
"ServerName": "My ARK Server"
}
// How to place a bounty: type the command, the player name, then the points.
// For example /bounty John 5000 puts 5000 points on John. If two players add to the
// same target, the pot grows. The killer gets the whole pot, minus the house cut.
// A player name with spaces works too, put the points last: /bounty Big John 5000
}