Docs

/setup nitrado | channel | map | view | auto-channels | ...

Connects the bot to your Nitrado server and controls global settings. /setup nitrado (opens a private form for your API token + service ID) comes first ; everything else depends on it. /setup auto-channels is the fast path: creates every feed, dynamic-event, game, and ticket channel in one shot, sorted into their own categories, and sets up the .bOne Admin role at the same time. /remove auto-channels is the off switch (see below). /setup bot-admin-role lets a role besides real server Administrator manage the bot ; /setup mod-role is a lighter tier for day-to-day moderation only (banlist, ticket claim/close, plus whatever else an admin grants via the dashboard's Moderator Permissions page). /setup player-role/ban-role set the two roles /tempban swaps between (see Server Tools below). /setup auto-role role:<@role> assigns that role to every new member ; omit role to turn it off. /setup map / location-format control map and position display. /setup view shows your current config.

Hiding commands from regular members

Every command here is already gated in-code (admin/mod/dev) ; this is an *extra*, Discord-native layer if you also want a command invisible in the / list to anyone without the right role. Server Settings → Integrations → BenchBot, click a command, then toggle its default access or add specific role/channel overrides (allow/deny). Per-server (each server sets its own) and per-command, not per-subcommand ; can take a few minutes to apply. Easy to miss ; most people never open Integrations unless they know to look.

/setup backup-export | backup-import

backup-export downloads an encrypted backup of this server's BenchBot data ; the one-time passphrase shown with it is never stored anywhere, so save it. backup-import file:<> passphrase:<> confirm:true restores from one later, on this server or a different one, completely overwriting whatever's currently saved (a copy of the pre-restore data is kept as a safety net). Nitrado/FTP credentials are redacted either way and always need reconfiguring after a restore.

Admin web dashboard

A browser-based alternative to most admin/moderator commands (27+ areas; server config, rotation, base damage, economy, tickets, moderator permissions, and more), gated behind logging in with your own Discord account ; only shows servers where you're actually an admin or mod, and a mod only sees the sections they've been granted. Not a slash command ; the bot's host operator sets it up (needs a few things configured in Bone.env plus a Discord OAuth redirect).

/remove auto-channels confirm:true

Deletes every channel and category /setup auto-channels created, taking their message history with them ; the confirm option exists specifically so this can't happen by accident. A category is only removed once it's completely empty, so anything you renamed or added manually is left in place instead of guessed at. Safe to run /setup auto-channels again afterward to rebuild everything from scratch.

/status

Live DayZ server status pulled from Nitrado ; online/offline, player count, current map.

/server-monitor set | channel | status

Independent of Nitrado; watches the DayZ server directly via a raw IP:port query (A2S), checked every 60 seconds, so it still works even if Nitrado's own API is having issues. set host:<> port:<> points it at your server (the query port, not the game port; Nitrado's panel lists them separately) ; channel sets where down/back-up alerts post ; status shows a live check plus current config any time.

/online-count setup | remove

A voice channel whose NAME shows the live DayZ online-player count (e.g. "🟢 Online: 12"), updated every few minutes; Discord limits how often a channel name can change, so this isn't instant. setup creates a new voice channel (locked so nobody can actually join it) or points at an existing one if you pass channel; remove stops updating it without deleting the channel.

/resetlogs

Resets the bot's saved ADM/RPT read position and re-reads from the start of the current log files. Use this if a feed seems stuck or missed events after a server-side log rotation.

/logs download | restarts

download type:<rpt|adm> sends the current log file as a downloadable attachment (truncated to the most recent portion if too large for Discord). restarts shows/downloads a 24h history of when the server has actually restarted, with time-since-previous for each ; there's no separate "restart log" from Nitrado, this is the bot's own tracked history.

/restart confirm:true (admin)

Restarts the DayZ server right now, no warning ; immediately disconnects every player. Not delegable via Moderator Permissions ; real Administrator/bot-admin-role only.

/channel create | set | embed-mode | list | visibility

