Setting up Discord Rich Presence for a FiveM server

#What players and their friends see

#Create the Discord application

Open the Discord developer portal, create a new application and name it after your server — that name is what appears as “Playing …”.

1. Create the application and copy its Application ID from General Information.
2. Open the Rich Presence art assets section and upload your images.
3. Give each image a short lowercase key such as logo or police — you reference the key in code.
4. Upload at 1024×1024; Discord strongly recommends that size for Rich Presence art.

#The client script

Create a small resource with a client script. The natives are client-side and only need to be set once, except the status line, which you refresh as things change.

local APP_ID = '123456789012345678' -- your Application ID

CreateThread(function()
    SetDiscordAppId(APP_ID)

    SetDiscordRichPresenceAsset('logo')
    SetDiscordRichPresenceAssetText('mycity.gg')

    SetDiscordRichPresenceAssetSmall('badge')
    SetDiscordRichPresenceAssetSmallText('Serious RP')

    SetDiscordRichPresenceAction(0, 'Join our Discord', 'https://discord.gg/yourinvite')
    SetDiscordRichPresenceAction(1, 'Website', 'https://mycity.gg')

    while true do
        local players = #GetActivePlayers()
        SetRichPresence(('In the city · %d nearby'):format(players))
        Wait(15000)
    end
end)

fx_version 'cerulean'
game 'gta5'

client_script 'client.lua'

GetActivePlayers() on the client only returns players your client currently knows about (those in scope), not the server total. For the real online count, send it from the server — for example in a state bag or with a periodic event.

#Buttons: rules and good uses

• You get two buttons: index 0 and index 1.
• Each button needs a label and an https:// URL.
• Your own client never shows the buttons — they appear for other people viewing your profile. Test with a second account or ask a friend.
• The best pair: your Discord invite and a website or cfx.re/join/ connect link.

A direct connect link lets friends join with one click. How the cfx.re join link works is covered in server connect links.

#A status line people want to click

The status line is what makes Rich Presence feel alive. Keep it short (it truncates on narrow profiles) and make it about what the player is doing:

• “On duty · LSPD” — read the job from your framework.
• “Driving in Vinewood” — read the zone with GetNameOfZone and a label table.
• “In the queue” — while loading, before the character spawns.

#Troubleshooting