Roody Roody / Docs
  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 Roody

Grant the recommended permissions

Discord will show you every permission Roody needs. Leave them all ticked — if you remove any, some modules will stop working.

View Channels Send Messages Manage Messages Manage Channels Manage Roles Kick Members Ban Members Moderate Members Connect Speak Embed Links Use Application Commands

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 dashboard

Only 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

/banBans a user
/unbanLifts a ban
/kickKicks a user
/timeoutApplies a timeout
/untimeoutRemoves a timeout
/warnWarns a user
/unwarnRemoves a warning
/warnsWarning history
/clearDeletes messages from the channel
/channel lockLocks a channel
/channel unlockUnlocks a channel
/slowmodeTurns slow mode on
/unslowmodeTurns slow mode off
/addroleAdds a role
/unroleRemoves a role

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

/ticket-panelPosts the panel
/addAdds a user to the ticket
/claimClaims the ticket as staff
/closeCloses the current ticket
/renameRenames the ticket
/moveMoves the ticket to another category
/transcriptGenerates a transcript
/ticket-inactiveLists tickets with no activity
/tickets-statsStaff statistics
/leaderboardSupport ranking
/monthly-topTop closed tickets

Economy #

A virtual currency with a bank, a configurable shop, jobs, fishing and PvP minigames. Premium feature (Pro+).

/balanceChecks your balance
/workWork to earn coins
/depDeposits into the bank
/withdrawWithdraws from the bank
/pagarTransfers coins
/stealTries to rob someone
/dueloA duel with coins at stake
/shop viewThe shop catalogue
/items buyBuys an item
/items inventoryThe items you have bought
/fishing pescarFish to earn coins
/fishing venderSells your catch
/fishing pecesYour catches

Levels #

XP for activity in text and voice, with /rank cards, ranks and per-level rewards you can configure.

/rankShows your level card
/topServer ranking
/estadisticasA summary of your activity
/niveles-totalesAggregated global level

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+).

/sorteos crearCreates a new giveaway
/sorteos finalizarEnds it early
/sorteos rerollPicks a winner again

Suggestions #

A suggestions channel with public voting, automatic threads for discussion and staff decisions (approve or reject with a reason).

/suggestSends a suggestion
/decide-suggestionApprove / reject (staff)

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+).

/music playPlays a song or a playlist
/music playnowPlays it right away, skipping the queue
/music searchSearches and lets you pick from the results
/music queueShows the queue
/music nowplayingWhat is playing right now
/music skipSkips to the next one
/music pausePauses playback
/music resumeResumes playback
/music stopStops and clears the queue
/music volumeChanges the volume
/music loopRepeats the song or the queue
/music shuffleShuffles the queue
/music removeRemoves a song from the queue
/music moveMoves a song to another position
/music clearEmpties the queue
/music filtersApplies sound filters live
/music autoplayKeeps going on its own when the queue ends
/music lyricsShows the lyrics
/music historyWhat has played before
/music saveSaves the song to your DMs

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.

/music radio encenderTurns the radio on in your voice channel
/music radio emisoraChanges station
/music radio ahoraWhat is playing on each station
/music radio apagarTurns the radio off

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+).
/antiraidQuick setup from Discord
/verificacionSets up verification
/reglasPosts the server rules
/autoroles crearAutomatic roles on join

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.

/blacklist addAdds a user to the blacklist
/blacklist removerRemoves a user from the blacklist

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.

/alerts addFollows a creator (platform + channel)
/alerts removeStops following a creator
/alerts listLists the alerts you have set up
/alerts testSends a test alert

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+).

/scheduledCreates and manages scheduled messages

You can also create and edit them with a live preview from the module page in the dashboard.

Role menus #

Let members give themselves roles by pressing buttons or picking from a dropdown. Ideal for colour, notification or interest roles. Free module.

/rolemenu publishPosts a menu created in the dashboard
/rolemenu listLists your role menus
/rolemenu deleteDeletes a role menu

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.
/counters createCreates a counter channel
/counters listLists the counters
/counters deleteDeletes a counter

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.

/pollCreates a poll

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.

