VIP Killfeed documentation

Getting started

From invite to your first kill in the feed, in about five minutes. You need a Nitrado DayZ server (Xbox or PlayStation; Chernarus, Livonia, Sakhal or Badlands) and Manage Server on your Discord.

Add the bot

Press Add to Discord, pick your server and authorize with every box ticked. The bot needs Manage Channels and Manage Roles to build its channels, never Administrator.

Tip: You get a welcome DM with these steps.

Run `/setup`

A private panel opens. Untick any channel you don't want, optionally limit the player channels to a role (VIP, Member…), then press Create channels. You get the Killfeed Staff role; give it to your moderators.

#killfeed#pvefeed#auto-leaderboard#global-leaderboard#economy#casino#shop#zone-alerts#admin-alerts#ban-log#live-map

Tip: /setup is safe to run again any time: it keeps what exists and rebuilds what is missing. Run it after an update so new commands appear.

Connect Nitrado

On nitrado.net open Developer → Long life tokens, tick only the service scope, create it and copy it. On the /setup panel press Connect Nitrado and paste it into the private form. If the token sees several servers, pick yours, then check the map.

Careful: Never paste the token into a channel or DM. The form is private and the token is encrypted the moment the bot receives it. The service scope cannot spend money or change your account.

Check three Nitrado settings

Admin logs on	The killfeed, stats and alerts read the admin log.
Disable Multi-Account Mitigation: off	Lets the server log device ids, which is how banned players on new accounts are caught.
cfggameplay.json on	Only for in-game shop delivery.

Send a test kill

Press Send a test kill on the panel. A sample appears in #killfeed; real kills follow about a minute after they happen.

Carded or simple: posts start as glass image cards. /killfeed style style:simple, or Post style on the dashboard's Feeds page, switches the kill, death, connection, hit, emote, build and bounty feeds to plain embeds: bold labels, both players' records as text, a colour per kill type (headshots neon purple).

Players link their gamertag

Players run /link name:YourGamertag in #link-gamertag. Linking is what puts them on the global ranks, lets them use the economy and shop, and (with the whitelist on) lets them join at all.

Tip: Paste the announcement from Tell your players into your announcements channel.

The web dashboard

Everything the slash commands do, plus the things that are easier with a mouse.

Log in

Open vipbot.dev/dashboard and log in with Discord. You see every server where you have Manage Server and the bot is set up. Changes run the same handlers as the slash commands and are logged with your Discord id.

Ops black and Ops white

The dashboard opens in Ops black. The half-moon button in the top bar switches to Ops white and remembers your choice.

Factions

Create a faction for someone, add several players at once (each gets the role and a DM), set leader and co-leaders, edit the bio, flag, armband, motto and colour, move bank money, disband.

Zones

Draw circles and polygons on your server's map for watched zones, faction territory and airdrop sites. See Zones.

Ranks and leaderboards

Two rank systems, two boards.

Server ranks

Ten ranks by PvP kills on your server, each with an icon. Pick one of six icon sets, rename the ranks and change the kill counts on the dashboard's Leaderboards page. #auto-leaderboard keeps one message up to date.

Global ranks

A position among every linked player on every server that opts in, by total kills: #212 of 3,142. Cards show it and the climb since the last update. Unlinked players show "Unranked · /link". #global-leaderboard keeps one message up to date.

Board sizes: /killfeed boards server:20 global:30 (10 to 50). Boards over 10 rows render in two columns.

Anti-cheat and PC players

What the bot flags, and what it can ban on its own.

Alerts

Impossible ranges, teleporting, skywalking, boosting, combat logging, headshot ratios, sprees, raids, name changes and banned devices land in #admin-alerts with Ban / Dismiss buttons. Tune thresholds with /alerts set or on the dashboard.

PC players

/pc policy: flag only, ban until linked in Discord, or allow approved players only. Xbox detection uses OpenXBL when a key is set.

Automatic bans

/autoban level:off|high|all decides which alerts ban by themselves. Watched zones can ban on entry, kill or build.

Discord-linked whitelist

/killfeed whitelist enabled:on: only gamertags linked to a Discord account at least 30 days old can join, and a ban also bars that Discord account.

Shop and in-game delivery

Kits spawn at the buyer's drop point after the next restart.

Switch on delivery

Turn on cfggameplay.json in Nitrado, then press Set up shop delivery on the /setup panel (or /shop delivery action:setup). The bot finds your mission folder, backs up cfggameplay.json and adds its delivery file.

The item list

The kit builder starts with Bohemia's official types.xml for your map, from Bohemia's public Central Economy repository, checked for updates daily. Running modded or edited loot? Upload types.xml on the dashboard Shop page, or Read types.xml from server, and kits use yours. /shop catalogue action:default switches back.

Tip: Bohemia has not published a Badlands list yet; Badlands servers get the Chernarus list until they upload their own.

Build kits

Click class names to build a kit of up to 20 different items, each up to 20 deep and 60 objects in all (ten logs and a plank pile, say). Set price, category, stock, a daily restock, a per-player daily limit and an optional role gate.

