DzBot Logo
DzBotBots • AI • Automations
FeaturesHow it worksStoreBlogChangelogChatStatus
Sign inCreate account

Buscar

Buscar páginas do site

Navigation

Features
How it works
Store
Blog
Changelog
Chat
Status
Get startedSign in to my account
Browse the documentation
  • How to use DzBot
  • DzBot API
  • DzBot Runner
  • Minecraft network guide
  • Mod compatibility
  • AI provider
  • Server guide (Java, Bedrock and offline)

Guides, API reference and diagnostics — written to be read before you integrate, not after the first error.

  • How to use DzBot
  • DzBot API
  • DzBot Runner
  • Minecraft network guide
  • Mod compatibility
  • AI provider
  • Server guide (Java, Bedrock and offline)

Guides, API reference and diagnostics — written to be read before you integrate, not after the first error.

DzBot Runner

Run your bots straight from your PC

DzBot Runner is a lightweight program that runs your account's bots on your own machine. Install it, connect with your key and hit play on bots located on "My machine (Runner)" — even if the platform goes offline, the bot keeps running.

Open dashboard Create key in profile

01 / How it works

How it works

01

Create your key

On your profile page (Dashboard → Account), in the DzBot Runner section, copy an access key (starts with dzb_rk_…).

02

Install the program

Run the install command below on your PC. It downloads the program, installs to ~/.dzbot and opens the interface in your browser.

03

Connect and play

Paste the key in the interface (or run with --key). Then, in the dashboard, set the bot to "My machine (Runner)" and press play.

02 / Installation

Installation

One command only. No Docker, no manual dependencies — the binary ships everything the bot needs (Java and Bedrock version data).

Linux / macOS
curl -fsSL https://dzbot.com.br/install-runner | bash
Windows (PowerShell)
powershell -ExecutionPolicy Bypass -c "irm https://server.dzbot.com.br/install-runner.ps1 | iex"

On macOS, the first download may ask for confirmation because of Gatekeeper; the installer removes the quarantine flag automatically.

03 / Hybrid mode (offline fallback)

Hybrid mode (offline fallback)

The Runner keeps the last bot commanded by the platform. If server.dzbot.com.br goes offline, the program switches to offline mode and resumes the bot locally — handing control back to the platform as soon as it returns.

Platform offline? No worries

After ~20s without connection, the Runner activates hybrid mode and resumes the last saved bot on your machine. Your bot keeps farming/chatting normally.

Automatic reconnection

The Runner keeps retrying every few seconds. When the platform is back, control is handed over automatically: stop, restart and chat work from the dashboard again.

You stay in control

Don't want that behavior? Run with --no-fallback. In that case, while the platform is offline the Runner just waits for reconnection, without starting bots.

"Offline mode" badge

The interface shows a discreet notice when the Runner is in hybrid mode, so you know why the bot is running outside the cloud.

04 / Frequently asked questions

Frequently asked questions

Do I need to keep my computer on at all times?

Yes — for bots set to "My machine (Runner)", your PC must be on and connected to the internet, since the bot runs on it. For "DzBot server" bots, DzBot's infrastructure keeps everything online.

How many bots can I run on the Runner?

Each connected runner machine receives the bots you hit play on with the "My machine (Runner)" location. The limit is the same as your plan (bots per server and per account).

Does the program send my data to the platform?

The only information shared is what's needed to operate the bot: state (connected/running/stopped), game events (joined, chat, position) and logs. Your key authenticates the connection and can be revoked anytime in your profile.

Does it work on Windows, Linux and macOS?

Yes. The installer downloads the correct binary for your system (x64/arm64). Windows uses PowerShell; Linux/macOS uses curl + bash.

What if the platform goes down while the bot is running?

The bot stays connected to the Minecraft server normally (the game connection doesn't depend on the platform). Also, if the bot drops during an outage, hybrid mode tries to resume it within a minute.

My key was leaked. What should I do?

Revoke the key in your profile and create a new one. Revoked keys are rejected on connection immediately.

Does the bot use my Microsoft account?

It depends on the bot's configured authentication (offline or Microsoft). For Microsoft, activation happens through the platform itself (device code), like cloud bots.

On this page
  1. How it works
  2. Installation
  3. Hybrid mode (offline fallback)
  4. Frequently asked questions

On this page

  1. How it works
  2. Installation
  3. Hybrid mode (offline fallback)
  4. Frequently asked questions

Ready to run your bots on your PC?

Go to the dashboard, create a key in your profile and install the Runner in seconds.

Open dashboard

Independent project

Help DZ Bot keep growing

Your support keeps our servers and APIs running and helps us build new features.

Support DZ Bot→
DZBotDZBot

A web platform to create, configure, and monitor bots, automations, and integrations in one dashboard.

Product

  • Features
  • Platform
  • How it works
  • Pricing

Resources

  • How to use DzBot
  • DzBot API
  • DzBot Runner
  • Minecraft network guide
  • Mod compatibility
  • AI provider
  • Server guide (Java, Bedrock and offline)

Community

  • Blog
  • What's new
  • About DzBot
  • Reviews
  • FAQ
  • Report an issue

Support

  • [email protected]
  • Contact
  • Discord Community
  • System Status

Legal information

  • Privacy
  • Terms of use
© 2026 DZBot · All rights reserved.
What's newVersion & technologiesBack to top ↑