Glossary of terms
A2S
A2S is a popular UDP-based game server query protocol that Valve Software keeps as a part of the Steam SDK.
access key
An access key is a unique identifier that points to your account. It’s tied to a secret key. Refer to Authentication.
allocate
Allocating is the process of a matchmaker allocating a game server for a game session.
allocated game server
Refer to allocated server.
allocated server
An allocated server is a server that's in use by an allocation. Allocated servers have a populated allocatedID field in their server.json file.
allocated server capacity
Allocated server capacity is the number of allocated game servers within a fleet or fleet region. Multiplay Hosting keeps a buffer between the total server capacity and the allocated server capacity to allow the fleet or fleet region to accommodate sudden spikes in allocated servers.
allocated ID
Refer to allocation ID.
allocation
An allocation is a request for the best possible game server for a game match. Refer to Allocations.
allocation ID
An allocation ID is an identifier that you (or a matchmaker) assign to an allocation upon creation.
allocation spread
Allocation spread is the maximum number of machines that the reactive scaling system spreads allocations across machines in a fleet or fleet region.
allocation timeout
The allocation timeout is a value that determines the amount of time that the reactive scaling system waits before force-deallocating allocated game servers, even if players are on the server. This value serves as a hard limit on the amount of time that an allocation can exist.
available game server
An available game server is a game server that's ready for a matchmaker to use to fulfill an allocation. Refer to Available servers.
available server
An available server is a server that's ready for a matchmaker to use to fulfill an allocation.
available server pool
The available server pool is a group of game servers in a fleet that's online and ready to fulfill an allocation request.
best available server
The best available server is an available game server that best meets the requirements for an allocation request.
buffer
A server buffer is a collection of servers kept in an available state, ready to fulfill an allocation. Refer to Availability buffer.
build
A build has the files necessary to run your game or application on a server. Refer to Builds.
build configuration
A build configuration manages how a build runs by dictating the query protocol, the application executable path, the configuration variables, and the launch parameters. Refer to Build configurations.
build executable
A build executable is the executable file within a build.
build executable path
The build executable path is the file system location of the build executable. It's relative to the structure of the build files you upload.
build ID
A number that identifies a specific build within the current Unity project.
build install
A build install is a job triggered when you roll out a new build release to the servers in your fleet. Refer to Install lifecycle.
build machine
A dedicated machine for deploying and testing configuration changes, game images, and game image updates. Scaling configurations and fleet settings don't apply to build machines because they exist outside of any fleet. You receive your build machine’s hostname, IP address, and machine ID during the proof-of-concept onboarding stage.
build process
A build process is the process running on a server after launching a build executable.
capacity
Capacity refers to the number of game servers within a fleet (game server capacity) or the number of machines within a fleet (machine capacity).
concurrent users
Concurrently connected users (CCU) is the number of players simultaneously connected to a fleet, region, or server at a time.
concurrently connected users
Refer to concurrent users.
configuration variable
A configuration variable is a variable you define on a build configuration. Multiplay Hosting passes these variables to servers using the build configuration. Refer to Configuration variables.
container build
A containerized version of a build that lives on the Multiplay Hosting container registry. Refer to Container builds.
container registry
The Multiplay Hosting container registry is a custom registry for hosting containerized builds.
CPU core count
The CPU core count defines how many CPU cores each server has access to.
CPU frequency
The CPU frequency defines the amount of CPU frequency in megahertz (MHz) each server instance has access to.
credentials
Credentials allow you to authenticate with Multiplay's API. Each account has an access key and a secret key that make up the credentials.
deallocate
Deallocating is the process of removing an allocation.
disabled machine
A disabled machine is a machine that you can't use to fulfill allocations or reservations.
draining
Draining is the process of players leaving a game server after a game session ends.
excess game servers
Refer to excess servers.
excess servers
Excess servers refers to any running game server over the target buffer.
fleet
A fleet is a collection of servers that host a game or application in specific regions. Accounts can have one or more fleets, each with its own regions, builds, build configurations, and settings. Refer to Fleets.
force deallocating
Refer to force-deallocate.
force-deallocate
Force deallocating is the process of deallocating a game server regardless of the state of the game session.
forced rollout
A forced rollout is a less graceful method of deploying a build update where you force servers to update even if there are players connected. If players are connected when you start a forced rollout, Multiplay Hosting kicks the players from the server.
game client
A game client is software that an end-user, or player, interacts with to join a match on a game server.
game map
Game map is a broad term that refers to a playable set of content for a game. The content can be anything from a level to a play area for a game session.
game mode
A game mode is a variation of a game with some configuration altered, such as the number of players allowed per session, the game objective, or the points system.
game session
A game session is a temporary match that players can join to play a game together.
game server
A game server is an instance of a game running on a machine that players can connect to. Each game server instance has a unique server ID, a unique port, a server ID directory, a log file, and a server.json file. Refer to Servers.
game server instance
Refer to game server.
game server query protocol
A game server query protocol is a protocol that facilitates querying information from a game server instance. Multiplay Hosting uses the information supplied by the game server query protocol to detect unresponsive game servers and to create live dashboards of advanced analytic data. Refer to Query protocols.
game server slot
A game server slot is a reserved percentage of machine resources on which a game server can run.
game server usages
Game server usages is the average resource consumption per game server, including CPU power, network bandwidth, and memory. Refer to Server density.
game session,game match
A session of multiple players connected to the same game server to play a game together.
game title
A game title is the name of a specific game.
game version
A specific release version of an image of a game server binary.
hardware specifications
Refer to machine specifications.
launch parameter
A launch parameter is a variable sent to a build process as a startup flag when launching the executable on a server. Refer to Launch parameters.
local mirror
Refer to local mirror machine.
local mirror machine
A machine in Multiplay's mirror network that hosts game images for the fleet machines in the same location.
location
Refer to region.
locked game server
A game server that's disabled for maintenance. You can't use a locked game server to fulfill an allocation or reservation. Refer to Server statuses.
machine
A machine is a physical or virtual computer with a set amount of compute resources that runs servers.
machine capacity
Server density is the number of servers a single machine can fit. The usage settings of the current build configuration determines this number.
machine specifications
Machine specifications include a set of hardware requirements for fleet machines. The requirements might include a minimum processor clock speed, a minimum amount of RAM, and processor configuration options. The machine specifications might vary between bare-metal and cloud machines.
machine state
The state of a machine. A machine can be offline, online and allocated (or reserved), online and available, or online and disabled.
matchmaker
A multiplayer networking feature in games that groups players into a game session.
matchmaking
The process of grouping players together into a game session.
maximum servers
The maximum servers scaling setting controls the maximum number of servers that can run in a region at a time.
memory
The memory defines the amount of RAM (random access memory) in megabytes (MB) each server has access to.
minimum available servers
The minimum available servers scaling setting controls the minimum number of servers that are available in a region at a time. Refer to Scaling settings.
minimum servers
The absolute minimum number of game servers that the reactive scaling system keeps in a fleet or fleet region at any time. Refer to Scaling settings.
minimum standby servers
The number of game servers within a fleet or fleet region that are offline. Standby game servers serve as a form of warm capacity that Multiplay Hosting can use to host game servers in case of a sharp influx in currently connected users (CCU).
next available server
A game server from the available server pool that best fits the allocation requirements.
offline game server
A game server that Multiplay Hosting has shut down in response to a decrease in the number of total concurrently connected players.
offline server
Refer to offline game server.
online game server
An online game server is a game server that's running and accessible to players on a remote game client.
online server
Refer to online game server.
player
An individual connected to a game client that has the intention to connect to a game server to join a game session.
player density
Player density is the number of players within a region at a given time.
players per session
Players per session is the maximum number of players that can join a game session.
playtest
The process of running a game session on a game server to test a game build, gather feedback from users participating in the playtest, or collect data about the resources the game server uses while hosting a game session. Multiplay Hosting uses playtests to calculate game server resource usages to find the optimal server density for the game build.
progressive rollout
A progressive rollout is a graceful method of deploying a build update where you update servers only when they're empty. If there are any players connected to a server, Multiplay Hosting waits for your matchmaker to deallocate the server.
proxy payload
The proxy payload is a locally available proxy on game server machines at port 8086 that you can use to retrieve payloads uploaded with the Allocate V2 endpoint
QoS
An acronym for quality of service. In the context of Multiplay, it describes the network connection quality between a game server and a game client.
QoS machine
A machine in a specific location that game clients use to retrieve quality of service information. The game client then uses the quality of service information—along with the quality of service information from other QoS servers—to find the best location to join a game session.
QoS service
The QoS service allows game clients to gather quality of service (QoS) data to supply to a matchmaker.
QStat
QStat is an open-source command-line tool that interacts with game server query protocols to gather statistics about game servers.
query protocol
A query protocol is a protocol that facilitates querying information from a game server instance. All builds must support a query protocol.
reactive scaling system
The reactive scaling system is a system that allows fleets to respond dynamically to player demand by scaling the number of game servers in a region.
region
A region is a geographic locations in which a fleet can host servers. Each fleet can have access to one or more regions and each region within a fleet has independent scaling settings. Refer to Regions.
release
A release is a version of your build that’s ready to release to servers to run your game.
rollout
The process of "rolling out" an updated build to all the server in a fleet or fleet region.
rollout mode
A rollout mode is a mode where you deploy a build update. There are two rollout modes: progressive and forced.
scaling
Scaling is the process of adjusting the number of servers in a region in response to demand. Refer to Scaling.
scaling down
Scaling down is the process of shutting down and eventually deleting server capacity in response to decreases in allocated servers. Refer to Scaling.
scaling settings
Scaling settings allow you to manage how your fleet scales per region. There are two scaling settings available per region: the minimum available servers and the maximum servers. Refer to Scaling settings.
scaling up
Scaling up is the process of creating more server capacity within a fleet or a fleet region in response to increases in allocated servers. Refer to Scaling.
secret key
A secret key is akin to a password and is only visible when you first generate your credentials. You use the secret key along with the corresponding access key to authenticate with the Multiplay Hosting API. Refer to Authentication.
server
A server, also known as a game server, is an instance of a build executable running on a machine within a fleet. Refer to Servers
server action
A server action is an action (such as start, stop, allocate, and unallocate) performed on a server. Multiplay Hosting can perform these actions automatically or you can perform them manually.
server buffer
Refer to buffer.
server density
Refer to machine capacity.
server event
A server event is an event that occurred on a server, such as a server action, failure, or build update. Refer to Server analytics.
server failure
A server failure happens when a server crashes, fails to start, or becomes unreachable. Refer to Server analytics.
server ID directory
Each server instance has a directory on the host machine that has data specific to the server instance. The directory name matches the server's ID.
server log
A server log is an application-level log produced by a build executable. Refer to Server files.
server file
A server file is an application-level file produced by a build executable. Refer to Server files.
server query protocol
Refer to SQP.
server usage
Server usage is the analytic information about the compute resources a server uses.
server.json
The server.json file has variable data, such as the current allocation ID, for each server instance. It’s automatically generated and populated for each server. Refer to Server.json file.
shutdown TTL
The shutdown TTL determines the amount of time that the reactive scaling system waits before shutting down a cloud machine with no allocated game server instances. Refer to Scaling settings.
SQP
SQP is a query protocol that allows you to retrieve information about a running game server.
standby game server
A game server that exists on a machine that's in a shutdown state. The reactive scaler doesn't include such game servers in the available server pool.
startup parameter
Refer to launch parameter.
target buffer
The number of game servers that a fleet or fleet region should have online and available for new players to join at any time.
total server capacity
The total number of game servers within a fleet or a fleet region.
transient state
A transient state is any machine state that's transitionary, such as when a machine is booting up or shutting down.
unallocated game server
A game server that's available to fulfill an allocation request.
unallocated server
An unallocated server is a server that's not in use by an active allocation. The allocatedID field in its server.json file should be an empty string.
unresponsive game server
A game server that has repeatedly failed to respond to the implemented game server query protocol.