Skip to content
← All docs

The sandbox and its limitations

What the simulated server does, how it works, and what it cannot reproduce.

The sandbox is a SIMULATION. It is not Discord, it does not connect to Discord, and it is not endorsed by Discord.

What it simulates

  • A server with channels, a Tickets category, roles and a few members (including you as owner).
  • Messages, slash commands with typed options, buttons, select menus and modals.
  • Ephemeral replies (only the member who triggered them can see them).
  • Permissions: members without the required permission can't use a command; the bot gets “Missing Permissions (50013)” if it lacks a permission or its role is too low.
  • Time: advance the clock to end giveaways or pass XP cool-downs.

How it works

Your bot is a validated definition (not arbitrary code). The sandbox interprets that same definition with a deterministic engine: the same events always produce the same results. The hosted runtime uses an interpreter with the same rules, so what you see is a close preview.

What it does not reproduce

  • Rate limits, network latency and Discord outages.
  • Channel permission overwrites beyond private ticket channels.
  • Every Discord API error and edge case.
  • Real users, real notifications and third-party bots.
  • Custom code (ZIP/GitHub imports) — that can't be simulated faithfully in a browser.

Validating for real

Before inviting the bot to a large community, deploy it and invite it to a small private test server. That is the only way to verify real permissions, gateway events and API behaviour.