Troubleshooting

Turn on debug output first#

Set Config.Debug = true in config.lua and restart the resource. Every step is printed to the F8 console on the client and to the server console. Turn it off again when you are done.

No presence at all#

• The player must use the Discord desktop app. Discord in a browser cannot show FiveM Rich Presence.
• In Discord, User Settings → Activity Privacy → Share your detected activities must be on.
• Check Config.Discord.AppId. If F8 shows Config.Discord.AppId is not set, paste your Application ID from the Discord application page.
• Restart FiveM after starting Discord, if Discord was opened after the game.

Presence flickers or shows another server name#

Another resource is also setting Discord Rich Presence, and the two keep overwriting each other. On Qbox, this is usually the built-in presence in qbx_core, which is on by default. Follow Turn off other Rich Presence scripts for exact steps for Qbox, QBCore and ESX, and how to find any other presence script.

Logo not showing#

The asset name in config.lua does not exactly match the name in the Developer Portal, or the asset was uploaded less than 15 minutes ago. Asset names are case sensitive.

Buttons not visible#

Discord never shows you your own buttons. Check from a second account. Also make sure each URL starts with https://; other links are skipped.

Character photo never appears#

Check the server console after a restart:

• Mugshots disabled: Fivemanage API key missing: add your token. See Image hosting.
• Mugshots disabled: self-hosting needs ServerConfig.SelfHosted.PublicUrl…: set PublicUrl to your HTTPS domain.
• Mugshot uploads will fail: server/http.js did not load…: a file is missing from the resource folder. Upload the resource again, complete.
• Mugshot upload failed: the host refused the photo. The message includes the host's own reason. Check that your API key is still valid, or that your domain still forwards the photo path.

Also check that Config.Mugshot.Enabled is true, and wait at least five seconds after loading a character.

Self-hosted photos do not load#

The proxy is not forwarding the photo path. Test it:

1. Set Config.Debug = true and restart, then load a character.
2. Copy the Stored mugshot for … link from the server console and open it in a browser.

If the browser shows nothing, fix your reverse proxy or DNS record before checking Discord. See Image hosting. PublicUrl must start with https://; Discord refuses plain http:// links.

Photo shows an old outfit#

Your clothing script's save event is missing from Config.AppearanceEvents. Add it as described in Character photos, or wait for the automatic check. Players can also type /refreshmugshot. Uploads are limited to one every 2 minutes per player, so a very recent upload delays the next one.

rate_limited in the debug output#

This is normal. Each player can upload one photo every 2 minutes, and the resource retries automatically when the cooldown ends.

Framework shows as standalone#

The server console shows Framework: standalone or is not running, using standalone mode. Start wd_richpresence after your framework in server.cfg, or set Config.Framework to your framework.

Name or job is wrong#

• Name shows Unknown or job shows Unemployed: the character has not finished loading, or the resource is in standalone mode.
• To show a different job name, add it to JobLabels. See Presence text.

Restarting the resource#

Restarting wd_richpresence while players are online is safe. Loaded characters are picked up again automatically, and saved photos are reused without uploading.