Sets which channel each live feed posts to ; position, connect, disconnect, kill, death, hit, construction, flag, stash, teleport, chat, rotation, vehicle spawns, 7 dynamic-event sub-types (Heli Crash, Military Convoy, Police Car, Police Situation, Santa's Sleigh, Train, Contaminated Area, plus a catch-all), all 7 /detect alerts, Bounty Fulfilled, Achievement Unlocked, an auto-updating Leaderboard, Ticket Log, and more. type is search-as-you-type (too many types for Discord's 25-choice dropdown cap). create makes a new channel ; set type:<> channel:<#existing> points a type at one that already exists instead, with no cap on how many types can share one channel. embed-mode type:<> mode:<batched|individual> picks whether that type posts one grouped embed per poll cycle (default) or a separate embed per event, in real time. /channel visibility multi-selects several channels and flips them all admin-only or public at once.

/rotation setup-ftp | pool | trigger | times | enable | disable | now | status

Swaps which object-spawner file(s) are live in cfggameplay.json. Needs FTP via /rotation setup-ftp, then /rotation pool add (only registers a file *path* ; the JSON must already exist in custom/). pool active-count count:<n> sets how many files are live at once ; status/pool list show the resulting pattern. trigger mode:<> picks what causes a swap ; restart, a fixed interval, or times for specific daily clock times (set a timezone first, times timezone). pool edit updates a file already added.

/createevent

One guided command for Airstrikes, Gas Strikes, Custom Vehicle Spawns, and Hordes ; everything's a dropdown or a short form, nothing to memorize. Pick Create/Browse/Edit Zombie Count/Remove/Scheduled Cleanups, then a category, then whatever it needs (a vehicle from a real list, one or more zombie types, or just coordinates ; a Horde also asks for zone radius and zombie count up front). Every creation can optionally be set to auto-remove itself 15 minutes after your server's next restart. Same FTP credentials as /rotation.

/teleport create | list | remove

In-game teleporters ; standing in the origin box moves a player to destination. Only x/z are required for each point ; height (y) is optional and snaps to the real terrain surface if left out. mode:temporary auto-removes it 15 minutes after your server's next restart, same as /createevent's toggle ; permanent keeps it until you /teleport remove it yourself. direction:one-way only sends origin→destination ; two-way also creates the reverse trip back. marker_classname:<> spawns a visible object (e.g. a sewer cover) at each trigger spot, since the trigger itself is invisible ; unlike y above, this needs a real height or it may spawn buried/floating. list shows what's configured, remove name:<> deletes it, marker included (autocompletes). Same FTP credentials as /rotation.

/ticket panel | quicksetup | createticket | category-add | category-remove | category-list | list

panel posts a persistent "Open a Ticket" button; quicksetup does that plus sets the staff role and log channel in one step. Clicking it (or /ticket createticket) prompts for a category and creates a private channel for that member + the bot-admin role, under an auto-created "Tickets" category (or a parent_category folder per category, e.g. donations vs. support in separate sidebar folders). Categories start with 5 defaults but are fully editable ; category-add label:<> description:<> [parent_category], category-remove index:<>. list shows everything open.

/ticket add | remove | claim | unclaim | transfer | priority | rename | thread | close | closerequest

Run inside an open ticket channel. add/remove a user; claim/unclaim/transfer track who's handling it; priority tags urgency (Low/Medium/High/Urgent, shown in /ticket list and the channel topic); rename the channel; thread opens a private staff-only thread the opener can't see. close [reason] ends it (opener or staff) ; same as the Close Ticket button, just a slash-command alternative; closerequest asks the opener to confirm first instead of closing immediately. A full text transcript (every message, not just metadata) attaches to the closing post in the Ticket Log channel if one's configured.

/ticket closeall (admin)

Closes every currently open ticket in one shot, same as running /ticket close on each ; usable from anywhere, not scoped to a single ticket channel. Handy for a cleanup pass or wiping the board before a server wipe/season reset.

/keyword add | remove | list | channel-add/-remove | channels-add/-remove

Auto-responses ; when someone says a configured keyword in chat, the bot replies automatically. Handy for FAQs, rules reminders, invite links. Fires in every channel by default; channel-add/channel-remove scope one keyword to specific channels, channels-add/channels-remove do the same for every keyword server-wide at once ; list shows each keyword's current scope.

/lootfeed channel | map

channel sets where the condensed summary posts, off by default (REPORT_LOOT). map [days] renders where loot spawned ; color-coded dot per location, top classnames each get a color, legend in the reply.

/casino global-chips