/birthday setRecords your birthday
/birthday viewChecks somebody else's
/birthday upcomingThe ones coming up
/birthday removeStops showing yours

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.

/reminder createSet a reminder for a date
/reminder repeatA reminder that repeats
/reminder listThe ones you have set
/reminder deleteCancels one

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.

/emojisEmoji panel (administrators only)

Commands #

Roody uses slash commands. Type / in Discord to see the full list, or read the help centre article.

Utility

/helpInteractive help for the bot
/roodyBot utilities: settings, embeds and premium
/aiAsk the assistant (Team)
/userInformation about a user
/serverinfoInformation about the server
/channelinfoInformation about a channel
/roleinfoInformation about a role
/estadisticasServer statistics
/pollCreates a poll
/afkTurns on AFK status
/translateTranslation
/ttsReads a text out loud
/invitesInvite statistics
/reminderSet reminders with a date
/birthdayRecord and check birthdays
/emojisCatalogue and server emojis
/minecraftChecks a Minecraft server
/voteVote for Roody on the bot lists
/autorolesAutomatic roles on join
/countersCounter channels of the server
/rolemenuPosts a role menu
/scheduledScheduled messages
/alertsTwitch, Kick and YouTube alerts

Profile and network

/profileYour public Roody profile
/passportYour identity across every server
/passport-badgeManage your badges
/globalGlobal network ranking

Moderation

/banBans a user
/unbanLifts their ban
/kickKicks a user
/timeoutPuts a user on ice for a while
/untimeoutLets them back in
/warnGives them a warning
/warnsChecks their warnings
/unwarnRemoves one of their warnings
/clearDeletes messages in bulk
/slowmodeTurns slow mode on
/unslowmodeTurns it off
/addroleGives a role
/unroleRemoves a role
/blacklistServer blacklist
/verificacionVerification panel
/antiraidAnti-raid protection
/reglasPosts the rules
/sayMakes Roody say something

Tickets

/ticket-panelPosts the ticket panel
/claimTakes charge of a ticket
/closeCloses the ticket
/addAdds somebody to the ticket
/renameRenames the ticket
/priorityChanges its priority
/transcriptGenerates the transcript
/searchSearches through the tickets
/tickets-statsTicket statistics
/leaderboardStaff ranking
/monthly-topBest staff of the month
/ticket-inactiveMarks a ticket as inactive
/maintenanceTicket maintenance mode

Levels

/rankYour level card
/topServer ranking
/niveles-totalesRanking by total XP

Economy

/balanceYour money
/dailyDaily reward
/workWork to earn money
/depPays into the bank
/withdrawTakes money out of the bank
/pagarTransfers to another member
/stealTries to rob (at your own risk)
/bailPays the bail if you get caught
/achievementsYour achievements
/lotteryServer lottery
/boosterPerks for whoever boosts the server
/shopShop for roles and upgrades
/items buyBuys an item
/items useUses an item
/items inventoryYour inventory
/items giftGives an item away
/items tradeTrades with another member
/fishing pescarGo fishing
/fishing pecesYour fish collection
/fishing venderSells the fish you caught

Betting and games

/economy blackjackPlay blackjack
/economy rouletteRoulette
/economy slotsSlot machine
/economy coinflipHeads or tails
/economy diceRoll the dice
/economy higherlowerHigher or lower
/economy rpsRock, paper, scissors
/dueloChallenge another member

Fun

/8ballAsk the magic 8-ball
/memeRandom meme
/triviaA trivia question
/gameAssorted minigames
/animeAnime search
/pokemonPokémon information
/roleplayActions (hug, kiss, pat, slap, dance...)

Giveaways and suggestions

/sorteosCreates and manages giveaways
/suggestSends a suggestion
/decide-suggestionAccepts or rejects one (staff)

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.

Premium #

Roody has two families of premium products, both at user level:

  • Roody membership — a one-off payment. It works across every Roody project and includes the bot subscription of the same tier.
  • Bot subscription — recurring (monthly or yearly). It covers every server you own.

A server's tier is the tier of the server owner (not of whoever configures it). Once you subscribe, it applies automatically to all of your servers.

See plans and pricing

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 #