Discovery Bot Logo Discovery Bot

What is Discovery Bot?

It’s a modular DayZ role-play assistant that connects in-game presence with Discord: POIs, quests, bulletins, gathering/crafting economy, prison enforcement, pigeon messaging, and rich broadcasts. Built for speed, safety, and scalability.

Per-Channel Logging

Cleanly separate POI, Quest, and Bulletin logs into channels you choose.

Multi-Guild Multi-Server

Designed to power many communities without cross-talk.

Secure & Audited

Only the minimum permissions required, with thorough logging.

SQLite Backed

Reliable persistence for POIs, NPCs, economy, players, and logs.

Tech Stack

Everything Discovery Bot Offers

Built as a full operations + roleplay platform. These are the live systems currently available across bot commands and live admin tooling.

World Interaction

  • POIs with custom welcome messaging, embeds, and discovery media.
  • Discovery zones for tutorial, lore, warning, or mission alerts.
  • Discoverables (notes/tapes) with optional world prop spawning.

Quest & Narrative

  • NPC quests with gates (items, roles, prerequisite quests).
  • Proof submission + approval flow with role/material/wallet rewards.
  • Manual prison queue/release plus anti-evasion enforcement controls.

Economy & Crafting

  • Gather zones with material/category allow rules and access models.
  • Recipe-based crafting with role requirements and delivery modes.
  • Wallet/bank economy, trade/pay/sell, and policy + wipe auditing.

Server Operations

  • Nitrado server register/edit/remove, map control, restart, soft wipe.
  • Automated restart schedules with alerts and editing controls.
  • Live player visibility via PLON and optional player-count VC.

Content Delivery

  • Bulletin boards with anonymous posting and image viewing.
  • Broadcasts: text, MP3, voice, and scheduled radio rotation.
  • Pigeon coops: letters, interception gameplay, risk + role gates.

Admin & Safety Tooling

  • Per-type log routing: general, npc_feed, poi, quest, bulletin, economy.
  • Server file controls: upload/download, gameplay/globals editors.
  • Event spawning, JSON spawner, file rotation, rollback, and cleanup.
View Full Command Reference Open Step-by-Step Setup Open Admin Dashboard

Why Discovery Bot?

Discovery Bot connects your DayZ world to Discord with console-safe automation and immersive features. It reads ADM logs, respects server limits, and turns locations into living content: POIs, NPC Quests, Bulletin Boards, and server Broadcasts — all with clean, per-channel logging.

POIs that Tell Stories

Players entering POIs can receive lored DMs, unlock channels, and contribute to stats and leaderboards.

NPC Quest System

Quest zones that DM players on entry with Accept/Later/Refuse. Admin approval flow and optional reward roles.

Bulletin Boards

Anonymous posts inside safe RP zones. Entry grants access and a DM prompt; exit removes access cleanly.

Nitrado Integration

Automated restarts, server restarts on-demand, and safety checks — with rich alerts and clean embeds.

Broadcasts & Radio

Text/MP3/Voice broadcasts and scheduled radio slots. Announce in text and play in voice channels.

Clean Logs & Safety

Per-channel logs (POI/Quest/Bulletin), reduced noise, and scoped permissions for privacy and control.

Core Systems

Points of Interest (POIs)

Create zones with radius, lore, and optional discovery images. Track entries/exits, distance, and stats.

/addpoi <server_name> <name> <x> <z> [radius] [embed_image] [embed_title] [embed_description]

NPC Quests

Spawn quest zones that DM players with interactive buttons. Approve/Reset via admin tools.

/createquest <server_name> <x> <z> <quest_name> <dialogue> [npc_name] [required_items] [required_role] [required_quest] [reward_material] [reward_material_qty] [reward_wallet] [create_reward_role] [dm_embed_image] [dm_attachment] [radius]

Bulletin Boards

Anonymous posting in RP zones; auto role/channel access on entry; image viewer and moderation.

/bulletin_create <name> <x> <z>

Online Players & Voice

Track ALL players online from ADM PlayerList. Optional voice channel with total player count.

