Player Avatar
By default, the player card shows the first letter of the player’s name in a circle. If you want, you can swap that for each player’s real profile picture, pulled from their Discord or Steam account.
If a picture can’t be found for someone, the card simply falls back to the letter — so it always looks complete.
How it works (in plain terms)
When a player joins, your server quietly looks up their profile picture and remembers the link to it. That link is the only thing sent to the menu. The lookup runs once per session, so it’s light and fast.
To look up the picture, the server needs a key — think of it as a password that lets your server ask Discord or Steam for the image. You’ll create that key below and store it safely on the server.
The one rule that matters: store the key with set, never setr. The setr version is “replicated,” meaning it gets sent to every player’s game — which would leak your key to the public. Plain set keeps it private on the server, where it belongs.
Choose where pictures come from
In shared/config.lua:
Config.Avatar = {
source = 'discord', -- 'discord' | 'steam' | 'none'
}| Value | What happens |
|---|---|
'discord' | Show each player’s Discord profile picture. Needs a Discord key (below). |
'steam' | Show each player’s Steam profile picture. Needs a Steam key (below). |
'none' | Don’t look anything up — always show the letter. |
Now follow the matching setup below for the source you picked.
Discord setup
A Discord “bot” is just an account your server uses to ask Discord for public profile pictures. It does not need to join your Discord server, and it needs no special permissions.
Open the Discord Developer Portal
Go to the Discord Developer Portal and click New Application. Give it any name (for example, your server’s name) and create it.
Create a bot and copy its token
Click the Bot tab on the left, then Reset Token, then Copy. This long string is your token — the key your server uses.
Treat this token like a password. Anyone who has it can act as your bot. If it ever leaks, come back here and click Reset Token to make a new one.
Save the token on your server
Open your server.cfg and add this line above the ensure flux-pausemenu line. Replace the text in quotes with your real token:
set DiscordBotToken:flux-pausemenu "paste-your-token-here"Restart and you’re done
Restart your server. Players who have linked Discord to FiveM will now show their Discord picture.
A player’s Discord picture only shows if they’ve linked Discord to their FiveM account. Anyone who hasn’t linked it (or uses the default Discord avatar) will show the letter instead — that’s normal.
If pictures aren’t showing
| What you’re seeing | Most likely reason |
|---|---|
| Everyone shows the letter | Config.Avatar.source is set to 'none', or the set ... line is missing from server.cfg. |
| Discord pictures never appear | The token is wrong or was reset, or your players haven’t linked Discord to FiveM. |
| Steam pictures never appear | The key is wrong, or your players aren’t connecting through Steam. |
| Your key showed up somewhere public | You used setr instead of set. Reset the key and re‑add it with plain set. |
| A player changed their picture but it didn’t update | The link is remembered for the session. It refreshes the next time they reconnect. |