Switches this server's casino games between shared cross-server Chips and local Dollars ; see /game list for what that changes.

/whitelist add | remove | list (admin)

Manages this server's Nitrado whitelist directly ; type in a gamertag and it's added, no need to open the Nitrado panel. list also shows whether whitelist enforcement itself is currently on or off for this server.

/player-hub setup | remove

Posts a "Player Hub" button panel ; Link Gamertag, Balance, Store, My Stats, Leaderboard, all one click, no commands needed. Built for players who aren't comfortable typing slash commands ; Link opens a small popup asking just for a gamertag, same self-service /link set flow underneath. setup [channel] posts it (default: current channel) ; remove stops tracking it without deleting the message.

/embed create | list | send | delete

Build a fully custom embed (title, description, color, image, thumbnail, footer, author, up to 25 fields) through a guided series of popups, with a live preview the whole way. create name:<> channel:<#> starts it ; buttons for each section, then Send Now, Schedule Once (e.g. "in 2h"), Schedule Recurring (days + times + timezone, e.g. every Mon/Wed/Fri at 09:00 and 18:00), or Save as Draft. list shows every saved embed and its schedule, send id:<> re-sends one anytime regardless of any schedule, delete id:<> removes one. Same builder (including both scheduling modes) is also on the dashboard's Embed Builder page, including editing an existing one.

/detect status | toggle | config <name>

Watches the live ADM log for 7 exploit patterns and posts an alert the moment one trips: Underground (clipping below the map), Skywalk (float/rapid altitude gain, incl. sit-then-rise), Dupe (rapid connect-cycling), Boost (Fireplace/Garden Plot stacking + altitude gain), Camping (staying in one small radius), Join-Kill (a kill within minutes of connecting), Raiding (an explosive placed or a base torn down far from that player's own recent movement history). status shows every detector's thresholds, toggle turns any (or all) on/off, config <name> tunes the numbers.

/altcheck

Scans ADM logs for behavioral signs of alt accounts ; fast handoffs between accounts, low overall play footprint, patterns clustering several accounts together. Console DayZ exposes no IP or platform ID to confirm a match, so this is a lead, not a verdict.

/banlist add | remove | dispute | list | search | export

A player watchlist shared across every server this bot is in ; one admin's report is visible everywhere. An entry starts Unverified and becomes Verified once 2+ independent servers report the same gamertag. dispute lets another server flag a report as questionable, flipping it to Disputed instead of deleting it. remove only retracts your own server's report. export dumps the list as plain text.

/economy audit (admin)

Scans the last 24h of /economy pay activity for back-and-forth transfer patterns between two accounts ; a common sign of currency being moved between two accounts one player controls, or laundered between colluding accounts. Scored, not a verdict ; friends genuinely splitting costs can trigger a low score too.

/baseping add | edit | remove | toggle | list (admin)

add name:<> x:<> y:<> radius_m:<> defines a base ; the moment a tracked player's position falls inside it, an alert embed posts with a real @-mention (optionally a faction's leader/co-leader via mention_faction, and/or a specific mention_user). Fires once on entry, not repeatedly while camped inside ; cooldown_min is a jitter backstop, not a periodic reminder. edit changes only the options you pass; toggle turns one off without deleting it. Needs an alert channel; set one per base ping (alert_channel) or a server-wide default in Server Config.

/baseping auto-action | bans | unban (admin)

auto-action name:<> enabled:<> trigger_on:<presence|kill|both> turns on real, escalating Nitrado bans for a zone ; presence (entering it) and/or kill (a kill happened while the killer was inside it; the Conquest-style spawn-kill case). Every offense bans, duration climbs each repeat offense within a rolling window (tier1/tier2/tier3, e.g. 1h/6h/1d, window_days, default 30) ; auto-reverses on schedule, same as /tempban. The banned player gets a DM explaining why, if their gamertag is linked. bans lists everyone currently auto-banned; unban gamertag:<> ends one early.

/purge amount:<1-100> [user] (admin)

Bulk-deletes recent messages in the current channel ; optionally filtered to just one user's messages within the fetched window.

/purgechannels category:<#category> (admin)

Permanently deletes a whole category and every channel inside it, message history included ; shows exactly what's about to go and needs a confirm click first. Separate command from /purge (mixing this into it would've broken /purge amount:<> for everyone already using it).