/plon <server_name>   ·   /plon_vc_create <server_name>

Server Tools

Add Nitrado servers, set maps, restart servers, and schedule automated restarts with alerts.

/add_server · /set_map · /restart_server · /setautorestart

Broadcasts

Text/MP3/Voice broadcasts, plus scheduled radio with interval playback. Optional role pings.

/broadcast text|mp3|voice · /broadcast schedule

Gathering, Crafting & Economy

Create gather zones, control materials/categories, craft recipes, trade items, and run wallet/bank economies with policy auditing.

/gather zone create · /crafting recipe create · /economy balance · /economy policy_set

Prison & Evasion Control

Core prison enforcement monitors death/relog evasion. Manual queue/release supports per-case ban and restart toggles.

/prison <server_name> @user [remove] [ban_on_death] [ban_on_relog] [relog_threshold] [relog_window_minutes]

Pigeon Coops & Interception

Player letters with flight risk/intercept systems, coop zoning, interceptor roles, and privacy-aware logging modes.

/pigeon create_coop · /pigeon send · /pigeon intercept · /pigeon set_log_mode

Discovery Zones

Create zones that DM players on entry with configurable embeds. Useful for tutorials, warnings, or lore.

/discovery_zone create
/discovery_zone edit
/discovery_zone list
/discovery_zone delete

Discoverables (Notes & Tapes)

Place interactive notes or audio tapes in‑world. Optional prop spawn (Paper/Cassette) via JSON with cleanup.

/note create · /tape create
/note list|edit|delete
/tape list|edit|delete

Quick Setup Guide

Follow these steps to get Discovery Bot running smoothly. Admin permissions are required for setup commands.

1) Connect & Subscribe

2) Register Your Server

Run the following command and fill in all fields accurately.

/add_server server_name:<Alias> token:<NitradoToken> server_id:<ID> [map:<MapName>]

3) Configure Log Channels

Bind dedicated channels for clean logs (optional but recommended).

/setlog type:general channel:#general-logs
/setlog type:poi channel:#poi-logs
/setlog type:quest channel:#quest-logs
/setlog type:bulletin channel:#bulletin-logs
/setlog type:economy channel:#economy-logs
/setlog type:npc_feed channel:#npc-feed

4) Link Players

Link Discord users to in‑game names (required for POI/Quest DM flows).

/linkplayer <server_name> <ingame_name> @user

5) Add Your First POI

Create a POI with location and optional radius and imagery.

/addpoi <server_name> <poi_name> <x> <z> [radius] [embed_image] [embed_title] [embed_description]

6) Enable Bulletin Boards (Optional)

Create a bulletin board zone; entering grants posting access and a DM prompt.

/bulletin_create <board_name> <x> <z>

7) NPC Quest Starter (Optional)

Define a quest zone that DMs players on entry with Accept/Refuse buttons.

/createquest <server_name> <x> <z> <quest_name> <dialogue> [npc_name] [required_items] [required_role] [required_quest] [reward_material] [reward_material_qty] [reward_wallet] [create_reward_role] [dm_embed_image] [dm_attachment] [radius]

8) Automated Restarts (Optional)

Set periodic restarts with multi-stage alerts (10/5/1 mins) and a restart message.

/setautorestart <server_name> <interval_hours> <#alert_channel> [message]

9) Economy / Gathering Starter (Optional)

Create your first gather zone and set a basic economy policy.

/gather zone create <server_name> <zone_name> <x> <z> <radius> [cooldown_minutes]
/economy policy_set <server_name> [...]

10) Manual Prison Controls (Optional)

Queue or release prison manually for a linked online player using case-level overrides.

/prison <server_name> @user [remove] [auto_restart_on_deploy] [auto_restart_on_release] [ban_on_death] [ban_on_relog] [relog_threshold] [relog_window_minutes]
Explore Commands Contact / Support

Recent Command Updates

Key improvements delivered across moderation, economy, and world systems.

Unified Logging

Legacy per-feature log commands were consolidated into one route command:

