Bot permissions
The Discord permissions the Farm Sim Game bot needs for each feature and command, role order, channel overrides, and who can use the dashboard and commands.
On this page
- How to read this page
- What the bot asks for when you invite it
- Every command
- Permissions by feature
- Welcome and invites
- Moderation
- Roles, counters and tickets
- Automation and bot settings
- Game servers
- Permissions by command
- Role hierarchy
- Channel overrides
- Check a channel's permissions
- Who can manage the dashboard
- Who can use commands
- Related
Two kinds of permission decide whether something works: what the bot is allowed to do in your server, and what you and your members are allowed to do. This page lists both. When a feature doesn't post, give a role, or rename a channel, the answer is almost always on this page.
How to read this page#
- Checked by the bot means the bot tests for the permission before it acts. If it's missing, the bot skips the action and usually writes an entry to Bot Error Logs on your dashboard.
- Needed by Discord means the bot doesn't test for it first, but Discord refuses the action without it. Renaming a channel, for example, always needs Manage Channels.
- Permissions are worked out per channel. The bot's role can have a permission and still lose it in one channel through a channel override. See Channel overrides.
What the bot asks for when you invite it#
| Where you click | Permission asked for |
|---|---|
| Add Farm Sim Game to your server (on these docs and the website) | Manage Server |
| A greyed-out server on My Communities, or a faded server icon in the dashboard's server rail | Administrator |
Administrator covers every permission on this page. If you invite with Manage Server only,
add the permissions for the features you use to the bot's role in Server Settings → Roles. /setup
and /botinfo always need the bot to have Administrator. See Add the bot to your server.
Add Farm Sim Game to your server
Every command#
Before any command runs, the bot checks that both the member and the bot have View Channel and Send Messages in that channel. Then it checks any extra permission the command needs.
| What's missing | What you see (deleted after 10 seconds) |
|---|---|
| The member's permission | "You are missing permission permissions, you need them to use this command." |
| The bot's permission | "Bot is missing permission permissions, bot needs them to use this command." |
Permissions by feature#
Welcome and invites#
| Feature | Bot needs | Why | Source |
|---|---|---|---|
| Welcome messages | View Channel, Send Messages (Send Messages in Threads for a thread), Embed Links for the Embed style | To post the welcome | Checked by the bot |
| Welcome image card inside a Components message | Attach Files | The card is sent as a file | Needed by Discord |
| New Member Roles | Manage Roles, role above the roles it gives | To add roles on join | Checked by the bot (Manage Roles) |
| Welcome role buttons and role menus | Manage Roles, role above the role | To add or remove the role on click | Checked by the bot |
| Welcome images | View Channel, Send Messages, Attach Files | The card is uploaded as an image | Checked by the bot |
| Invite tracking | Manage Server | To read your invite links and their use counts | Needed by Discord |
| Invite channels and logs | Send Messages | To post joins, leaves and logs | Checked by the bot |
| Invite Announcements Channel | Send Messages, Add Reactions | Posts the level-up and reacts with 🎉 | Checked by the bot |
| Invite Levelup Roles | Manage Roles, role above those roles | To swap level roles | Checked by the bot (Manage Roles) |
/invite create | Create Invite | To make the invite | Checked by the bot |
| Leave messages and leave log | Manage Messages and Manage Roles server-wide | Without them, each leave adds a Guild Member Remove Log error | Checked by the bot |
Moderation#
| Feature | Bot needs | Why | Source |
|---|---|---|---|
| Warn system log | Send Messages, Embed Links in the Warns Log Channel | To post case embeds | Checked by the bot (Send Messages) |
/mute, /unmute, Mute User apps | Timeout Members, Manage Roles | Discord timeouts and mute roles | Checked by the bot for /mute and /unmute (Manage Roles); Needed by Discord (Timeout Members) |
/kick | Kick Members | To kick | Checked by the bot |
/ban, /unban, auto-ban on rejoin | Ban Members | To ban and unban | Checked by the bot |
/removewarn | Manage Messages | Deletes the case embed from the warn log | Checked by the bot |
| Timeouts logged in the warn log | View Audit Log | To find who gave the timeout and why | Needed by Discord |
| Message filters and image-only channels | Send Messages, Manage Messages in the channel | To delete the message and post the reminder | Checked by the bot |
| Server logs | Send Messages in the log channel, Embed Links | Every log entry is an embed | Checked by the bot (Send Messages) |
| Member Updates Log | Manage Messages and Manage Roles server-wide | Without them, each member change adds a Guild Member Update Log error | Checked by the bot |
/prune | Manage Messages, Read Message History | To bulk delete | Checked by the bot (Manage Messages) |
Roles, counters and tickets#
| Feature | Bot needs | Why | Source |
|---|---|---|---|
| Reaction roles | Add Reactions, Read Message History in the channel | To find the message and add the emoji | Checked by the bot (Add Reactions) |
| Reaction roles: giving the role | Manage Roles, role above the role | To add and remove roles | Checked by the bot (Manage Roles) |
| Counting channel | Send Messages, Manage Messages | Deletes wrong numbers | Checked by the bot |
| Member count channels | Manage Channels on each count channel | Renames the channel | Checked by the bot |
| Ticket system | Manage Channels | Creates the ticket channels and category | Checked by the bot |
| Ticket channel access | Manage Roles | Sets who can see each ticket | Needed by Discord |
| Ticket transcripts | Read Message History | Reads the ticket's messages | Needed by Discord |
| Ticket log | Send Messages in the Tickets Log Channel | Posts ticket events | Checked by the bot |
| Applications | Embed Links, Add Reactions, Create Public Threads, Manage Messages in the Application Log Channel | Posts the application, adds ✅ ⛔, starts a thread, clears reactions | Needed by Discord |
| App Approved Roles | Manage Roles, role above those roles | Gives roles on approval | Needed by Discord |
Automation and bot settings#
| Feature | Bot needs | Why | Source |
|---|---|---|---|
| Auto responder | Send Messages in the channel | Posts the reply | Checked by the bot |
| Timed messages | Send Messages | Posts the message | Checked by the bot |
| Embed builder | Send Messages to post, Manage Messages to update or delete | Keeps one message up to date | Checked by the bot |
| YouTube alerts | Send Messages | Posts the alert | Checked by the bot |
| Bot nickname | Change Nickname | Renames itself | Checked by the bot |
| Pinging a role from any feature | The role set to Allow anyone to @mention this role, or Mention Everyone | Otherwise the mention shows but doesn't notify | Needed by Discord |
Game servers#
| Feature | Bot needs | Why | Source |
|---|---|---|---|
| Online and offline alerts, Offline Notification Channel | Send Messages (Embed Links for Embed Message) | Posts the alert | Checked by the bot (Send Messages) |
| Join, leave and admin alerts, mod changes, player alerts | Send Messages, Embed Links | Posts the alert | Needed by Discord |
| Players Online Display | Manage Channels | Renames the channel | Checked by the bot |
| Overall Playtime Display | Manage Channels | Renames the channel | Needed by Discord |
| Auto Server Stats Embed | View Channel, Send Messages, Embed Links | Posts and edits the embed | Needed by Discord |
| Player and equipment tracking, New Player alerts, Top 25, daily farm stats | Send Messages, Embed Links; Attach Files for maps and activity graphs | Posts embeds and images | Checked by the bot (Send Messages) |
| Playtime roles | Manage Roles, role above the playtime role | Gives the role | Checked by the bot (both) |
| Power manager channel | View Channel, Send Messages | Posts progress. If they're missing, the power manager switches itself off. | Checked by the bot |
| Farm claim alerts | Send Messages, Embed Links | Posts claims to review | Checked by the bot (Send Messages) |
Permissions by command#
Hidden from is Discord's default for the command: members without that permission don't see it. Bot also needs lists what the bot checks on top of View Channel and Send Messages. Every command except the public ones also needs Command roles.
| Command | Hidden from members without | Bot also needs |
|---|---|---|
/setup | Administrator | Administrator |
/botinfo | Administrator | Administrator |
/echo, /say | Administrator | — |
/warn, /removewarn, Warn User, Warn Message User | Timeout Members | Manage Messages for /removewarn |
/mute, /unmute, Mute User, Mute Message User | Timeout Members | Manage Roles for /mute and /unmute (and Timeout Members to time out) |
/kick | Kick Members | Kick Members |
/ban, /unban | Ban Members | Ban Members |
/prune | Manage Messages | Manage Messages |
/invite create | Send Messages | Create Invite |
/server new, /server power ... | Send Messages | — (you also need Manage Server) |
/ticket | Send Messages | Manage Channels to open the ticket |
| Everything else | Send Messages (no permission for User Info) | — |
Full options for each one are on Commands.
Role hierarchy#
Discord only lets a bot manage roles that sit below its own highest role, and only act on members whose highest role is below its own. Role order is set by dragging roles in Server Settings → Roles: higher in the list is higher in rank.
Find the bot's role. It's usually named after the bot.
Move it above every role the bot gives out: New Member Roles, reaction roles, welcome role buttons, Invite Levelup Roles, playtime roles, App Approved Roles and mute roles.
For /mute, /unmute, /kick and /ban, the bot's highest role must also be above the member's highest role.
If the bot's role is too low, roles aren't given. Depending on the feature you see "Unable to manage roles…" in Bot Error Logs, a reply like "I wasn't able to update that role. The owner of this server has been notified.", or "I can not mute that user: their highest role is the same as or above mine."
Anyone who can see a reaction role, welcome button or role menu can use it. Only use plain member roles there, never roles with Administrator, Manage Server or Manage Roles.
Channel overrides#
A channel can override what a role is allowed to do. The bot checks its permissions in the
channel, so a ❌ on Send Messages in one channel stops it posting there, even if its role has
the permission everywhere else. Private channels (ones @everyone can't see) need the bot added
explicitly, unless its role has Administrator.
Check a channel's permissions#
Right-click the channel → Edit Channel → Permissions.
Under Roles/Members, look for the bot's role or the bot itself. If it isn't listed and the channel is private, click + and add it.
Make sure the permissions the feature needs (see the tables above) aren't set to ❌. Set them to ✓, or leave them on / if the bot's role already has them.
Click Save Changes. Check Bot Error Logs on the dashboard after the next event to make sure the error has stopped.
The same applies to whole categories: an override on a category is copied to channels that are synced with it.
Who can manage the dashboard#
The My Community dashboard opens for a Discord server when you are its owner, or have Administrator or Manage Server there. The website checks this every time you open a page. If you lose the permission you see "You do not have Admin permissions for that discord server." and go back to My Communities.
The same rule applies to Game servers and to linking a related Discord server on a support ticket.
Who can use commands#
| Kind | Who | Commands |
|---|---|---|
| Public | Everyone who can send messages in the channel | /bump, /bumps, every /game ... command, /help, /ping, /playtime |
| Administrator only | Members with Administrator | /setup, /echo, /say, /botinfo |
| Role-gated | Administrator, or a role you assign in Command roles | Everything else, like /warn, /ban, /prune, /ticket, /apply, /invite, /server, /userinfo |
A role-gated command with no roles assigned works for Administrators only. Anyone else gets "You do not have the permission to use that command!", visible only to them. A member needs to see the command (Discord's default permission in the table above) and pass the role check. To show a command to a role that lacks the Discord permission, change it in Server Settings → Integrations → Farm Sim Game.