Tip: Vehicles spawn bare: put 4 wheels, a battery, a spark plug and a radiator in the kit so it drives away.

Players buy

Players /ping on flat open ground, save it as a drop point, then /shop view or Open shop on the pinned board in #shop. A queued order can be cancelled for a refund until the restart.

Factions and territory

Groups of up to 30 with a Discord role, a shared bank and a tag in the killfeed. Faction mates cannot collect bounties on each other.

Roles

One leader, any number of co-leaders (invite, kick, change settings, withdraw) and members. Handing over leadership keeps the old leader as a co-leader.

Identity

Name, [TAG], colour (also the role colour), motto, a bio of up to 500 characters, the in-game flag on their flagpole and the armband members wear. /faction set or the dashboard.

Territory

Staff draw it on the dashboard (Zones, kind Faction territory). When an outsider walks in, the faction role is pinged in #zone-alerts, or the leader and co-leaders get a DM.

Bank

/faction deposit by anyone, /faction withdraw by leaders. Staff can add or remove with a reason; every change is in the faction's history.

Zones

Places on the map the bot watches. Players get base alarms; staff get watched zones, faction territory and airdrop sites.

Base alarms (players)

/zone create while standing at your base (or give x and z). Up to 3 per player, 25 to 500 m. A DM, or a ping in #zone-alerts, when anyone else walks in; faction mates never trigger it.

Watched zones (staff)

An alert in #admin-alerts when a player enters, kills or builds inside. Up to 25. Optional ban on entry, kill or build with /alerts zone set.

Drawing them

Dashboard → Zones: pick Circle (press and drag) or Polygon (click the corners, then the first point or double-click). Drag a zone to move it, drag its handles to reshape it, then Save zone.

Airdrop sites

Places /airdrop and the automatic drops pick from. Watched zones also count as sites.

Understanding coordinates

Every position in DayZ is metres from the bottom-left corner of the map.

x runs east and z runs north (height is ignored). Chernarus and Sakhal are 15,360 m across, Livonia 12,800 m and Badlands 16,384 m. The bot shows positions as six-digit grid references: 133 082 means 13.3 km east, 8.2 km north.

Tip: on iZurvive, hover the map and read the game coordinates (large numbers like 5917, 10808), not the small GPS-style values. Every grid reference the bot posts links to that spot on iZurvive.

Tell your players

Paste this into your announcements channel.

