Last updated on 8/4/2023, 2:35:02 PM
This section describes terms used when developing for AccelByte Gaming Services (AGS). The terms definition can be unique to AGS. Cloud gaming terminology is included.
- AccelByte Gaming Services (AGS) is our cloud-based back-end services product. AccelByte Cloud is the legacy name for this product.
- This allows players to log in and play a game with no input required. As no user input is needed at all, it's the most developer friendly method to get an AccelByte account, and authenticate a user token for testing or debugging purposes. It should not be used in a published game.
- An AccelByte service that manages Dedicated Servers, which can be used by a game to host multiplayer matches. Armada can manage servers from a variety of sources, and can intelligently adjust the number of dedicated servers hosted on the cloud, or bare metal providers, to ensure fast responses for players while minimizing hosting costs. Armada consists of several components, including the Dedicated Server Artifact Manager, Dedicated Server Log Manager, Dedicated Server Upload Service, Quality of Service Manager, Quality of Service server, and Server Orchestrator.
- Synonymous with Dedicated Server Configuration
- A mode of play where different Parties in a Game Session using Role-Based Matchmaking can be composed of different roles, or even a different number of players. This is contrasted with Symmetric Parties.
- Used with Armada, this is the strategy which the Server Orchestrator uses to acquire or return virtual machine instances to their provider. For a full description of each, refer to the Introduction to Armada.
- The process of adding more players to an already existing match. The game session can submit a ticket to the Matchmaking service to receive proposals for new players which can then be accepted or rejected. Game sessions can be configured to auto-backfill through the Session Template, or it can be left up to the game server to manage directly.
- Enables you to restrict access to your game. An account ban will prevent a player from accessing your game. A feature ban will restrict access to specific in-game features. A device ban will restrict access to your game from a specific device - identified by a unique device ID (preventing banned players from reentering your game with a new account). Bans can be lifted.
- Blueprints are a Microsoft Azure technology that enables a cloud architect to define a reusable set of Azure resources. This reusable set may consist of an organizations standard processes. Thus Blueprints enable development teams to get started quickly on a project, knowing it is in compliance with the necessary requirements.
Cancel Match on Disconnect
- A feature of the Lobby service which cancels a Matchmaking request if the player who made the request is disconnected from the lobby. This can be enabled or disabled in the Lobby Configuration in the Admin Portal.
- An AccelByte service that allows players to communicate with each other in a game. AccelByte supports private chats between players, group chat between parties, and players playing together in multiplayer games, and also universal chats for all players connected to the Lobby.
- A group of bare metal or cloud servers within the same virtual private network (VPN), meaning they are under the same IP address. For Armada, clusters are differentiated by Region, which means for example that us-west is in a different cluster from us-east.
- The ability of players on different platforms (e.g., PC or console) to play together in multiplayer play. AccelByte supports cross-platform play.
- The ability of a player to access saved data across multiple devices and platforms. AccelByte supports cross-platform progression.
- An acronym for Daily Active Users, the number of unique users of a game over the period of a day. This is one of the fields available through the Analytics service.
- Abbreviated as DS. A computer software program that hosts a game. Game clients connect to the DS during Game Sessions and have the DS run all of the game logic. In Armada, a DS is containerized and deployed as a Docker container into a Region based Cluster. A running DS container is sometimes referred to as a Pod.
Dedicated Server Artifact
- Any data files produced by a Dedicated Server. These can be accessed in the Admin Portal for debugging purposes.
Dedicated Server Artifact Manager
- Abbreviated as DSAM. An AccelByte service that stores Dedicated Server Artifacts.
Dedicated Server Configuration
- Abbreviated as DS configuration. A collection of settings where game developers specify how the game's Dedicated Servers will be deployed. The DS configuration consists of an Image, a Pod Configuration, and the Deployment.
Dedicated Server Container
Dedicated Server Log Manager
- Abbreviated as DSLM. An AccelByte service that stores Dedicated Server Logs into files that can be downloaded from the Admin Portal.
Dedicated Server Logs
- Abbreviated as DS logs. Logs generated by a running Dedicated Server which are written into
stdoutor stderr. These logs are collected by the Dedicated Server Log Manager and saved in a file, which can be downloaded from the Admin Portal. If there's a problem with a dedicated server, the data present in the DS logs can help with troubleshooting.
Dedicated Server Manager
- Abbreviated as DSM. One of Armada's components that acts as the brain of Armada. This service stores Deployments that are defined from the Admin Portal and communicates with the Server Orchestrator to deploy Dedicated Servers to be used in Matchmaking.
Dedicated Server Manager Controller
- Abbreviated as DSMC. Synonymous with Dedicated Server Manager.
Dedicated Server States
- States keep track of the life cycle of a dedicated server. The state can be one of: Creating, Ready, Busy, Unresponsive, or Removing.
Dedicated Server Upload Service
- Abbreviated as DSUS. An AccelByte service that manages the Dedicated Server upload process.
Dedicated Server Uploader
- Abbreviated as DS uploader. A CLI tool for game developers to upload a Dedicated Server to Armada. Upon upload, Armada's services will containerize the server and store it in a Docker image repository.
- Settings that tell Armada which Image to run in a specific Region, using which Pod Configuration. You can also define how many Dedicated Servers should be run by default to anticipate incoming players.
- Acronym for downloadable content, additional digital content (free or paid for) that a player can download and install to add to or replace content in a video game. The content can be distributed online within the game, or via a gaming platform, such as Steam or the PlayStation Store.
- Docker is an open source platform for developing applications in containers. Armada uses these containers to ensure that Dedicated Server performance is the same across different devices and environments. Refer to: Docker website
- An Elo score is a way of calculating relative skill levels of players in zero-sum games, who may well not have ever played each other. The best known zero sum game is Chess, though it is used in martial arts, and other sports. The difference between the ratings of two players is a method of predicting the outcome.
Enable or Disable Lobby
- A feature which allows game developers to turn access to the Lobby service on or off. If lobby access is turned off, players will not be able to connect to your game. This allows you to prevent players from accessing the game during maintenance. The lobby can be enabled or disabled in the Lobby Configuration in the Admin Portal.
- A collection of Dedicated Servers, active or idle, to serve game sessions. Fleets are usually maintained separately in each Regional Cluster.
- A setting for Role-Based Matchmaking that removes the role requirements for a certain number of players if the existing role requirements result in no match being found.
- Settings that are used when the default Matchmaking Attributes result in a player not finding a suitable match. Flexing rules allow for a broader selection of players to be matched together, making it more likely that players will find a match.
- An AccelByte service that allows players to connect socially with other players. When players are friends, they can see each other's Presence, Chat with each other, and invite each other to play together in multiplayer.
- A group of settings that determines how a match is conducted, including how many players and teams can play together in a single match and whether or not Role-Based Matchmaking should be used. You can create multiple variations of a game mode with the use of Sub-Game Modes.
- Synonymous with Dedicated Server.
- An active play session where a game client is connected to a Dedicated Server, or where a game client connects to another game client for Peer-to-Peer Matchmaking. This enables multiple players to play together in competitive or cooperative play. With Armada, a game session is created when a player initiates Matchmaking.
- An accumulated set of values from all contributing User Statistics. You can choose to configure a statistic as a global statistic, to track game wide contributions from your game users.
- An AccelByte service that enables multiple players to form a community together. Groups work similarly to clans in many MMORPGs. Groups can play together in multiplayer, and take on other groups in competitive play. Certain players can be designated as group admins, who have the ability to manage group membership.
- Stands for general-purpose Remote Procedure Call, an open source high performance framework, originally developed by Google. The framework can run in any environment, and can efficiently connect services in and across data centers with support for load balancing, tracing, health checking and authentication. Refer to gRPC.io.
- An account that can be created when a user first signs in by using an external identity provider or custom device ID. Lack of a valid email address and other necessary information is the difference between a full account and a headless account.
- Defined as an application, such as a game server or website, that requests access to protected platform data and resources. Identity and Access Management (IAM) clients allow you to control which resources can be accessed by an application, as opposed to by a specific user. IAM clients can be defined under any Namespace (either Publisher or Game namespaces).
- A technology that stores and verifies user identity. They are typically cloud-hosted services, and they often work with single sign-on (SSO) providers to authenticate users. Azure Active Directory, Google Workspace, and OpenID Connect are examples of identity providers.
- Also known as a server image. An uploaded Dedicated Server that is already containerized (see Docker) and stored in a repository. Armada uses the image version to uniquely identify which dedicated server to deploy.
- See Session Joinability.
Keep Player's Activity
- A configuration option for the Lobby service. If this option is enabled, a player's Presence data in the Lobby service will not be reset when the player disconnects. This option can be enabled or disabled in the Lobby Configuration in the Admin Portal.
- Provides a way to create a sense of competition among players, which can motivate them to play harder, more often, and to improve their performance and try to move up the ranking. It can be configured with specific start and end dates.
- Instead of using a machine generated code, a leaderboard code is a unique string, used to identify the leaderboard. This is so developers can easily track it, and use the string in their code. The code could be as simple as "victory".
- An AccelByte service that provides the main hub of your game for players to connect to. The game client connects to the Lobby service, and through the lobby the game client can access the Presence, Friends, Notification, Party, Chat, and Matchmaking services.
- A collection of settings for the Lobby service that can be configured in the Admin Portal. These settings include the Keep Player's Activity and Cancel Match on Disconnect settings, the length of the Ready Consent Timeout, the number of players that can connect to the lobby at once, and the Max Server Waiting Time.
Lobby Concurrent User
- A metric that shows the total number of active players. This value is refreshed once every minute.
- A service that allows you to review the traffic logs from AccelByte services. Every user, player, or application's interaction with the endpoints in our platform is collected and stored in logs by the Log Viewer service, and those logs can be accessed in the Admin Portal.
- The player data that determines which players will be matched together based on the Matchmaking Rules. Match attributes are typically player statistics, such as number of kills or number of matches won, that are used to judge a player's performance.
- Defines the behavior that the Service will use to evaluate tickets waiting in the queue. By default, it will use the logic defined in match rulesets, but through use of a gRPC plugin, new functions can be implemented that extend how the service works.
- Sometimes referred to as a queue, a match pool defines a segment of players and parties, represented as tickets, based on selected preferences such as game mode, region, language, etc. Once in a pool, tickets will be evaluated in turn, and based on the match ruleset defined for the game mode, paired together and connected to a Game Session.
- An AccelByte service that allows players to be paired with other players for multiplayer play.
- Abbreviated as MMR. A score granted to players based on their performance in your game. The specific statistics used to judge player performance are defined as Match Attributes.
- Also known as Matchmaking Ruleset. Settings that determine how players are matched together. You can choose to match players of similar or different skill levels together. You can also set up Flexing Rules or Role-Based Matchmaking.
- A line of Matchmaking Tickets waiting to be matched. Matchmaking tickets that are earlier in the queue are prioritized over those later in the queue.
- An acronym for Monthly Active Users, the number of unique users of a game over the period of a month. This is one of the fields available through the Analytics service.
Max Server Waiting Time
- The amount of time your game will wait for a Dedicated Server to be spun up for a match. If this time limit is exceeded, the Lobby will respond that no server is available.
- Matchmaking Rating, a number used to represent a game players skill level. This rating can be used to match a player with others with a similar rating.
- A unique name for a game studio (a Publisher namespace), or an individual game (a Game namespace). Namespaces are required so that various attributes and features can be linked to them. One Publisher namespace may be linked to many Game namespaces. IAM Clients can be defined under either type of namespace.
- A Server Orchestrator, build by HashiCorp, that deploys and manages containers and non-containerized applications across on-prem and clouds at scale.
- An AccelByte service that delivers text-based messages to players.
- The AGS Online Sub-system (OSS) is the high-level bridge between Unreal Engine and AccelByte services. It comprises interfaces that access AccelByte services and its features. OSS is designed to handle higher level logic, with asynchronous communication.
- A group of players who are Friends playing together in multiplayer play. There can be one or multiple parties in a Team. Party size can be configured in the Admin Portal. Players can join a party either by invitation or by using a Party Code, both of which can be sent to players by the Party Leader.
- A string of characters that can be used to add players to a Party. A party code can be generated by the Party Leader, who can then send the code to other players.
- The player who creates a Party by starting a Game Session for multiplayer play. The party leader can invite other players to join the party. If the party leader leaves the party, the player that has been in the party the longest will be promoted to party leader.
- An item that grants players access to a certain class of rewards available during a season event. Passes can be freely granted to players, or can be made available for purchase. Passes are represented by items you create, but they do not have to be actual in-game items granted to players.
- Abbreviated as P2P Matchmaking. A type of Matchmaking that does not use Dedicated Servers. In P2P matchmaking one player acts as the host for the Game Session, and other players connect to the host's machine to play together.
- Used to grant access to specific resources within AGS services. Most AccelByte service endpoints require permission to be accessed, whether it be from users or applications. Resources are what permissions are applied to, they are what permissions protect. Each protected endpoint requires a unique permission string. Roles are a collection of permissions.
- Settings that will affect running Dedicated Server Docker containers, such as CPU and Memory allocation, and which port the game server listens to.
- An AccelByte service that records whether players are connected to your game or not. Presence can be displayed to other players, so that for example players can see when their friends are online.
Quality of Service
- Abbreviated as QOS. A set of services that are deployed in each of the Regions where Armada can spawn Dedicated Servers. Using the SDK, game clients can call the QOS in each region to measure network latency and determine the nearest region to ensure that Matchmaking pairs players that are near each other.
Quality of Service Manager
- Abbreviated as QOSM. An AccelByte service that keeps track of all available Regions by keeping a list of all live Quality of Service servers.
Ready Consent Timeout
- The amount of time, in seconds, that a player has to confirm that they are ready for multiplayer play before they are removed from a match. This can be configured in the Lobby Configuration in the Admin Portal.
- A geographical location where a Dedicated Server is deployed to be used by players. Regions can cover one country, multiple countries, or one part of a large country. By default, AccelByte follows the available regions in AWS, but game developers can request special regions if needed. See Regions and Availability Zones.
- A regional cluster is a server Cluster located in a Region that is responsible for running your Dedicated Servers.
- An entitlement that is granted to a player when they finish a Tier. For example, if a player moves from Tier 1 to Tier 2, they will be granted the rewards from Tier 1. Rewards can be items, XP, or any other entitlement.
- A definition of the type of User accessing a game. Options include a player, a viewer-only, an admin, and a super-admin. Roles include a collection of Permissions.
- A feature that allows you to match players together for multiplayer play based on their role, or class, in your game. For example, you can specify that a multiplayer team must have a certain number of fighters, mages, and so on. Role-based matchmaking can be enabled when you configure the Game Mode.
- A limited time event that includes special challenges and rewards for players.
- Synonymous with Image.
- An application that manages the deployment and lifecycle of Dedicated Server Containers in bare metal or cloud server nodes. It is responsible to scale out and scale in virtual machines to make sure there is always hardware to fulfill current demands. Nomad is used as the primary orchestrator for Armada. Refer also to Autoscaling Strategy.
- An AccelByte service which stores data for each active Game Session in your game.
- Synonymous with Game Session.
- Determines who can join a session. One of: Open, Invite Only, or Closed.
- A way to define session properties as a template. The template can be created using either the Admin API, or using the Admin Portal. Template properties include a friendly name, Session Joinability, timeouts, Chat properties, Dedicated Server properties, and similar data.
Single Point of Presence
- Single Point of Presence (SPOP) is a concept where the AGS backend only lets a player be logged in on one device/platform at a time. To achieve this, the Lobby enforces only one active connection from the same user account.
- Abbreviation of Single Point of Presence. It's enforcement to ensure a user is actively logged in only on one device to ensure data consistency.
- A variation on an existing Game Mode. For example, you can have a game mode for 4v4 play with a sub-game mode containing slightly different rules, such as different role configurations for Role-Based Matchmaking.
- A mode of play where different Parties in a Game Session using Role-Based Matchmaking must contain the same roles and the same number of players. This is contrasted with Asymmetric Parties.
- A group of players in multiplayer play who share the same objective.
- A level that players occupy during participation in a season event. Players can move up into new tiers by gaining XP or by purchasing access to higher tiers. Players will be granted a reward each time they clear a tier. Tiers are represented by items you create, but they do not have to be actual in-game items granted to players.
- Timeouts are time limits that are applied to your dedicated servers during some of the states in their life cycles. All these time outs are configurable on the Admin Portal. In Armada, for example, there are creation timeouts, claim timeouts, session timeouts, and unresponsive timeouts. For a full description of each, refer to the Introduction to Armada.
- A TURN server allows different devices to communicate with each other using the WebRTC protocol. TURN servers are used to relay traffic if peer to peer communication fails.
- Synonymous with player, a user normally signs into the backend through a game. The User Role is automatically applied to user accounts when they are created, for the purpose of giving players the permissions they need to access resources within your game.
User Generated Content
- Often abbreviated to UGC, it is a service that manages in-game content that has been created by your players. With UGC, players can contribute to the community as a creator by creating game items that can be downloaded by other players.
- The range of game data stored per user, such as number of wins, or games played. User statistics can be updated from both the game client or game server. User statistics are used to contribute to Global Statistics.
- Refer to Log Viewer.
- Containers that hold virtual currency, referred to here as Coins, for your players. Players can purchase virtual currency using any real currency your payment aggregator supports, and you can have multiple virtual currencies in your game. Each wallet can hold only one currency, so if your game contains multiple virtual currencies, players will have multiple wallets.
- WebRTC is an open protocol standard to facilitate real-time communication between applications over the internet. WebRTC employs multiple protocols and techniques - such as Interactive Connectivity Establishment (ICE) to get two computers to communicate with each other, and to deal with network address translators (NATs), firewalls, and other network barriers.
- Short for experience points in a game.