/setlog type:<general|npc_feed|poi|quest|bulletin|economy> channel:<#channel>

Economy Governance

Staff/trader controls now include policy and audit visibility:

/economy policy_view
/economy policy_set
/economy wipe_audit

Prison Enforcement

Anti-evasion behavior now tracks death/relog signals with configurable case actions.

/prison <server_name> @user [remove] [ban_on_death] [ban_on_relog]

Manual Prison Flow

Staff can queue or release prison manually for linked online players with cleanup support.

/prison <server_name> @user
/prison <server_name> @user remove:true

Gathering & Crafting

Expanded economy gameplay with gather zones and recipe-driven crafting pipelines.

/gather zone ...
/crafting recipe ...

Pigeon System

Added coop-based letter delivery with interception gameplay and role-gated controls.

/pigeon create_coop
/pigeon send
/pigeon intercept

Admin Quick Commands

Servers

/list_servers
/restart_server <server_name>
/set_map <server_name> <map>

Auto Restarts

/viewautorestarts [server_name]
/editautorestart <task_id> [interval] [#channel] [message] [enabled]
/removeautorestart <task_id>

Moderation

/ban @user [reason]
/kick @user [reason]
/purge <amount> [reason]

Security & Privacy

FAQ

Do I need a Nitrado token?

Yes, for server tools (restarts, status, restarts scheduler). POIs/Quests/Bulletin need ADM logs enabled.

Does this work on console?

Yes. The bot is designed around console DayZ servers and ADM log behavior.

Can I use multiple servers per guild?

Yes, based on your subscription plan. Use /add_server for each and select the correct server_name in commands.

How do automated restarts alert players?

The scheduler posts alerts at 10, 5, and 1 minute before the restart, then a final “Restarting” message.

Where do I get help?

Open a setup ticket via our Discord support channel or use the Contact page to reach the team.

What’s the difference between /spawn_event and /spawn_json?

/spawn_event writes XML events (vehicles, statics, infected, items) and can run on a schedule, including toggle windows for infected. /spawn_json uploads a JSON object spawner file for exact object placement (items/props) at coordinates, and adds it to cfggameplay.json.

How do auto-deletes and JSON cleanup work?

When using /spawn_json, you can set an auto-delete time (minutes). The bot tracks and removes the JSON and its cfggameplay.json reference automatically. You can also remove any JSON later via /remove_json (with optional gameplay reference cleanup).

How safe are /editgameplayjson and /globals_edit?

Both commands download, edit, and upload with backups. Edits are scoped to known fields. You can still roll back manually by restoring your saved backup if needed.

What paths can I use with /getserverfile and /uploadserverfile?

These commands are limited to root/custom/db/env/config and the mission folder. Uploads create a timestamped backup before replacing files.

How does File Rotation work?

/rotate_file creates variants for a target file and manages switching them live. /rotate_file_list shows active rotations. /rotate_file_rollback restores the original and cleans up variants and gameplay references.

Who can create Notes & Tapes? Are there cooldowns?

Players can use /note create and /tape create. A 24‑hour per‑user cooldown applies to create; administrators bypass the cooldown. List/Edit/Delete remain admin‑only.

Do Notes & Tapes need a Y (height) value?

Only if you enable prop spawning (spawn_prop:y) to place a Paper/Cassette object. Without prop spawn, Y is optional and the discoverable still works.

What do Discovery Zones send to players? Is there spam control?

Zones DM an embed on entry. The bot rate-limits repeated notifications for the same user/zone. You can edit or delete zones anytime via /discovery_zone.

How do infected toggles work in /spawn_event?

Choose category “Infected” and provide activation_minutes. The horde is active for the window, then deactivates. With an interval set, the schedule re‑activates per cycle.

Why does the Location command show X/Z and a Y now?

/location reads ADM logs and reports X/Y/Z. The map link uses X/Z; Y is shown for admins who need precise spawn heights.

My map link looks off — what should I check?

Ensure your server’s map is set correctly via /set_map. The map URL is based on X/Z and the configured map (Chernarus, Livonia, Sakhal).

Who can use the web dashboard?

Only Discord users who share a guild with the bot and either have Administrator permission or hold a role whose name matches Staff,Moderator,Admin,Owner. Normal players cannot see guild/server data.

How does dashboard login work?

The dashboard uses Discord OAuth2. When you click “Login with Discord” it sends you to discord.com/oauth2/authorize. After you approve, the bot exchanges the code using your client secret and creates a short‑lived session + CSRF token. No passwords are stored.

Why does the dashboard show 401 / 403 or an empty server list?

401 usually means you’re not logged in or the session expired — click “Login with Discord” again. 403 or an empty list typically means your Discord account is not an admin/staff in that guild, or the bot is not in the same guild. Check roles, permissions, and that the bot is online.

Is the dashboard safe to expose over HTTPS?

Yes — it only listens behind HTTPS on www.discovery-bot.co.uk, uses CORS restrictions, HTTP‑only cookies, CSRF tokens, and validates every request against your Discord ID and guild membership. Nitrado tokens are never returned to the browser.

NEW Commands & Features

Recent additions and major upgrades that admins can deploy right away.

Economy, Gathering & Crafting

  • /gather zone create, /gather zone set_access, and allow rules for controlled farming.
  • /economy policy_view, /economy policy_set, and /economy wipe_audit for governance.
  • /crafting recipe ... + delivery/location commands for full craft pipelines.

Prison Enforcement

  • Core anti-evasion enforcement tracks prison death/relog behavior.
  • /prison <server_name> @user queues manual prison for linked online players.
  • remove:true performs release + cleanup, with optional restart/ban overrides.

Pigeon Coops & Interception

  • /pigeon create_coop, config commands, and role-gated interception gameplay.
  • Player-to-player letter flights with distance/risk and weather modifiers.
  • Dedicated alert/log channels and privacy-aware log modes.

Server Files & Config

  • /getserverfile and /uploadserverfile for managed file operations.
  • /editgameplayjson and /globals_edit with backup-first workflows.
  • Safer server-side configuration updates without manual mission-file edits.

Events, JSON & Rotation

  • /spawn_event suite supports recurring/toggle event flows.
  • /spawn_json + /remove_json with cleanup and gameplay reference management.
  • /rotate_file, /rotate_file_list, /rotate_file_rollback for controlled rollouts.

Discovery & Immersion

  • /discovery_zone suite for narrative/tutorial zone messaging.
  • /note ... and /tape ... for discoverables with optional prop spawns.
  • First-find/expiry cleanup behavior keeps world and config files tidy.
Open Full Commands Open Setup Guide

Admin Dashboard

The dashboard is a secure web control panel for Discovery Bot. It currently covers core server administration, content management, and file workflows while command-only systems continue to expand.

URL & Access

Open the dashboard and sign in with your Discord account that manages the guild.

Open Admin Dashboard
  • Login via Discord OAuth2 — no extra account needed.
  • Works only if the bot is online and the API is reachable.
  • Session is stored in an HTTP‑only cookie with CSRF protection.

Permissions & Roles

  • You must be in the guild with the bot.
  • You must either:
    • Have the Discord Administrator permission; or
    • Hold a role whose name is listed in the bot’s DASHBOARD_ALLOWED_ROLES env var.
  • Non‑staff logins will succeed, but server lists will be empty / show “forbidden”.

What It Controls

  • Guilds & servers you have permission on.
  • Linked players and per‑player stats (including POIs, bulletins and quests).
  • POIs, quests, bulletin boards, discovery zones, and discoverables.
  • Events, file rotations, and JSON spawn management.
  • Nitrado files: browse/download/upload, edit cfggameplay/globals, apply presets, configure auto‑restarts.

Roadmap: Economy, gathering/crafting, prison, and pigeon dashboard management are planned for future releases and are currently managed via bot commands.

Note: The dashboard never asks for your Nitrado login. Tokens stay inside the bot’s config and are not visible from the browser.