Discord bots are invited to servers using an invitation link. Upon using this invite, a server admin is prompted to grant said Discord bot its requested permissions. Permissions in Discord are a way to limit and grant certain abilities to users. Not providing the requested permissions will limit the bot's functionality and may result in error messages.
However granting a bot, any level of permissions can be daunting, thus we have aimed to provide robust documentation of the specific needs for each permission we request.
See the below documentation to further understand permissions and why they are necessary.
The below permissions are what is requested in order for the Steam LFG Service to function.
General Permissions
The below permissions are referred to as general, these do not handle individual messages, rather core features of a server such as channels, roles, and members.
Official Definition: Allows bots to view channels by default (excluding private channels).
Our Intended Use: This allows us to view all channels which are not private. Enabling us to be able to set up LFG Restrictions and Channel Notifications defined when running /setup.
Official Definition: Allows bots to create or delete invites to your Discord server.
Our Intended Use: Servers which Opt-In to the Global LFG Network, authorize us to maintain an invite for external users. This is so they may join LFG Posts via /search or /notify. If the invite is deleted, we will create a new invite in replacement. Opting out of the Global LFG Network will no longer authorize us to provide a invite to external users.
Text Permissions
The below permissions are referred to as text, these only affect individual messages and threads. We will also be able to create Slash Commands, use external emojis, and ping any roles with this.
Official Definition: Allows for sending messages in text channels (does not allow sending messages in threads).
Our Intended Use: This allows us to send in any text channel new LFG Posts created using /host. To restrict which channels we may send new LFG Posts in consider running /setup. Also to send clones of new posts seen on the Global LFG Network, configured using /setup.
Official Definition: Allows for sending messages in threads (does not allow sending messages in text channels).
Our Intended Use: This allows us to send an information message in threads we create for new LFG Posts, with buttons attached to join a match.
Official Definition: Allows for bots to create threads that everyone in a channel can view.
Our Intended Use: This allows us to create and attach a thread to each new LFG Post created using /host. To restrict automatic thread creation consider running /setup.
Official Definition: Allows for bots to create threads only invited users in a channel can view.
Our Intended Use: This feature is restricted to boosted servers only, it simply allows us to create and attach a thread to each new LFG Post created using /host. Then the host can dictate whom to invite to it. To restrict automatic thread creation consider running /setup.
Official Definition: Allows for bots to show embedded content in text or thread channels.
Our Intended Use: This feature is used to display embeds in messages for new LFG Posts upon using /host. It is also used for confirmation messages in various other commands. Embeds simply serve as an alternative to traditional text messages, for they are formatted.
Official Definition: Allows for bots to show attach emojis and buttons to text messages.
Our Intended Use: This feature is used to display buttons on our embeds in messages for new LFG Posts upon using /host. The buttons are crucial to providing an ease of access method to joining lobbies, joining discords, jumping to messages, friending hosts, subscribing to hosts, giving karma, and deleting posts or threads.
Official Definition: Allows for bots to use external emojis from other Discord servers.
Our Intended Use: This feature is used to display custom emojis in the embeds of messages for the various commands we offer.
Official Definition: Allows for bots to use external stickers, a form of emoji alternative akin to gifs, from other Discord servers.
Our Intended Use: This feature is used to display custom stickers in the embeds of messages for the various commands we offer.
Official Definition: Allows for bots to mention or ping @everyone @here and any role even if the "Allow anyone to mention this role" permission is disabled.
Our Intended Use: This feature is used to ping LFG roles defined by server admins using /setup. We will never ping any role, @everyone, or @here unless specifically configured to by server admins through LFG Role Pings.
Official Definition: Allows for bots to delete messages from any user and pin any message.
Our Intended Use: This feature is used to delete valid user responses for certain commands such as /notify, and to delete LFG Posts by admin or host use of the button đī¸ Close Post.
Official Definition: Allows for bots to rename, delete, archive/unarchive, set visibility, and turn on slow mode for public and private threads.
Our Intended Use: This feature is used to create and attach threads to new LFG Posts created using /host, and to delete threads by admin or host use of the button đī¸ Close Thread.
Official Definition: Allows for bots to read previous messages in any channel or thread.
Our Intended Use: This feature is used to ensure we can search for previously posted LFG Posts in order to remove them if a server is using the /setup option Active LFG Posts. As well as to search for Global LFG Posts in order to process Host modifications or deletions.
Official Definition: Allows for bots to use and create commands from applications, including slash commands and context menu commands.
Our Intended Use: This feature is used to enable instakkour various Slash Commands.
Inviting
Below is what is represented to server admins after inviting the Steam LFG Service to their server.
If any questions or issues arise regarding the usage of the above permissions please Contact Us:
Note: For extra security reason, all bot developers are required to enable Two Factor Authentication on their accounts to prevent malicious attempts to rewrite or disrupt owned Discord bots. Thus in turn keeping our member Discord servers even safer.
