Docs / Getting started / How YourBot works

How YourBot works

In short

YourBot is a Discord bot you add to your server and run from a website. Members use it in Discord, and you turn services on and change their settings on the dashboard.

How YourBot works Members use YourBot in your Discord server. The bot runs the services you turned on. You change what it does on the dashboard at yourbot.gg. Marketplace plugins run on a custom bot. IN DISCORD Your server Members run commands, press buttons, join, chat and talk in voice. THE BOT YourBot The shared YourBot, free, or your own custom bot with a subscription. ON THE WEB The dashboard Turn services on, change settings and choose who can do what. events settings WHAT THE BOT RUNS Ten built-in services, free for every server Analytics Announcements Beacon Events Giveaways Group Finder Sentinel Social Feeds Tickets Voice Channels Welcome Marketplace plugins Extra plugins from other developers. They run on a custom bot only.

The three parts

  • The bot. It sits in your Discord server like a member. It answers commands, posts messages, gives roles and does whatever the services you turned on need. You can use the shared YourBot for free, or run the same platform under your own bot's name and picture with a subscription. See Shared bot vs custom bot.
  • The services. Ten are built in: Analytics, Announcements, Beacon Events, Giveaways, Group Finder, Sentinel, Social Feeds, Tickets, Voice Channels and Welcome. On the dashboard's Services page three of them have longer names: Scheduled Announcements, Sentinel Moderation and Social & Patches. Every one is free for every server and starts switched off until you turn it on. Marketplace plugins from other developers add more, on a custom bot.
  • The dashboard. Sign in at yourbot.gg/servers with Discord and pick your server. There you turn services on, change their settings, choose who can run which command and choose who else can use the dashboard.

What happens when a member uses it

  1. A member does something in Discord: runs a command, presses a button, joins the server or sends a message.
  2. Discord tells YourBot.
  3. The service that handles it checks your settings and, for a command, your Command Access rules. Then it answers, posts or changes something in your server.

The bot can only act where its role and the channel permissions let it. When a permission is missing, a command says what it could not do. The Setup check lists everything the bot is missing.

Each server is separate

Every server has its own settings and data. Nothing is shared between servers unless you turn on a feature that links them, such as a ban network in Sentinel or a Group Finder network. Turning a service off keeps its settings, so you can turn it back on later without starting over.

Where to go next

Was this page helpful?
YourBot docs Reference tables are generated from the code that is running. Ask in Discord