The killfeed is live! Link your gamertag so your kills count:
• /link name:YourGamertag  (in #link-gamertag)
• /stats and /leaderboard  (in #stats-leaderboards)
• /daily, /work, /trick and /crime to earn credits, /bank to keep them safe  (in #economy)
• /bounty to put a price on someone's head
• /ping, save a drop point, then Open shop in #shop (or /shop view)
• /faction create to start a crew, /zone create for a base alarm
• /report if you see a cheater

Troubleshooting

The usual suspects.

I can't find the bot's commands: Press Ctrl+R to reload Discord, and run /setup once after an update. If other bots crowd the list, type / and click the VIP Killfeed icon, or turn the other bots off in our channels (Server Settings → Integrations).
"The bot is missing …" or "Discord refused": Press Fix bot permissions on the panel and authorize with every box ticked. Still failing: Server Settings → Roles, drag the VIP Killfeed role above the roles it manages.
No kills are showing up: /killfeed status shows the last poll and any Nitrado error. Check admin logs are on; a fresh log only starts after a restart.
Shop delivery can't find cfggameplay.json: Turn it on in Nitrado and restart once so Nitrado creates it, then press Set up shop delivery again and pick your mission folder.
I changed or deleted my Nitrado token: Run /setup and press Reconnect Nitrado with the new token. Stats and settings are kept.
vipbot.dev shows a certificate warning at work or school: That network inspects HTTPS and blocks new domains. Ask its admins to allow vipbot.dev, or use mobile data.

Setup and feeds

Building the channels, connecting Nitrado and choosing what each feed posts.

/setup

Admin

Set the bot up: creates the channels, a staff role and permissions, then connects Nitrado

Usage/setup

/killfeed connect

Admin

tokentextservicetext

Connect a Nitrado server to this Discord

Option	Type	Description
`token`	text	Nitrado long-life token (service scope is enough)
`service` optional	text	Nitrado service ID (the number in the web interface URL). Leave blank to pick.

Usage/killfeed connect token:<text> [service]

/killfeed channel

Admin

feedtextchannelchannel

Where each feed posts

Option	Type	Description
`feed`	text	Which feed `kills` `deaths` `connections` `online` `alerts` `admin` `bank` `bans` `leaderboard` `global` `map` `events` `builds` `zones` `logs` `hits` `emotes`
`channel`	channel	Text channel

Usage/killfeed channel feed:<text> channel:<channel>

Example/killfeed channel feed:kills channel:#killfeed

/killfeed location

Admin

feedtextshowtext

Show or hide grid references and map links in a feed

Option	Type	Description
`feed`	text	Which feed `kills` `deaths` `connections` `online` `alerts` `builds` `hits` `emotes` `all`
`show`	text	Show locations? `on` `off`

Usage/killfeed location feed:<text> show:<text>

/killfeed whitelist

Admin

enabledtextmin_age_dayswhole numberseed_dayswhole number

Discord-linked whitelist: only gamertags linked to a Discord account can join

Option	Type	Description
`enabled` optional	text	On or off (blank: show) `on` `off`
`min_age_days` optional	whole number	Minimum Discord account age in days (default 30, 0 = any)
`seed_days` optional	whole number	When turning on, also whitelist players seen in the last N days (default 30)

Usage/killfeed whitelist [enabled] [min_age_days] [seed_days]

Example/killfeed whitelist enabled:on

/killfeed linking

Admin

rolerolenicknametext

Role and nickname applied when a player /links

Option	Type	Description
`role` optional	role	Role to give (leave empty to clear)
`nickname` optional	text	Set the Discord nickname to the in-game name? `on` `off`

Usage/killfeed linking [role] [nickname]

/killfeed cards

Admin

feedtextshowtext

Glass card images on or off for a feed (off = plain text embeds)

Option	Type	Description
`feed`	text	Which feed `kills` `deaths` `connections` `online` `alerts` `bans` `leaderboard` `map` `bank` `events` `builds` `hits` `emotes` `admin` `commands` `all`
`show`	text	Show cards? `on` `off`

Usage/killfeed cards feed:<text> show:<text>

/killfeed map

Admin

nametext

Map used for iZurvive links

Option	Type	Description
`name`	text	Map `chernarus` `livonia` `sakhal` `badlands`

Usage/killfeed map name:<text>

Example/killfeed map name:Badlands

/killfeed boards

Admin

servertextglobaltext

How many players the server and global rank boards show

Option	Type	Description
`server` optional	text	Server ranks board `10` `20` `30` `40` `50`
`global` optional	text	Global ranks board `10` `20` `30` `40` `50`

Usage/killfeed boards [server] [global]

Example/killfeed boards server:20 global:30

Option	Type	Description
`text` optional	text	Footer

/killfeed namecolor

Admin

hextext

Colour of the bot's name in chat (default neon purple)

Option	Type	Description
`hex` optional	text	Hex colour, e.g. B026FF

Usage/killfeed namecolor [hex]

/killfeed style

Admin

styletext

Carded or simple posts for the kill, death, connection, hit, emote, build and bounty feeds

Option	Type	Description
`style`	text	Style `card` `simple`

Usage/killfeed style style:<text>

Example/killfeed style style:simple

/killfeed global

Admin

showtext

Whether this server's players count on the global leaderboards

Option	Type	Description
`show`	text	Include this server? `on` `off`

Usage/killfeed global show:<text>

/killfeed status

Admin

Show what is connected and when it last polled

Usage/killfeed status

/killfeed test

Admin

Post a sample kill to the kills channel

Usage/killfeed test

/killfeed pause

Admin

Stop polling (keeps settings)

Usage/killfeed pause

/killfeed resume

Admin

Start polling again

Usage/killfeed resume

/killfeed disconnect

Admin

Forget the Nitrado token and stop

Usage/killfeed disconnect

/help

Everyone

topictext

How to set up and use VIP Killfeed

Option	Type	Description
`topic` optional	text	What you need help with `setup` `players` `shop` `admins` `trouble`

Usage/help [topic]

Players and stats

Linking a gamertag, personal stats, ranks and the boards.

/report

Everyone

playertextwhattextlinktext

Report a suspected cheater to the admins

Option	Type	Description
`player`	text	In-game name
`what`	text	What you saw
`link` optional	text	Clip or screenshot link

Usage/report player:<text> what:<text> [link]

/online

Everyone

Who is on the server right now

Usage/online

/stats

Everyone

playertextscopetext

Player stats

Option	Type	Description
`player` optional	text	In-game name (blank = your linked player)
`scope` optional	text	This server or every server on the bot `server` `global`

Usage/stats [player] [scope]

Examples/stats/stats player:Kestrel scope:global

/ranks

Everyone

The rank ladder and where you stand

Usage/ranks

/leaderboard

Everyone

stattextscopetext

Top players, here or across every server

Option	Type	Description
`stat` optional	text	Which stat `kills` `kd` `streak` `longest` `headshots` `hsrate` `playtime` `life` `deaths` `bounties` `rich` `weapons`
`scope` optional	text	This server or every server on the bot `server` `global`

Usage/leaderboard [stat] [scope]

Example/leaderboard stat:kills

/link

Everyone

nametext

Link your Discord account to your in-game name

Option	Type	Description
`name`	text	Your exact in-game name

Usage/link name:<text>

Example/link name:NET ERROR

/unlink

Admin

useruser

Remove your link (admins: unlink someone else)

Option	Type	Description
`user` optional	user	Who to unlink (admin only)

Usage/unlink [user]

/heatmap

Everyone

kindtextdayswhole number

Where players kill and die

Option	Type	Description
`kind` optional	text	Kills or deaths `kills` `deaths`
`days` optional	whole number	How far back (default 7, max 90)

Usage/heatmap [kind] [days]

Economy and casino

Earning, banking, bounties and gambling. Staff tune every rate with /economy.

/bank balance

Everyone

Your cash, bank and recent earnings

Usage/bank balance

/bank top

Everyone

Richest players

Usage/bank top

/bank pay

Everyone

useruseramountwhole number

Send money to another linked player

Option	Type	Description
`user`	user	Who
`amount`	whole number	How much

Usage/bank pay user:<user> amount:<whole number>

Example/bank pay player:Kestrel amount:500

/bank deposit

Everyone

amountwhole number

Move cash into the bank (safe from robbers and bets)

Option	Type	Description
`amount` optional	whole number	How much (blank = all of it)

Usage/bank deposit [amount]

/bank withdraw

Everyone

amountwhole number

Move money from the bank to cash

Option	Type	Description
`amount` optional	whole number	How much (blank = all of it)

Usage/bank withdraw [amount]

/daily

Everyone

Collect your daily reward (streaks pay more)

Usage/daily

/work

Everyone

Do a job for some cash

Usage/work

/crime

Everyone

Risk a fine for a bigger payout

Usage/crime

/trick

Everyone

Run a hustle for quick cash: less risky than crime, pays less

Usage/trick

/rob

Everyone

playertext

Try to steal cash from another player (banked money is safe)

Option	Type	Description
`player`	text	In-game name

Usage/rob player:<text>

/casino blackjack

Everyone

betwhole number

Blackjack against the dealer (hit, stand, double; blackjack pays 3:2)

Option	Type	Description
`bet`	whole number	Bet

Usage/casino blackjack bet:<whole number>

/casino roulette

Everyone

betwhole numberontext

Single-zero roulette

Option	Type	Description
`bet`	whole number	Bet
`on`	text	red, black, green, odd, even, low, high, or a number 0–36

Usage/casino roulette bet:<whole number> on:<text>

/casino slots

Everyone

betwhole number

Three reels; pairs and triples pay

Option	Type	Description
`bet`	whole number	Bet

Usage/casino slots bet:<whole number>

/casino dice

Everyone

betwhole number

Two dice each against the house; higher total wins

Option	Type	Description
`bet`	whole number	Bet

Usage/casino dice bet:<whole number>

/casino double

Everyone

betwhole number

Double or nothing

Option	Type	Description
`bet`	whole number	Bet

Usage/casino double bet:<whole number>

/bounty place

Everyone

playertextamountwhole number

Put a bounty on a player (paid from your balance)

Option	Type	Description
`player`	text	In-game name
`amount`	whole number	Amount

Usage/bounty place player:<text> amount:<whole number>

Example/bounty place player:rotor_wash amount:1000

/bounty list

Everyone

Open bounties

Usage/bounty list

/bounty cancel

Everyone

idwhole number

Cancel your bounty and get a refund

Option	Type	Description
`id`	whole number	Bounty id from /bounty list

Usage/bounty cancel id:<whole number>

/economy list

Admin

Show the earning rules

Usage/economy list

/economy set

Admin

ruletextvaluetext

Change an earning rule (pay, win rates, losses, cooldowns)

Option	Type	Description
`rule`	text	Rule name: start typing, e.g. chance suggestions while you type
`value`	text	New value

Usage/economy set rule:<text> value:<text>

Example/economy set rule:crime_chance value:40

/economy give

Admin

playertextamountwhole numberreasontext

Give money to a player

Option	Type	Description
`player`	text	In-game name
`amount`	whole number	Amount
`reason` optional	text	Reason

Usage/economy give player:<text> amount:<whole number> [reason]

Example/economy give player:Kestrel amount:2500 reason:event prize

/economy take

Admin

playertextamountwhole numberreasontext

Take money from a player

Option	Type	Description
`player`	text	In-game name
`amount`	whole number	Amount
`reason` optional	text	Reason

Usage/economy take player:<text> amount:<whole number> [reason]

/economy serverbounty

Admin

playertextamountwhole number

Place a bounty funded by the server

Option	Type	Description
`player`	text	In-game name
`amount`	whole number	Amount

Usage/economy serverbounty player:<text> amount:<whole number>

Shop and delivery

Items and kits that spawn in game at the buyer's drop point, Discord roles, and staff-delivered orders.

/shop view

Everyone

categorytext

Browse the shop and buy with buttons

Option	Type	Description
`category` optional	text	Jump to a category suggestions while you type

Usage/shop view [category]

/shop list

Everyone

Everything for sale, as a list

Usage/shop list

/shop buy

Everyone

itemtextquantitywhole numberlocationtext

Buy an item (in-game items arrive at your drop point after the next restart)

Option	Type	Description
`item`	text	Item name suggestions while you type
`quantity` optional	whole number	How many (in-game items only, up to 10)
`location` optional	text	Which saved drop point (default: your default one) suggestions while you type

Usage/shop buy item:<text> [quantity] [location]

Example/shop buy item:"M4 Kit"

/shop orders

Admin

minetrue / false

Your recent orders (admins: every open order)

Option	Type	Description
`mine` optional	true / false	Admins: show your own orders instead of the open ones

Usage/shop orders [mine]

/shop cancel

Everyone

orderwhole number

Cancel an in-game order that has not spawned yet (refund)

Option	Type	Description
`order`	whole number	Order number

Usage/shop cancel order:<whole number>

/shop locations

Everyone

Your saved drop points

Usage/shop locations

/shop location

Everyone

nametextactiontextnew_nametext

Rename, remove or make default one of your saved drop points

Option	Type	Description
`name`	text	Saved drop point suggestions while you type
`action`	text	What to do `default` `rename` `remove`
`new_name` optional	text	New name (for rename)

Usage/shop location name:<text> action:<text> [new_name]

/shop add

Admin

nametextpricewhole numberitemstextrolerolecategorytextdescriptiontextstockwhole numberrestockwhole numberlimitwhole numberrequire_rolerole

Add an item or kit

Option	Type	Description
`name`	text	Item name
`price`	whole number	Price
`items` optional	text	Spawn in game: class names, e.g. "M4A1, Mag_STANAG_30Rnd x3" (up to 20 kinds) suggestions while you type
`role` optional	role	Discord role granted on purchase (otherwise an admin delivers it in game)
`category` optional	text	Shop category (default: worked out from the items) suggestions while you type
`description` optional	text	What the player gets
`stock` optional	whole number	How many can be sold (blank = unlimited)
`restock` optional	whole number	Top stock back up to this every day
`limit` optional	whole number	Most one player can buy per day
`require_role` optional	role	Only members with this role can buy it

Usage

/shop add name:<text> price:<whole number> [items] [role] [category] [description] [stock] [restock] [limit] [require_role]

Examples/shop add name:"M4 Kit" price:500 items:"M4A1, Mag_STANAG_30Rnd x3"/shop add name:VIP price:5000 role:@VIP

/shop edit

Admin

nametextnew_nametextpricewhole numberitemstextcategorytextdescriptiontextstockwhole numberrestockwhole numberlimitwhole numberrequire_rolerolehiddentext

Change an item (admin): only the options you give change

Option	Type	Description
`name`	text	Item to change suggestions while you type
`new_name` optional	text	Rename it
`price` optional	whole number	New price
`items` optional	text	New class names (replaces the old list) suggestions while you type
`category` optional	text	Move to a category suggestions while you type
`description` optional	text	New description
`stock` optional	whole number	Set the stock
`restock` optional	whole number	Daily restock level
`limit` optional	whole number	Per-player daily limit
`require_role` optional	role	Role needed to buy it
`hidden` optional	text	Hide it from the shop (keeps order history) `yes` `no`

Usage

/shop edit name:<text> [new_name] [price] [items] [category] [description] [stock] [restock] [limit] [require_role] [hidden]

/shop remove

Admin

nametext

Remove an item

Option	Type	Description
`name`	text	Item name suggestions while you type

Usage/shop remove name:<text>

/shop refund

Admin

orderwhole number

Refund any order

Option	Type	Description
`order`	whole number	Order number

Usage/shop refund order:<whole number>

/shop redeliver

Admin

orderwhole number

Spawn an in-game order again at the next restart

Option	Type	Description
`order`	whole number	Order number

Usage/shop redeliver order:<whole number>

/shop log

Admin

Recent purchases, delivered or not

Usage/shop log

/shop stats

Admin

Sales totals, top items and buyers

Usage/shop stats

/shop board

Admin

channelchannel

Post the live shop board with an Open shop button

Option	Type	Description
`channel` optional	channel	Channel (default: the #shop channel from /setup)

Usage/shop board [channel]

/shop catalogue

Admin

actiontext

The item list kits are built from: Bohemia's official types.xml, or your own

Option	Type	Description
`action` optional	text	What to do `status` `import` `default`

Usage/shop catalogue [action]

Examples/shop catalogue/shop catalogue action:import/shop catalogue action:default

/shop delivery

Admin

actiontextmissiontext

In-game delivery through the Object Spawner

Option	Type	Description
`action` optional	text	What to do `status` `setup` `disable`
`mission` optional	text	Mission folder as Nitrado's file browser shows it, e.g. dayzxb_missions/dayzOffline.nasdara

Usage/shop delivery [action] [mission]

/ping

Everyone

Your last known position; save it as a named shop drop point

Usage/ping

Factions

Player-run groups with a role, a bank, territory and a tag in the killfeed.

/faction create

Everyone

nametexttagtextcolortext

Found a faction

Option	Type	Description
`name`	text	Faction name
`tag`	text	2–5 letter tag
`color` optional	text	Hex colour, e.g. B026FF

Usage/faction create name:<text> tag:<text> [color]

Example/faction create name:"Black Sun" tag:BSUN color:B026FF

/faction join

Everyone

nametext

Join a recruiting faction (or one you were invited to)

Option	Type	Description
`name`	text	Faction name or tag

Usage/faction join name:<text>

/faction leave

Everyone

Leave your faction

Usage/faction leave

/faction invite

Everyone

playertext

Invite a player (leader/co-leader)

Option	Type	Description
`player`	text	In-game name

Usage/faction invite player:<text>

/faction kick

Everyone

playertext

Remove a member (leader/co-leader)

Option	Type	Description
`player`	text	In-game name

Usage/faction kick player:<text>

/faction coleader

Everyone

playertext

Make a member co-leader, or back to member (leader)

Option	Type	Description
`player`	text	In-game name

Usage/faction coleader player:<text>

Example/faction coleader player:Kestrel

/faction leader

Everyone

playertext

Hand leadership to a member (leader)

Option	Type	Description
`player`	text	In-game name

Usage/faction leader player:<text>

/faction set

Everyone

recruitingtextcolortextmottotextbiotextflagpoletextarmbandtextflagtext

Recruiting, colour, motto, bio, flag, armband (leader/co-leader)

Option	Type	Description
`recruiting` optional	text	Open or closed `open` `closed`
`color` optional	text	Hex colour
`motto` optional	text	One line
`bio` optional	text	About your faction, up to 500 characters (\n for a new line)
`flagpole` optional	text	In-game flag, e.g. Pirates, CDF, Wolf (none to clear)
`armband` optional	text	Armband colour or design, e.g. Black, Red, NAPA (none to clear)
`flag` optional	text	Image link

Usage/faction set [recruiting] [color] [motto] [bio] [flagpole] [armband] [flag]

Example/faction set motto:"We own the coast." flagpole:Pirates armband:Black

/faction deposit

Everyone

amountwhole number

Put money into the faction bank

Option	Type	Description
`amount`	whole number	Amount

Usage/faction deposit amount:<whole number>

/faction withdraw

Everyone

amountwhole number

Take money out of the faction bank (leader/co-leader)

Option	Type	Description
`amount`	whole number	Amount

Usage/faction withdraw amount:<whole number>

/faction where

Everyone

Every online member on the map (only you see it)

Usage/faction where

/faction stats

Everyone

Your faction's combined record

Usage/faction stats

/faction info

Everyone

nametext

Look at any faction

Option	Type	Description
`name`	text	Faction name or tag

Usage/faction info name:<text>

/faction list

Everyone

All factions on this server

Usage/faction list

/faction disband

Everyone

Dissolve your faction (leader)

Usage/faction disband

Zones and alerts

Base alarms for players, watched zones and alert rules for staff.

/alerts list

Admin

Show every rule and its current value

Usage/alerts list

/alerts set

Admin

ruletextvaluenumber

Change a rule

Option	Type	Description
`rule`	text	Rule name (see /alerts list)
`value`	number	New value

Usage/alerts set rule:<text> value:<number>

Example/alerts set rule:longshot value:400

/alerts zone add

Admin

nametextxnumberznumberradiusnumber

Alert when someone enters an area

Option	Type	Description
`name`	text	Zone name
`x`	number	East coordinate (m)
`z`	number	North coordinate (m)
`radius`	number	Radius in metres

Usage/alerts zone add name:<text> x:<number> z:<number> radius:<number>

Example/alerts zone add name:"Vostok radar" x:13310 z:8250 radius:600

/alerts zone remove

Admin

nametext

Remove a zone

Option	Type	Description
`name`	text	Zone name

Usage/alerts zone remove name:<text>

/alerts zone list

Admin

List zones

Usage/alerts zone list

/alerts zone ignore

Admin

nametextplayertext

Toggle a player on a zone's ignore list

Option	Type	Description
`name`	text	Zone name
`player`	text	In-game name

Usage/alerts zone ignore name:<text> player:<text>

/alerts zone set

Admin

nametexttracktextbantextrolerole

Tracking, bans and pings for a zone

Option	Type	Description
`name`	text	Zone name
`track` optional	text	What to alert on `all` `entry` `kills` `builds`
`ban` optional	text	Ban players who ... `none` `entry` `kill` `build` `all`
`role` optional	role	Role to ping with each alert from this zone

Usage/alerts zone set name:<text> [track] [ban] [role]

/zone create

Everyone

nametextradiusnumberxnumberznumber

Mark a zone (where you stand now, or at x,z)

Option	Type	Description
`name` optional	text	Zone name
`radius` optional	number	Metres (25–500, default 100)
`x` optional	number	East coordinate (blank = your last position)
`z` optional	number	North coordinate

Usage/zone create [name] [radius] [x] [z]

Example/zone create name:Base radius:100

/zone remove

Everyone

nametext

Remove one of your zones

Option	Type	Description
`name` optional	text	Zone name

Usage/zone remove [name]

/zone ignore

Everyone

playertextzonetext

Toggle a friend on a zone's ignore list (faction mates are always ignored)

Option	Type	Description
`player`	text	In-game name
`zone` optional	text	Zone name (default: your first)

Usage/zone ignore player:<text> [zone]

/zone notify

Everyone

modetextzonetext

DM or a ping in the zones channel

Option	Type	Description
`mode`	text	How to alert you `dm` `channel`
`zone` optional	text	Zone name (default: your first)

Usage/zone notify mode:<text> [zone]

/zone list

Everyone

Your zones

Usage/zone list

Anti-cheat and bans

PC players, automatic bans, the ban list and player lookups.

/ban

Admin

playertextreasontext

Ban a player on the Nitrado server

Option	Type	Description
`player`	text	In-game name
`reason` optional	text	Why

Usage/ban player:<text> [reason]

Example/ban player:Vandal.exe reason:"ESP"

/unban

Admin

playertext

Lift a ban

Option	Type	Description
`player`	text	In-game name

Usage/unban player:<text>

/bans

Admin

Active bans

Usage/bans

/pc policy

Admin

modetext

What happens to PC players

Option	Type	Description
`mode`	text	Policy `flag` `linked` `approved`

Usage/pc policy mode:<text>

Example/pc policy mode:linked

/pc message

Admin

enabledtextinvitetextmissiontext

In-game join message telling PC players to link in Discord (off by default)

Option	Type	Description
`enabled`	text	On or off `on` `off`
`invite` optional	text	Your Discord invite link, e.g. discord.gg/abc123 (needed to turn it on)
`mission` optional	text	Mission folder if the bot cannot find it, e.g. dayzxb_missions/dayzOffline.nasdara

Usage/pc message enabled:<text> [invite] [mission]

/pc allow

Admin

playertext

Allow a PC player

Option	Type	Description
`player`	text	In-game name

Usage/pc allow player:<text>

/pc deny

Admin

playertext

Remove a PC player from the allow list

Option	Type	Description
`player`	text	In-game name

Usage/pc deny player:<text>

/pc list

Admin

Allow list, policy and every player tagged as PC

Usage/pc list

/pc tag

Admin

playertextplatformtext

Mark a player as PC or console by hand

Option	Type	Description
`player`	text	In-game name
`platform`	text	Platform `pc` `console` `unknown`

Usage/pc tag player:<text> platform:<text>

/pc check

Admin

playertext

Ask Xbox Live which device a player is on right now

Option	Type	Description
`player`	text	Gamertag

Usage/pc check player:<text>

/pc hidden

Admin

modetext

What to do with players who hide their Xbox online status

Option	Type	Description
`mode`	text	Mode `flag` `pc` `ignore`

Usage/pc hidden mode:<text>

/pc xbox

Admin

actiontextclient_idtext

The Xbox lookup that tells PC players from console (free OpenXBL key)

Option	Type	Description
`action`	text	What to do `status` `key` `remove` `botkey` `botkey-remove` `link` `unlink`
`client_id` optional	text	Azure app client ID (spare-account link only)

Usage/pc xbox action:<text> [client_id]

/autoban

Admin

leveltext

How aggressively alerts ban automatically

Option	Type	Description
`level` optional	text	Level `off` `high` `all`

Usage/autoban [level]

Example/autoban level:high

/admin search

Admin

playertext

Everything the bot knows about a player

Option	Type	Description
`player`	text	Name, part of a name, or id

Usage/admin search player:<text>

/admin premium

Admin

actiontextservertextplantextdayswhole number

Bot owner only: give or remove a server's plan (unlocks the web dashboard)

Option	Type	Description
`action`	text	What to do `status` `grant` `remove`
`server` optional	text	Server ID (blank = this server)
`plan` optional	text	Plan `lifetime` `monthly` `trial` `comp`
`days` optional	whole number	Days (monthly, trial, or a time-limited comp)

Usage/admin premium action:<text> [server] [plan] [days]

Example/admin premium action:grant plan:comp server:123456789012345678

/admin locate

Admin

playertext

Last logged position of any player

Option	Type	Description
`player`	text	In-game name

Usage/admin locate player:<text>

/admin logins

Admin

playertext

Every RPT line about one player's logins, as a file (device id, BattlEye, PC markers)

Option	Type	Description
`player`	text	Gamertag or player id

Usage/admin logins player:<text>

/admin wipe

Admin

whattextconfirmtext

Reset this server's stats and/or economy (needs confirm:WIPE)

Option	Type	Description
`what`	text	What to wipe `stats` `economy` `all`
`confirm` optional	text	Type WIPE to confirm

Usage/admin wipe what:<text> [confirm]

Server and events

Nitrado controls, airdrops and timed jobs.

/airdrop drop

Admin

sitetextminuteswhole numberrewardwhole numberradiuswhole numbernametext

Announce an airdrop

Option	Type	Description
`site`	text	Zone name, grid like "081 109", or x,z
`minutes` optional	whole number	Minutes until it drops (0 = now)
`reward` optional	whole number	Paid to the first player inside the circle
`radius` optional	whole number	Metres (default 150)
`name` optional	text	Shown name (default: site)

Usage/airdrop drop site:<text> [minutes] [reward] [radius] [name]

Example/airdrop drop site:"North gate" minutes:10 reward:2000

/airdrop schedule

Admin

everywhole numberrewardwhole numbersitestextradiuswhole number

Automatic drops between your watched zones

Option	Type	Description
`every`	whole number	Hours between drops (0 = off)
`reward` optional	whole number	Reward per drop
`sites` optional	text	Zone names, comma separated (blank = all zones)
`radius` optional	whole number	Metres (default 150)

Usage/airdrop schedule every:<whole number> [reward] [sites] [radius]

/airdrop list

Everyone

Upcoming and live airdrops

Usage/airdrop list

/airdrop cancel

Admin

idwhole number

Cancel an airdrop

Option	Type	Description
`id`	whole number	Airdrop id from /airdrop list

Usage/airdrop cancel id:<whole number>

/server status

Admin

Online state, players, version

Usage/server status

/server restart

Admin

messagetext

Restart now

Option	Type	Description
`message` optional	text	Shown to players, if the platform supports it

Usage/server restart [message]

/server start

Admin

Start a stopped server

Usage/server start

/server stop

Admin

confirmtext

Stop the server (needs confirm:STOP)

Option	Type	Description
`confirm` optional	text	Type STOP

Usage/server stop [confirm]

/server setting

Admin

keytextcategorytextvaluetext

Read or change any Nitrado setting

Option	Type	Description
`key` optional	text	Setting key (blank: list the keys)
`category` optional	text	Category (default config) `config` `general`
`value` optional	text	New value (blank: just show it)

Usage/server setting [key] [category] [value]

/server whitelist

Admin

actiontextplayertext

Whitelist entries

Option	Type	Description
`action` optional	text	What to do `list` `add` `remove`
`player` optional	text	Name or id

Usage/server whitelist [action] [player]

/server priority

Admin

actiontextplayertext

Priority-queue entries

Option	Type	Description
`action` optional	text	What to do `list` `add` `remove`
`player` optional	text	Name or id

Usage/server priority [action] [player]

/server damage

Admin

basetextcontainertext

Base and container damage (applies at the next restart)

Option	Type	Description
`base` optional	text	Base building damage `on` `off`
`container` optional	text	Container (tent, barrel, crate) damage `on` `off`

Usage/server damage [base] [container]

/server logs

Admin

kindtext

Download the current log as a file (admin only)

Option	Type	Description
`kind` optional	text	Which log `adm` `rpt`

Usage/server logs [kind]

/schedule add

Admin

kindtextattextdaystextevery_hwhole numberchannelchanneltexttextwarnwhole numberbasetextcontainertextkeytextvaluetextcategorytextheattext

Add a timed job

Option	Type	Description
`kind`	text	What to do `restart` `message` `damage` `setting` `heatmap`
`at`	text	24-hour time, e.g. 06:00 (in the /schedule timezone)
`days` optional	text	daily (default), weekdays, weekends, or mon,wed,fri
`every_h` optional	whole number	Repeat every N hours from that time (e.g. 4 for 02:00, 06:00, 10:00 …)
`channel` optional	channel	Where messages, heatmaps and restart warnings go
`text` optional	text	Message text, or the restart reason
`warn` optional	whole number	Restart: post a warning this many minutes before
`base` optional	text	Damage: base building damage `on` `off`
`container` optional	text	Damage: container damage `on` `off`
`key` optional	text	Setting: key
`value` optional	text	Setting: new value
`category` optional	text	Setting: category (default config) `config` `general`
`heat` optional	text	Heatmap: kills or deaths `kills` `deaths`

Usage

/schedule add kind:<text> at:<text> [days] [every_h] [channel] [text] [warn] [base] [container] [key] [value] [category] [heat]

Example/schedule add kind:restart time:06:00

/schedule list

Admin

All schedules, next and last runs

Usage/schedule list

/schedule remove

Admin

idwhole number

Delete a schedule

Option	Type	Description
`id`	whole number	Schedule id

Usage/schedule remove id:<whole number>

/schedule pause

Admin

idwhole number

Pause or resume a schedule

Option	Type	Description
`id`	whole number	Schedule id

Usage/schedule pause id:<whole number>

/schedule run

Admin

idwhole number

Run a schedule now (timetable unchanged)

Option	Type	Description
`id`	whole number	Schedule id

Usage/schedule run id:<whole number>

/schedule timezone

Admin

tztext

Time zone for every schedule

Option	Type	Description
`tz` optional	text	IANA name, e.g. America/New_York (blank: show)

Usage/schedule timezone [tz]

Nothing matches. Try a shorter word, or Troubleshooting.

Documentation

Getting started

Add the bot

Run /setup

Connect Nitrado

Check three Nitrado settings

Send a test kill

Players link their gamertag

The web dashboard

Log in

Ops black and Ops white

Factions

Zones

Ranks and leaderboards

Server ranks

Global ranks

Anti-cheat and PC players

Alerts

PC players

Automatic bans

Discord-linked whitelist

Shop and in-game delivery

Switch on delivery

The item list

Build kits

Players buy

Factions and territory

Roles

Identity

Territory

Bank

Zones

Base alarms (players)

Watched zones (staff)

Drawing them

Airdrop sites

Understanding coordinates

Tell your players

Troubleshooting

Setup and feeds

Players and stats

Economy and casino

Shop and delivery

Factions

Zones and alerts

Anti-cheat and bans

Run `/setup`