/basedamage timezone | enable | disable | schedule-add | schedule-remove | schedule-list | containerdamage ...

Schedules base damage (and, separately via containerdamage, container damage) off during set day/time windows ; e.g. protected every night 10pm-6am. Set timezone first, then schedule-add, then enable ; disable turns the whole schedule off without deleting the windows. schedule-list shows each window's # (needed for schedule-remove). Same FTP/file as /rotation, no conflict between them. DayZ only reads this at server startup, so a change is queued and takes hold whenever the server next restarts ; status shows queued vs. live.

/links list | add | remove

A curated list of useful links (rules, resources, socials, ...). list is public; add/remove are admin-only.

/automod config | status | words (admin)

5 independently toggleable checks ; Spam/Flood, Mass Mentions, Discord Invite Links, External Links, and a Censored Word list ; each with its own action (Warn, Delete, Delete + Timeout, or Delete + Ban). config check:<> enabled:<> action:<> sets one up; status shows all 5 at a glance; words add | remove | list manages the censored list. Every hit posts a notice in the channel it happened in.

/tempban start | release | list

Temporarily swaps a member's role (their normal "Player" role off, a "Ban" role on) for a set duration (30m/2h/1d/1w), and bans their DayZ gamertag through Nitrado at the same time ; both auto-reverse together once the sentence is up, or immediately with release. Set the two roles once with /setup player-role/ban-role (existing roles you've already configured yourself ; BenchBot doesn't create or restrict them for you). Gamertag comes from the gamertag option or their /link, if any ; without one, only the Discord-side role swap happens. Can't be used against a real admin or the bot-admin role. list shows everyone currently temp-banned.

/dz-kick start | list

Kicks a player off the DayZ server. No console RCON means no true "disconnect right now" option, so this is a 5-minute auto-reversing in-game ban instead; the closest real equivalent, and Discord-role-free unlike /tempban. Needs a gamertag (gamertag option or their /link) and Nitrado configured. The player gets DMed immediately that it's a kick, not a ban. list shows everyone currently kicked.

/setup bot-trap channel:<#channel> (admin)

Designates a decoy channel ; anyone who posts there (except real Administrators, the bot-admin role, or the bot developer) gets their message deleted and is banned instantly. Meant for a channel with an unremarkable name that only an automated raid/spam bot would ever post in.

/reactionrole create | addrole | removerole | list | remove (admin)

create channel:<#> title:<> posts a panel; addrole message_id:<> emoji:<> role:<@role> attaches an emoji → role mapping to it (adds the bot's own reaction too) ; repeat for as many roles as you want. Members react to get the role, remove their reaction to lose it. removerole undoes one mapping, remove stops tracking a panel entirely (without deleting the message), list shows every panel.

/giveaway start | reroll | list

start prize:<> duration:<30m|2h|1d|1w> winners:<1-20> [channel] posts a giveaway ; react with 🎉 to enter. Ends automatically (checked every 30s), picks winner(s) from whoever reacted at that moment, and announces them. reroll id:<> re-picks winners for an ended giveaway from the current reactors; list shows active and past giveaways.

/suggest, /suggestion resolve | list

/suggest text:<> posts a suggestion to this server's Suggestions channel with 👍/👎 reactions pre-added. /suggestion resolve id:<> status:<accepted|denied|implemented> [reason] (admin) updates the original post to reflect the outcome; list shows everything still pending.

Moderation Log channel

Set one up via /channel create or /setup auto-channels and this bot automatically posts message edits/deletes, joins/leaves, nickname/role changes, and bans/unbans there ; plus every Auto-Mod action and triggered Bot Trap. Nothing is required to turn it on beyond having the channel configured. /channel modlog-exclude channel:<#> stops message edits/deletes in a specific channel from posting there at all (handy for a busy channel where edit/delete noise isn't useful) ; modlog-include undoes it. Only affects message edit/delete logging ; joins, leaves, role changes, and bans still always log.

Welcome channel

Set one up via /channel create type:Welcome or /setup auto-channels and every new member gets a public embed there ; @-mention, their avatar, and a running member count by default. /welcome config customizes the title, message, color, and banner image (with {user}/{username}/{server}/{membercount} tokens), and toggles the avatar/member-count field on or off ; /welcome preview posts it right now using you as a stand-in ; /welcome view shows the current config ; /welcome reset clears all of it back to the default.

