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.

SECURE AI

Local or external provider without exposing the key

AI Chat uses local Ollama by default. You can point it at a service with your own key straight from the panel — no file editing, no platform restart.

In the panel (per bot)

Settings → “AI provider”. Pick the service, endpoint and model, paste your key, then hit “Test connection” before saving: the button shows the real reason a call failed (HTTP status and what the service replied) instead of a generic “ok”.

  • •Local Ollama — no key, no cost
  • •OpenAI, Groq, OpenRouter, DeepSeek, Together, LM Studio, vLLM, llama.cpp, LiteLLM
  • •Anthropic
  • •Google Gemini
  • •Your own service (custom)
  • — The key is write-only: it goes in and never comes back. The panel only shows the last 4 characters.
  • — Changing the endpoint with the key field left empty keeps the key you already saved.
  • — The configuration only takes effect when the bot restarts — the provider is resolved when the plugin is built.
  • — Only the bot's owner sees this section. The platform checks ownership on read and write.
  • — If the configuration is invalid, the bot still starts and only the AI reply is switched off.

On the server (global)

Applies to every bot and is what the plugin falls back to when a bot has no configuration of its own. `external` is still available for existing setups: exact URL + Bearer.

AI_PROVIDER=external
AI_ENDPOINT=https://your-endpoint/v1/generate
AI_API_KEY=write-only-key
AI_MODEL=model
AI_TIMEOUT_MS=15000
AI_RATE_LIMIT_PER_MINUTE=12
AI_ALLOWED_ACTIONS=follow,come,stop,collect,equip

Safety rules

  • ✓ The key never uses NEXT_PUBLIC_ and never returns to the browser — not even in the response that confirms the save.
  • ✓ It lives in a permission-restricted file (0600), not in the database.
  • ✓ Responses pass through schema and size limits.
  • ✓ attack and mine are blocked by default.
  • ✓ Delay, onlyWhisper, and per-player rate limits are enforced.

For local Ollama

AI_PROVIDER=ollama
OLLAMA_URL=http://127.0.0.1:11434
AI_MODEL=llama3.2:1b

If the AI doesn't answer

The chat swallows errors on purpose (an AI failure must not take the bot down), so silence in chat is the normal behaviour when something breaks. Use “Test connection”: it reports the status and the detail the service returned. If the test passes and chat still doesn't answer, check that the requested action is on the allowlist.

← Back to network guide
On this page
  1. In the panel (per bot)
  2. On the server (global)
  3. Safety rules
  4. For local Ollama
  5. If the AI doesn't answer

On this page

  1. In the panel (per bot)
  2. On the server (global)
  3. Safety rules
  4. For local Ollama
  5. If the AI doesn't answer

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 ↑