How do I change the maximum number of players on my FiveM server?
In this article
The number of slots on your FiveM server decides how many players can join at the same time. It lives in server.cfg as sv_maxclients and is quick to change through the panel. There is an upper limit, though, set not by us but by Cfx.re (the makers of FiveM) and tied to your licence key.
Changing the slots in the panel
- Log in to the panel and click your server.
- Click Settings.
- Change the number of slots and save.
- Restart the server.
Prefer the file directly: open server.cfg through Files and change the line sv_maxclients 32. The panel and the file should hold the same value; the panel writes the value into the config at start-up.
The Cfx.re upper limits
How many slots you may set depends on your Cfx.re account and the Element Club subscription attached to your licence key:
- Without a subscription: up to 48 slots.
- Element Club Argentum: up to 64 slots.
- Element Club Aurum: up to 128 slots.
- Element Club Platinum: up to 2048 slots.
If you set sv_maxclients higher than your subscription allows, the server does not start or the value is reset at start-up, with a message in the console. The subscription is managed at portal.cfx.re under your licence key; see also changing your FiveM licence key.
OneSync
Above 32 players OneSync is mandatory (and above 64 OneSync Infinity), otherwise the server does not accept more players. How to enable it is in enabling OneSync Infinity. Without OneSync the server stays at 32, even if you configured more slots.
How many players can my package handle?
Slots are free, players are not: every player takes CPU and memory, and above all the framework and the scripts decide how much. A rule of thumb for an ESX or QBCore server with a normal number of scripts:
- 4 GB: up to about 32 players.
- 8 GB: 32 to 64 players.
- 12 to 16 GB: 64 to 128 players, provided the scripts are optimised.
If the server starts stuttering when busy (the message server thread hitch warning in the console), you are at the limit of your scripts or your package; what to do then is in fixing FiveM server lag. Scaling up is done per gigabyte with us, without moving the server.
A queue for a full server
If you keep the slots deliberately low (for roleplay quality, say), you want a queue instead of a blunt Server is full. Resources such as hardcap (present by default) and a queue script handle that, often with priority for certain Discord roles. A queue does not change the Cfx.re upper limit.
Common questions
- I set 64 but only 32 people can join. OneSync is off. Enable it and restart.
- The value jumps back to 48. Your licence key has no Element Club subscription that allows more.
- The server list shows a different number. The list refreshes with a delay; wait a few minutes after the restart.
Stuck? Open a ticket and mention which subscription is attached to your key.
Launch your server in 60 seconds on our own hardware.