Farewell DM (/setup farewell-dm)

Opted in by default ; whenever a member leaves (or is kicked), the bot DMs them a short, personal-toned goodbye thanking them for their time and inviting feedback. /setup farewell-dm choice:No opts this server out entirely. Best-effort either way: silently does nothing if their DMs are closed or the bot is blocked.

/classname search | add | remove | list-custom

1,941 vanilla DayZ classnames with quick-select search as you type, plus any custom/modded classnames an admin has added for this server.

/loadout name:<text> (admin)

Builds a real, server-loadable loadout JSON ; dropdowns for every gear slot, search to reach any item beyond the quick-pick list, attachments for weapons/belts/vests with real compatibility, and cargo, then exports the finished file.

/gun <name>

Looks up a firearm on the Guns Wiki (guns.fandom.com) and returns its info.

/map

Current DayZ map and live player count for this server (needs Nitrado configured).

/distance <from> <to>

Straight-line distance between two towns on the configured map, plus run/drive time and bullet time-of-flight ; quick-select autocomplete on both towns.

/player locations | online | track

locations shows every online player's last known position; online just lists who's connected; track [player] [count] plots recorded position pings on the map ; one named player, or every online player at once in its own color.

/activitylog recent

The last several joins/leaves/kills/positions straight from the live feed.

/bench lift | best | leaderboard | spot

Bench press minigame, earns Plates. Ranks, streaks, injuries, milestones, a full gear loadout.

/range shoot | best | leaderboard

Shooting range minigame, earns Bullets. Same structure as /bench.

/beer drink | leaderboard

Pure flavor minigame, no currency ; anywhere from half a beer to a million in one go.

/casino coinflip | dice | roulette | slots | highlow | blackjack | deposit | withdraw | balance | global-chips

Bets Dollars, or shared Chips if an admin turned that on with /casino global-chips.

/expedition go | sites | inventory | sell | profile | leaderboard | shop | buy

Push-your-luck loot runs, earns Salvage. Bot-wide ranks and leaderboard across every server.

/economy balance | daily | weekly | work | beg | crime | rob | pay | leaderboard

Core Dollars income, plus /economy rob for PvP.

/bank deposit | withdraw

Protects currency from /economy rob.

/perk view | buy, /inventory

Gear for /bench, /range, and general upgrades; /inventory shows what you own.

/leaderboard

Per-server rankings ; Wealth (Dollars), Combat Kills, Combat KDR, and Survival Playtime ; one dropdown, swapped in place like /help. Combat/Survival read real in-game gamertags from the live feed, not Discord accounts (nothing in this bot links the two). Set up a Leaderboard channel via /channel create to also get one auto-updating message showing all 4 at a glance, refreshed as things change.

/faction create | join | leave | kick | promote | bank | admin ...

Self-serve factions ; leader + co-leader roles, a shared Cash bank. create/join/leave act on your own gamertag (optional once linked). join needs a leader/co-leader's /faction accept. kick/promote/demote/transfer-leader manage roles ; bank deposit|withdraw|balance moves Cash in/out the bank (withdraw needs leader/co-leader). disband (leader) or an empty roster ends it.

Weekly Recap Digest

No command ; once a Weekly Recap Digest channel exists (/channel create type:weeklydigest or /setup auto-channels), the bot posts a narrated recap there every 7 days: top killer, most deaths, longest kill, the most-contested zone that week (from real kill locations, not a guess), and top faction if you're using /faction. All "this week" numbers, not the all-time totals /leaderboard already shows.

/link set | remove | status | lookup | admin ...

