Set up Discord presence
Show your community on players' Discord profiles while they play, with your own Discord app's name, your images, live details like their department and area, and buttons to join your server or Discord.
Discord presence is part of the Mechanics module. While someone plays on your server, their Discord profile shows your community: "Playing Sunnyside RP", your logo, a line like LSPD 1A-12 · Sandy Shores, and up to two buttons, like Join the server.
It uses your own Discord app, so the name and images are yours, not FiveM's.
Before you start#
- Discord presence is in beta, so it's only switched on for some communities for now. If you'd like to try it, ask us in support.
- The Mechanics module needs to be installed.
- Your game server needs the LonexOne FiveM resource, version 0.15.0 or newer. See Install the LonexOne FiveM resource.
- Players only see it when the Discord app is open on the computer they play on.
Make a Discord app#
- Go to discord.com/developers/applications and click New Application.
- Name it what you want players' profiles to say, like Sunnyside RP. Their profile shows "Playing" and this name.
- On General Information, copy the Application ID.
- Open Rich Presence, then Art Assets. Upload your logo and any other images, and give each one a short name, like
logoorbadge. New images can take a few minutes to show in Discord.
You can use an existing app, like your Discord bot's. Its name is what players' profiles show.
Set it up on the website#
- Click Discord presence under Mechanics in the sidebar.
- Tick Show it on players' Discord and paste the Application ID.
- Under What it says, write the Status line. Click a placeholder to add it.
- Under Images, type the names of your art assets, like
logo. A link to an image starting with https:// works too. Fill in what shows when someone points at each image. - Under Buttons, add up to two. Click a suggestion to fill one in from your server's join link, your Discord invite or your website.
- Click Save.
The preview on the right shows how it looks with example values. Players see the change within a minute.
Placeholders#
Each player's game fills these in and updates them every 15 seconds. You can use them in the status line and the text for both images.
| Placeholder | Becomes |
|---|---|
| {community} | Your community's name |
| {name} | The player's name in game |
| {id} | Their server ID |
| {players} and {max} | Players online and server slots |
| {duty} | Their department and callsign on duty, like LSPD 1A-12, or your off-duty text, like Civilian |
| {department}, {callsign} and {status} | Each on its own while they're on duty |
| {street}, {area} and {postal} | Where they are |
| {aop} | Your AOP |
When a placeholder has nothing to show, like {postal} with no postals set up, it's left out along with the · , | - or word like "in" next to it. {duty} in {area} becomes just Civilian rather than Civilian in.
Buttons#
Button links start with https://, or with fivem://connect/ to join a server, like fivem://connect/cfx.re/join/abc123. Discord shows buttons to other people looking at the profile, not to the player themselves.
Something not working?#
Nothing shows on my profile. Check the Discord desktop app is open before you start FiveM, and that Display current activity is on in Discord under Activity Privacy.
The image is a blank square. The name has to match an art asset on the same Discord app, exactly. New images can take a few minutes to appear.
It still says FiveM. The Application ID is missing or wrong, or the resource is older than 0.15.0.
See also
Can't find what you need?
Open a ticket in our Discord and someone from the team will help. Found a bug, or missing a feature? Tell us on the feedback board.