On this page
Roody documentation
The full guide to setting up the bot and getting the most out of every feature. Everything is configured from the web dashboard — no commands needed.
This documentation covers Roody V5 — the current version.
Looking for something specific? Use the search box above or head to the help centre for step-by-step guides.
Getting started #
Adding Roody to your server takes less than a minute. These are the three steps:
Invite the bot
Use the official link and pick your server from the dropdown. You need the Manage Server permission (or to be the owner) to add bots.
Invite RoodyGrant the recommended permissions
Discord will show you every permission Roody needs. Leave them all ticked — if you remove any, some modules will stop working.
Configure it from the dashboard
Sign in with Discord, select your server and switch on the modules you need. We recommend starting with moderation, logs, welcome messages and tickets.
Open the dashboardOnly users with Manage Server can open the dashboard for a given server. The bot needs to sit above any role it is meant to moderate in the role hierarchy.
Modules #
Roody is split into independent modules: switch on only the ones you need and configure each from its own dashboard page.
Moderation
Anti-flood, anti-links, warnings, timeouts.
Tickets
Panel, categories, staff and transcripts.
Economy
Bank, shop, jobs and fishing.
Levels
XP, ranks and /rank cards.
Welcome messages
Messages and cards when members join and leave.
Giveaways
Giveaways with entry requirements and rerolls.
Suggestions
An ideas channel with voting and staff decisions.
Music
Queues, filters, lyrics and search.
Radio
Non-stop music in a voice channel.
Logs
~40 server events, one channel per category.
AntiRaid
Raid protection and member verification.
AI moderation
Toxicity detection that reads the context, powered by AI.
Blacklist
Restrict modules for specific users.
Boosts
Thank the members who boost your server.
Social alerts
Go-live and new video alerts (Twitch/Kick/YouTube).
Scheduled messages
Recurring or one-off messages sent on a schedule.
Role menus
Self-assignable roles with buttons or a dropdown.
Counter channels
Server statistics right in the channel name.
Custom commands
Create your own commands with a prefix.
Threads
Thread management and automatic setup.
Polls
Votes with several options and live results.
Direct messages
Forward the bot's DMs to a staff channel.
Backup
Snapshots of your server configuration.
Birthdays
Wish your members a happy birthday and give them a role.
Temporary channels
Voice channels that create themselves when someone joins.
Counting
Count 1, 2, 3… in a channel, with milestones.
Reminders
Members set their own reminders with /reminder.
Messages
Compose embeds with buttons and post them.
Emojis
Browse the catalogue and manage your server's emojis.
Moderation #
Automatic and manual tools to keep order in your server.
Automatic filters
- Anti-flood — spots spam and punishes it.
- Anti-links — filters out invites and unwanted links.
- Anti-caps — keeps excessive capitals in check.
- Anti-duplicates — removes repeated messages sent in a row.
- Anti-ghostping — warns you when a mention is deleted.
- Blacklist — banned words or phrases (regex supported).
Manual commands
Tickets #
A complete support system with a panel, categories, staff management and HTML transcripts.
- A panel with buttons to open tickets.
- Custom categories (limited to 1 on the Free plan; unlimited on Pro/Team).
- HTML transcripts that are stored and can be linked to.
- Configurable automatic closing after inactivity.
- Staff claiming system and per-member statistics.
Main commands
Economy #
A virtual currency with a bank, a configurable shop, jobs, fishing and PvP minigames. Premium feature (Pro+).
Levels #
XP for activity in text and voice, with /rank cards, ranks and per-level rewards you can configure.
Welcome and goodbye messages #
Customisable messages and cards when members join or leave the server, with dynamic variables and automatic roles.
- Three types: plain text, an embed with an image, or a graphic card generated by the bot.
- Automatic roles on join.
- Invite tracking (who invited each member).
- Variables:
{user},{server},{memberCount},{userMention}, and so on.
Giveaways #
Giveaways with a configurable duration, multiple winners, role requirements, bonus entries by level and rerolls. Premium feature (Pro+).
Suggestions #
A suggestions channel with public voting, automatic threads for discussion and staff decisions (approve or reject with a reason).
Music #
A player with a queue, real-time filters, lyrics and search. Paste a link or type the name and Roody will find it. Premium feature (Pro+).
Radio #
Non-stop music in a voice channel, like a real radio station: nobody has to keep requesting songs.
Global stations (free). Six stations by style — world, latin, pop, urban, chill and retro. It is a real broadcast: the same track plays at the same time on every tuned-in server, so if you join mid-song you pick it up where it is.
Your own schedule (Team). You decide which style plays at each hour, with the hits from the country of your language.
Logs #
Around 40 loggable events grouped into categories (messages, members, roles, channels, voice, threads, boosts, invites, emojis, scheduled events, automod). Each category can have its own destination channel.
Full logs (advanced events such as reactions, threads and scheduled events) are available on Pro/Team. The free plan covers messages and members.
AntiRaid and verification #
Raid protection with detection of mass joins, spam, ban evasion and bots. Optional verification system for new members (captcha or a direct message).
- Mass join detection with a configurable threshold.
- Alt account detection by account age and pattern (Pro+).
- Per-user reputation system (Pro+).
- AI moderation (trainable classifier) (Team).
- Advanced notifications to admins by DM or webhook (Pro+).
AI moderation #
Smart moderation that analyses messages with AI to catch toxicity, insults, harassment and spam that word filters miss: it understands the context, not just a list of terms. Premium feature.
- It combines a fast local classifier with an AI model for the borderline cases.
- Configurable sensitivity threshold and action (warn, delete the message, apply a timeout).
- Channels and roles exempt from the analysis.
- Fully configured from the dashboard.
Blacklist #
The server's internal blacklist: stop specific users from using Roody's modules (level chat, economy, suggestions…) without having to ban them from Discord.
Boosts #
Automatically thank whoever boosts your server with a plain message or an embed in the channel you choose, and optionally give them a special booster role.
- Customisable text message or embed with an image.
- Variables:
{user},{server},{boostCount}. - Optional automatic booster role.
Social alerts #
Post an alert in your server when a creator goes live or uploads a video on Twitch, Kick or YouTube. Customisable message and embed (with a preview in the dashboard) and an optional role mention.
Scheduled messages #
Schedule automatic messages: recurring reminders (daily, weekly…) or a one-off message at a specific date and time, in your server timezone. Premium feature (Pro+).
You can also create and edit them with a live preview from the module page in the dashboard.
Counter channels #
Channels (a locked voice channel or a read-only text one) whose name shows server statistics and refreshes automatically. The bot creates and maintains the channel for you.
- Placeholders:
{members},{humans},{bots},{online},{boosts},{boostTier},{roleMembers},{categoryChannels}. - Free plan: up to 2 counters per server. Unlimited on Pro.
Custom commands #
Create your own auto-reply commands (!rules or !ip, for example) with their own configurable prefix. They are managed from the dashboard.
Threads #
Manage the threads of the channels you choose: a welcome message when a thread is opened, automatic role mentions and automatic archiving after a period of inactivity.
- Welcome message (text or embed) with the
{user}and{threadName}variables. - Role mentions when the thread is created.
- Configurable automatic archiving.
Polls #
Create votes with several options and a live result count, straight from Discord.
Direct messages #
When someone sends the bot a direct message, Roody forwards it to a staff channel in a configurable embed so your team can deal with it. It is set up from the dashboard.
Server backup #
Save snapshots of your server configuration (roles, channels and module settings) so you can restore it if something goes wrong. Scheduled automatic backups are a premium feature (Pro+).
Birthdays #
Each member records their birthday and, on the day, Roody wishes them a happy birthday in the channel you choose. You can also give them a special role for 24 hours.
Temporary voice channels #
You create a "generator" channel: whoever joins it instantly gets their own voice channel, which disappears on its own once it is empty. The owner controls it with buttons (name, user limit, lock it, kick, hand over ownership).
The free plan includes one generator per server. With Pro they are unlimited and you can also set the bitrate, the region and a name template.
Counting #
A channel where the community counts 1, 2, 3… together. You can require that nobody counts twice in a row, decide what happens when someone gets it wrong, and celebrate milestones (reaching 1000, for instance) with a message, a role or economy money.
Reminders #
Your members set their own reminders and Roody nudges them when the time comes, by DM or in the channel. From the dashboard you decide how many each person can have and how far ahead.
Messages #
A composer in the dashboard to write messages with an embed, link buttons and menus, see exactly how they will look and post them in any channel. They are saved, so you can re-edit one you already posted and Roody updates it in Discord.
Emojis #
Browse an emoji catalogue, search by name and add emojis to your server without leaving Discord. It also lists the ones you already have.
Commands #
Roody uses slash commands. Type / in Discord to see the full list, or read the help centre article.
Utility
Profile and network
Moderation
Tickets
Levels
Economy
Betting and games
Fun
Giveaways and suggestions
REST API #
Roody exposes a public REST API so you can plug your own scripts and external tools into it. Read-only for now, available on Pro and Team.
curl https://dashboard.roody.es/api/v1/me \
-H "Authorization: Bearer rdy_YOUR_KEY"
Generate your key at /dashboard/api-keys and read the full documentation of endpoints, quotas and error codes at /api.
Quotas per plan: Pro 60 req/min · Team 600 req/min. Every response includes X-RateLimit-* headers.
Frequently asked questions #
Is Roody free to use?
Yes. Roody is free for general use with every essential module, radio included. Pro adds economy, music, giveaways, custom commands, social alerts, scheduled messages and the REST API; Team also brings AI moderation, the assistant, automatic backups and your own radio schedule.
Can I invite it to several servers?
Yes, with no limit. Each server keeps its own settings and the data never mixes.
Is the bot online 24/7?
Yes, it runs on dedicated servers. You can check the status in real time on the status page.
Is my data safe?
We only store what the bot needs to work (settings, levels, economy and so on). The full detail is in the privacy policy.
How do I report a bug or request a feature?
Through the contact form, on our official Discord server, or by opening an issue if you have access to the repo.
Why are the slash commands not showing up?
Discord can take a few minutes to sync the commands after you invite the bot. If it takes more than an hour, check the bot permissions and read the article "Slash commands are not showing up".
How do I cancel my subscription?
In the dashboard, under "Your plan", press "Manage billing" to open the payment portal, where you can cancel the subscription at the end of the period.
More resources #
Help centre
Step-by-step articles for each module, plus troubleshooting.
REST API
Endpoints, authentication, quotas and examples.
Service status
Real-time availability of the bot, the dashboard and the APIs.
Discord server
Direct support, news and community.
Contact
A form to report bugs or request features.
Pricing
Pro and Team plans with the full feature list.