Links your Discord account to your in-game gamertag (self-attested, same trust level as /faction and /bounty already use ; there's no way to automatically verify you own a gamertag). Once linked, /dz-store's commands no longer need gamertag typed every time. set warns if that gamertag's never played here (confirm:true overrides). lookup/admin subcommands fix disputes/mistakes.

🛒 Corna Store ; /dz-store view | balance | setlocation | buy | pay

A real-item shop, separate from /perk ; priced in Cash (own color/🛒 icon, separate from every Discord-side currency), tracked per gamertag. view browses Items/Kits/My Account via dropdown with a copy-paste buy command. gamertag is optional once you /link set. setlocation [x] [y] [height] saves your spawn point (omit all three to use your last known position); buy item:<>|kit:<> spawns it after your next restart, or pass x/y/height there for one-off coordinates. No location yet? buy offers a 📍 Set Location button right there. pay to_gamertag:<> amount:<> sends Cash to another player directly, no admin needed. Earned from kills, playtime, travel, zones, hits, building, flags ; set up a Cash Earned channel (/channel create). Rates: /dz-store admin.

/dz-store admin item-* | kit-* | zone-* | config | cash-*

Configures the shop. item-add|item-remove define single purchasable items; kit-add|kit-additem|kit-removeitem|kit-remove bundle several classnames under one price. zone-add|zone-remove|zone-list set repeatable Cash-earning areas. config tunes earn rates plus starting_balance for new players. cash-give|cash-take|cash-set adjust one gamertag's balance; cash-give-all pays everyone with a balance at once; cash-wipe permanently deletes the whole ledger after a confirm button ; future touches restart at starting_balance.

/achievements me | dayz | custom-add | role-set | ...

me/dayz gamertag:<> show milestones ; an Achievement Unlocked channel announces live. custom-add label:<> desc:<> source:<> operator:<> threshold:<> [role] builds your own (kills, playtime, net worth, ...), no code ; custom-edit/custom-remove/custom-list manage them, also on the dashboard. role-set/role-remove/role-list (admin) auto-grant a role.

/bounty place | list | cancel | claim | admin config

PvP bounties ; place escrows a reward against a gamertag, auto-fulfills on their next PvP death, claim collects it (self-attested). duration_days and tracking:true (periodic "last seen" pings) cost extra, non-refundable ; only the reward escrows/refunds. admin config tunes min/max reward, duration, tracking cost/frequency, claim window.

/heatmap category:<kills|deaths|dynamic events|vehicle spawns> [days]

Renders a density-map image of where that category has happened, from the same live feed positions. Uses a real map image if dropped in locally, else a coordinate grid + town markers. days limits it to recent activity. Posts to the Heatmap channel if one exists. /setup heatmap-auto posts one on a recurring schedule ; /setup players-heatmap enabled:<> keeps one live map edited in place showing who's online right now.

/slut

Joke income command, 30-minute cooldown.

/ping

Checks the bot's latency.

/whoami

Shows exactly what access level BenchBot currently sees you as in this server ; real Administrator, BenchBot Admin/Moderator role (and which permissions your Moderator role has), and Bot Developer status. Deliberately open to everyone (no permission needed to run it) so it still works to self-diagnose even when something else is wrongly denying you.

/ask

Ask the bot anything ; DayZ questions or general chat. Open to everyone, 30-minute cooldown per person.

/fake-ban

Fake ban command for laughs ; write your own reason, nobody actually gets banned.

/hug, /kiss, /punch, /crashout user:<@member>

Action commands ; flavor text + a random reaction gif aimed at whoever you pick.

/smd, /f__k user:<@member>

Same as above, but crude ; available everywhere, with any spelled-out profanity (including the command name itself) asterisk-censored.

/support

Get an invite to the developer's support server for bug reports, questions, or feature requests.

/dz-income submit hours:<>

Report hours worked for real-world/staff Cash pay ; honor-based, self-reported. Your rate comes from whichever of your roles has one configured (highest, if more than one does) ; nothing pays out until an admin or a granted moderator approves the submission in the review channel, at which point the Cash deposits into your /linked gamertag automatically.

/dz-income admin set-rate | remove-rate | list-rates | channel

Admin-only (reviewing submissions itself is delegable via Moderator Permissions, this configuration isn't). set-rate role:<@role> rate:<> sets what that role pays per hour ; remove-rate deletes one, list-rates shows them all. channel channel:<#> sets where new submissions post with Approve/Reject buttons ; the submitter can never decide their own. Same config is also on the dashboard (guild hub > DZ-Income) with real role/channel dropdowns ; reviewing itself stays Discord-only either way.

/promo

Posts BenchBot's official DayZ Nerd Squad promo card ; handy for partner servers to share.

/help

Shows this menu.

/changelog

Page through what's changed recently, newest first.

/about

Bench's story behind DayZ Nerd Squad and BenchBot, plus credits.