Game CCU Limit
This topic is specific to the AccelByte Gaming Services (AGS) Shared Cloud tier.
Game CCU Limit
The Game CCU/CAU Limit is a protective mechanism in the shared cloud environment that controls the maximum number of concurrent users per game. This feature ensures platform stability during peak traffic periods by preventing login surges that could degrade performance or disrupt services.
Why do we have Game CCU Limit?
In a shared cloud environment, multiple games run on the same infrastructure. During high-traffic events, such as game launches, promotions, or major updates, sudden spikes in player logins can overwhelm shared resources.
To address this risk, we enforce Game CCU Limits to:
- Prevent platform-wide service degradation by regulating login volumes.
- Ensure fair resource distribution across games.
- Maintain consistent performance and uptime for all customers.
- Enable smooth scaling by managing traffic in an organized manner.
To support this system, Game Login limit becomes a mandatory feature for all games in the shared cloud.
How Do Game CCU Limit Work?
- Per-Game CCU Cap: Each game namespace in the shared cloud is limited to 5,000 CCU by default.
- Enforced Throttling: When the login CCU exceeds the limit during a specific time window, the system will reject new login attempts and temporarily throttle access until the number of concurrent logins drops below the threshold.
- Throttle Behavior: Throttled login attempts receive a 403 HTTP status with a clear error message.
- Login Queue Compatibility:
- You may enable the Login Queue feature. Learn more about login queue
- However, the login queue's max CCU setting must remain below the default game CCU limit (5,000).
- If the login queue is enabled and the queue threshold is reached, players will enter the queue instead of being rejected.
Requesting Limit Changes
To request an increase or removal of your game’s default CCU cap:
-
If you don’t have access to our support ticket system, select one of these contact supports here:
-
If you do have access to our support ticket system, please raise a support ticket or consult your assigned Account Manager. This will help us support your scaling needs and ensure a smooth player experience.
FAQ
Q: What does CCU mean?
A: Concurrent Users (CCU) refers to the number of users who are currently logged in to the platform. More specifically, it represents the number of players with valid access tokens or authenticated IAM sessions at a given time.
This is the definition used in the Login Queue feature, where CCU limits are enforced to manage player traffic and protect system stability.
For more information, refer to our login queue documentation
Q: What happens if I enable Login Queue for my game namespace?
A: You can enable Login Queue, but the maximum CCU setting for the queue must remain below the 5,000 CCU default limit.
If enabled, and your login attempts exceed the queue threshold, players will be placed in a queue instead of receiving an error. This provides a smoother player experience.
Q: How can I know when my game hits the login CCU limit?
A: If your game exceeds the CCU limit and throttling occurs, the login request will fail with the following 403 response:
{
"errorCode": “10244” ,
"errorMessage": "unable to get login queue ticket: , userID: abcdefghaifklmn1234567, details: game max ccu reached"
}
Q: How can I avoid hitting the CCU limit?
To reduce the risk of throttling, we recommend the following:
- Notify AccelByte in advance of any expected traffic spikes (e.g., game launches, load tests, promotions) via Support or your usual communication channel.
- Enable the Login Queue feature to manage login traffic gracefully. Learn more about login queue
- Actively monitor CCU usage through the Login Queue dashboard in Admin Portal and adjust limits as needed.