How to connect FiveM with Discord

You connect FiveM to Discord by linking your Discord account within FiveM's settings, then adding your Discord server to your FiveM server configuration. The process takes about five minutes and requires you to have administrator access to both your Discord server and your FiveM server files. Once linked, your FiveM server will show up in Discord, players can see who is online, and you can set up role-based permissions that carry over from Discord into the game.

The connection works in two directions. First, you authenticate your personal Discord account to FiveM so the platform knows who you are. Second, you configure your FiveM server to recognize your Discord server, which lets FiveM pull member lists and roles from Discord and use them to manage in-game permissions.

Key Takeaways

  • You need administrator permissions on both your Discord server and your FiveM server files to complete the connection.
  • The process involves linking your Discord account in FiveM's settings, then adding your Discord server ID to your FiveM server configuration file.
  • Once connected, Discord roles can automatically grant in-game permissions, so you do not have to manage player access twice.
  • Your FiveM server will appear as a server listing in Discord once the connection is active, making it visible to your community.

Link your Discord account to FiveM

Start by opening FiveM and logging into your account. If you do not have a FiveM account, create one at the FiveM website first. Once logged in, go to your account settings by clicking your username in the top right corner and selecting Settings.

In Settings, find the Connections tab. You will see Discord listed as an option. Click the Discord icon or the connect button next to it. FiveM will open a Discord authorization window asking you to confirm that FiveM can access your Discord account. Review the permissions it is requesting — typically this includes reading your server list and basic profile information — then click Authorize. Discord will confirm the connection and return you to FiveM. Your Discord account is now linked.

Add your Discord server ID to your FiveM server configuration

Next, you need to tell your FiveM server which Discord server to connect to. This happens in your server's configuration file, which is usually named server.cfg. You will need to access your FiveM server files through your hosting provider's control panel or through FTP if you are hosting locally.

Open server.cfg in a text editor. Add a new line with the command setr discord_token "YOUR_DISCORD_BOT_TOKEN" and another line with setr discord_server_id "YOUR_SERVER_ID". You will need to replace the placeholder text with your actual Discord server ID and a bot token. To find your Discord server ID, enable Developer Mode in Discord (User Settings > Advanced > Developer Mode), then right-click your server name and select Copy Server ID. Paste that number into the configuration file.

For the bot token, you will need to create a Discord bot in the Discord Developer Portal. Go to discord.com/developers/applications, click New Application, give it a name, then go to the Bot tab and click Add Bot. Copy the token that appears and paste it into your server configuration file. Save the file and restart your FiveM server.

Set up Discord roles for in-game permissions

Once your server is connected, you can use Discord roles to control in-game permissions. This means a player who has the Moderator role in Discord can automatically have moderator commands available in FiveM without you having to set permissions twice.

In your server configuration file, you can add lines that map Discord roles to in-game groups. For example, add_ace group.admin discord:ROLE_ID allow will give anyone with that Discord role admin access in FiveM. Replace ROLE_ID with the actual ID of the Discord role. To find a role ID, enable Developer Mode in Discord, right-click the role name, and select Copy Role ID. After adding these lines, save the file and restart your server.

Troubleshoot connection problems

If your FiveM server does not appear in Discord after connecting, check that your bot token is correct and that your Discord bot has the necessary permissions. In the Discord Developer Portal, go to your bot's OAuth2 tab, select the bot scope, then check the boxes for Send Messages, Read Messages, and Manage Roles. Copy the generated URL and use it to invite the bot to your Discord server.

If the connection drops or stops working after a restart, verify that your server configuration file was saved correctly and that there are no typos in your server ID or bot token. A single character wrong will break the connection. Restart your FiveM server after making any changes to the configuration file.

If players are not receiving the correct in-game permissions based on their Discord roles, make sure the role IDs in your configuration file match the actual role IDs in Discord. Also confirm that your Discord bot has permission to read roles in your server — this is set in the Discord Developer Portal under the bot's permissions.

What you can do once FiveM and Discord are connected

With the connection active, your FiveM server will display in Discord as a server listing, and players can see how many people are currently playing. You can set up a Discord channel that shows real-time updates about who joined or left the server. Some server owners use this to post announcements that appear both in Discord and in the game.

Role-based permissions mean you can manage access from one place. If you promote someone to moderator in Discord, they automatically get moderator commands in FiveM. If you remove them from the role, they lose those commands. This keeps your permission structure consistent across both platforms and saves you from managing the same people in two separate systems.

Frequently Asked Questions

Do I need to be the Discord server owner to connect FiveM?

No, but you need administrator permissions on the Discord server. If you are not the owner, ask the owner to give you the Administrator role, then you can complete the connection. You also need administrator access to your FiveM server files.

What happens if I disconnect FiveM from Discord later?

Your FiveM server will no longer pull data from Discord, and role-based permissions will stop working. Players will still be able to join the server, but you will need to manage permissions manually in FiveM instead of through Discord roles. You can reconnect at any time by repeating the linking process.

Can multiple Discord servers connect to one FiveM server?

No, one FiveM server connects to one Discord server. If you run multiple FiveM servers, you can connect each one to the same Discord server, but each FiveM server can only recognize one Discord server for permissions and roles.

Will my players see the Discord connection in the game?

Players will not see the technical connection, but they may see Discord-based features you set up, such as a command that shows Discord server information or a system that announces when someone joins the Discord. The connection itself is backend infrastructure that powers those features.